Dot Expander Processor（点扩展器处理器）

将一个带有 dot（点）的 field（字段）扩展到一个 obejct field（对象字段）中。该 processor（处理器）可以让名称中带有点的 field（字段）能被其 pipeline（管道）中的其它处理器访问。否则，这些 <<accessing-data-in-pipelines,fields> 不能被任何 processor（处理器）访问。

Table 34. Dot Expand Options（表 34. 点扩展选项）

Name（名称）	Required（必要的）	Default（默认值）	Description（描述）
field	yes	-	要扩展到 object field（对象字段）中的 field（字段）
path	no	-	包含要扩展的字段的字段。只有当扩展的字段是另一个对象字段时才需要，因为该 field 选项只能为 leaf fields（叶子字段）。

{
  "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（对象字段）。