将一个带有 dot(点)的 field(字段)扩展到一个 obejct field(对象字段)中。该 processor(处理器)可以让名称中带有点的 field(字段)能被其 pipeline(管道)中的其它处理器访问。否则,这些 <<accessing-data-in-pipelines,fields> 不能被任何 processor(处理器)访问。
Table 34. Dot Expand Options(表 34. 点扩展选项)
Name(名称) | Required(必要的) | Default(默认值) | Description(描述) |
---|---|---|---|
| yes | - | 要扩展到 object field(对象字段)中的 field(字段) |
| no | - | 包含要扩展的字段的字段。只有当扩展的字段是另一个对象字段时才需要,因为该 |
{ "dot_expander": { "field": "foo.bar" } }
例如,点扩展处理器将会转换此文档 :
{ "foo.bar" : "value" }
成为 :
{ "foo" : { "bar" : "value" } }
如果已经有一个 bar 字段内嵌在 foo 下,那么该 processor(处理器)将会合并 foo.bar 字段到它里面去。如果该字段是一个 scalar value(标量值),那么它将会将该字段转换为一个 array(数组)字段。
例如,以下文档 :
{ "foo.bar" : "value2", "foo" : { "bar" : "value1" } }
由 dot_expander 处理器转换成 :
如果 leaf field(叶子字段)外的字段与预先存在的字段的 name(名称)一样,那么该 field(字段)需要先 rename(重命名)。
考虑以下 document(文档):
{ "foo": "value1", "foo.bar": "value2" }
在使用 dot_expander 处理器之前需要重命名 foo 字段。所以为了使该 foo.bar 字段正确的扩展到 foo 字段下的 bar 字段,则应该使用以下的 pipeline(管道):
{ "processors" : [ { "rename" : { "field" : "foo", "target_field" : "foo.bar"" } }, { "dot_expander": { "field": "foo.bar" } } ] }
这样做的原因是因为该 Ingest 不知道如何自动的将 scalar field(标量字段)转换为 object field(对象字段)。