### Simulate Pipeline API simulate pipeline API通過在請求體中指定多個文檔來模擬執行一個pipeline操作. 你也能夠通過在請求體中指定多個文檔并指定一個存在的pipeline來執行該操作. 以下是請求體中提供的pipeline definition(管道定義)和simulate request(模擬請求)的結構 ~~~ POST _ingest/pipeline/_simulate { "pipeline" : { // pipeline definition here }, "docs" : [ { "_source": {/** first document **/} }, { "_source": {/** second document **/} }, // ... ] } ~~~ 以下是針對已存在 pipeline(管道)的simulate request(模擬請求)的結構 : ~~~ POST _ingest/pipeline/my-pipeline-id/_simulate { "docs" : [ { "_source": {/** first document **/} }, { "_source": {/** second document **/} }, // ... ] } ~~~ 以下是在請求中pipeline definition(管道定義)的simulate request(模擬請求)及其response(響應)的示例 : ~~~ POST _ingest/pipeline/_simulate { "pipeline" : { "description": "_description", "processors": [ { "set" : { "field" : "field2", "value" : "_value" } } ] }, "docs": [ { "_index": "index", "_type": "type", "_id": "id", "_source": { "foo": "bar" } }, { "_index": "index", "_type": "type", "_id": "id", "_source": { "foo": "rab" } } ] } ~~~ 響應結果: ~~~ { "docs": [ { "doc": { "_id": "id", "_index": "index", "_type": "type", "_source": { "field2": "_value", "foo": "bar" }, "_ingest": { "timestamp": "2017-05-04T22:30:03.187Z" } } }, { "doc": { "_id": "id", "_index": "index", "_type": "type", "_source": { "field2": "_value", "foo": "rab" }, "_ingest": { "timestamp": "2017-05-04T22:30:03.188Z" } } } ] } ~~~ ### Viewing Verbose Results 您可以使用simulate pipeline API(模擬管道 API)來了解每個processor是如何來處理ingest document經過pipeline時的細節的。要在simulate request(模擬請求)中查看每個processor的中間結果,可以將該參數verbose添加到請求中。 以下是一個verboserequest(詳細請求)及其response(響應)的示例 : ~~~ POST _ingest/pipeline/_simulate?verbose { "pipeline" : { "description": "_description", "processors": [ { "set" : { "field" : "field2", "value" : "_value2" } }, { "set" : { "field" : "field3", "value" : "_value3" } } ] }, "docs": [ { "_index": "index", "_type": "type", "_id": "id", "_source": { "foo": "bar" } }, { "_index": "index", "_type": "type", "_id": "id", "_source": { "foo": "rab" } } ] } ~~~ 響應結果: ~~~ { "docs": [ { "processor_results": [ { "doc": { "_id": "id", "_index": "index", "_type": "type", "_source": { "field2": "_value2", "foo": "bar" }, "_ingest": { "timestamp": "2017-05-04T22:46:09.674Z" } } }, { "doc": { "_id": "id", "_index": "index", "_type": "type", "_source": { "field3": "_value3", "field2": "_value2", "foo": "bar" }, "_ingest": { "timestamp": "2017-05-04T22:46:09.675Z" } } } ] }, { "processor_results": [ { "doc": { "_id": "id", "_index": "index", "_type": "type", "_source": { "field2": "_value2", "foo": "rab" }, "_ingest": { "timestamp": "2017-05-04T22:46:09.676Z" } } }, { "doc": { "_id": "id", "_index": "index", "_type": "type", "_source": { "field3": "_value3", "field2": "_value2", "foo": "rab" }, "_ingest": { "timestamp": "2017-05-04T22:46:09.677Z" } } } ] } ] } ~~~