# Accessing Data in Pipelines（訪問管道中的數據） 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.3/accessing-data-in-pipelines.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/accessing-data-in-pipelines.html) 譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=9406187](http://www.apache.wiki/pages/viewpage.action?pageId=9406187) 貢獻者 : [那伊抹微笑](/display/~wangyangting)，[ApacheCN](/display/~apachecn)，[Apache中文網](/display/~apachechina) 該 **pipeline**（管道）中的 **processor**（處理器）對通過 **pipeline**（管道）的 **document**（文檔）進行讀寫訪問操作。該 **processor**（處理器）可以訪問 **source** **of** **document**（源文檔）中的 **fields**（字段）以及 **document**（文檔）的 **metadata** **field**（元數據字段）。 ### Accessing Fields in the Source（訪問源文檔中的字段） 訪問 **source**（源文檔）中的 **field** 是很簡單的。您可以簡單的通過它們的 **name**（名字）來引用 **fields**（字段）。例如 :? ``` { "set": { "field": "my_field" "value": 582.1 } } ``` 除此之外，**source**（源文檔）中的 **field**（字段）始終可以通過 **_source** 前綴來訪問 :? ``` { "set": { "field": "_source.my_field" "value": 582.1 } } ``` ### Accessing Metadata Fields（訪問元數據字段） 您可以使用您在 **source**（源文檔）中訪問 **field**（字段）一樣的方式來訪問 **metadata** **fields**（元數據字段）。這是可以做到的，因為 **Elasticsearch** 不會允許 **source**（源文檔）中的 **fields**（字段） 與 **metadata** **fields**（元數據字段）擁有一樣的 **name**（名字）。 以下示例將 **document**（文檔）的 **_id****metadata****field**（元數據字段）設置為 **1** :? ``` { "set": { "field": "_id" "value": "1" } } ``` 以下 **metadata** **fields**（元數據字段）可以通過 **processor**（處理器）來訪問 :?**_index**，**_type**，**_id**，**_routing**，**_parent**。 ### Accessing Ingest Metadata Fields（訪問 Ingest 的元數據字段） 除了 **metadata** **fileds**（元數據字段）和 **source** **fields**（源文檔字段）之外，**ingest** 也可以添加 **ingest** **metadata** 到它處理的 **documents**（文檔）中去。這些 metadata properties（元數據屬性）可以在 **_ingest** **key** 下進行訪問。目前，**ingest** 會在 **ingest** **metadata** 的?**_ingest.timestamp key** 下添加 **ingest** **timestamp** 屬性。該 **ingest** **timestamp** 是在 **Elasticsearch** 接收 **index**（索引）或 **bulk** **request** 來預處理 **document**（文檔）的 **time**（時間）。 任何 **processor**（處理器）都可以在?**document**（文檔）處理期間添加與?**ingest** 相關的 **metadata**（元數據）。**Ingest** **metadata** 是 **transient**（瞬時的），并且在 **pipeline**（管道）處理 **document**（文檔）后丟失。因此，**ingest** **metadata** 將不會被索引。 以下示例添加了一個名為?**received** 的 **field**（字段），它的值是 **ingest** 的 **timestamp** :? ``` { "set": { "field": "received" "value": "{{_ingest.timestamp}}" } } ``` 與 **Elasticsearch** **metadata** **fields** 不一樣的是，這個名為 **_ingest** 的 **metadata** **fields** 可以作為 **source** **of** **document**（源文檔）中的有效名稱。使用 **_source._ingest** 來引用 **source** **document**（源文檔）中的 **field**（字段）。否則，**_ingest** 將會被作為一個?**ingest** **metadata** **field** 來解釋。 ### Accessing Fields and Metafields in Templates（訪問模版中的字段和元數據字段） 一些 **processor**（處理器）的設置也支持模板化。所支持模版的設置可以有零到多個?**template** **snippets**（模版片段）。一個?**template** **snippets**（模版片段）以?**{{** 開始并以 **}}** 結束。在模板中訪問 **field**（字段）和 **metadata**（元數據）與通過普通的 **processor**（處理器）**field**（字段）設置完全相同。 以下示例添加了一個名為 **field_c** 的 **field**（字段）。它的值為 **field_a** 和 **field_b** 的值的?**concatenation**（串聯）。 ``` { "set": { "field": "field_c" "value": "{{field_a}} {{field_b}}" } } ``` 以下示例使用 **source**（源文檔）中?**geoip.country_iso_code** 字段的值來設置 **document** 將要被索引到的 **index**（索引）。 ``` { "set": { "field": "_index" "value": "{{geoip.country_iso_code}}" } } ```