# Dot Expander Processor（點擴展器處理器） 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.3/dot-expand-processor.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/dot-expand-processor.html) 譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=10028281](http://www.apache.wiki/pages/viewpage.action?pageId=10028281) 貢獻者 : [那伊抹微笑](/display/~wangyangting)，[ApacheCN](/display/~apachecn)，[Apache中文網](/display/~apachechina) 將一個帶有 **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**（對象字段）。