# 滲濾型 原文鏈接 :[https://www.elastic.co/guide/en/elasticsearch/reference/current/percolator.html](https://www.elastic.co/guide/en/elasticsearch/reference/current/percolator.html) 譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=10030678](http://www.apache.wiki/pages/viewpage.action?pageId=10030678) 貢獻者 : [李亞運](/display/~liyayun)，[ApacheCN](/display/~apachecn)，[Apache中文網](/display/~apachechina) ## 簡述 `percolator`字段類型將json結構解析為本地查詢，并存儲該查詢，以便[percolate查詢](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-percolate-query.html)可以使用它來匹配提供的文檔。 包含json對象的任何字段都可以配置為滲濾器字段。?滲濾器字段類型沒有參數設置。?只需配置滲`percolator`字段類型就足以指示ES將字段視為查詢。 如果以下映射配置`query`字段的`percolator`字段類型： ``` { "properties": { "query": { "type": "percolator" } } } ``` 那么下面的json代碼段可以作為本地查詢進行索引： ``` { "query" : { "match" : { "field" : "value" } } } ```  在滲濾型查詢中引用的字段必須已經存在于與用于滲濾的索引相關聯的映射中。?為了確保這些字段存在，通過[創建索引](https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-create-index.html)或[放置映射](https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-put-mapping.html)?API添加或更新映射?。?在滲濾型查詢中引用的字段可以存在于包含`percolator`字段類型的任何類型的索引中。 此外，索引只能包含多達一個滲濾型字段映射。?多個字段將被put索引拒絕并放置映射API。 ## 專用滲透索引 滲濾型查詢可以添加到任何索引。?而不是向數據所在的索引添加滲出查詢，也可以將這些查詢添加到專用索引中。?這樣做的優點在于，這個專用的滲透索引可以有自己的索引設置（例如主分片和副本分片的數量）。?如果您選擇具有專門的滲透指數，則需要確保來自正常索引的映射也可在滲透指數中使用。?否則，滲出查詢可能會被錯誤解析。 ## 強制未映射的字段被處理為字符串? 在某些情況下，什么樣的滲濾查詢已經被注冊了是不知道的，如果字段未映射的那些字段被滲透查詢所引用，那么將添加滲濾查詢失敗。?這意味著需要更新映射以使該字段具有適當的設置，然后可以添加滲濾查詢。?但是有時如果所有未映射的字段都被處理，就像這些是默認的字符串字段一樣。?在這種情況下，可以將`index.percolator.map_unmapped_fields_as_string`設置設置為`true`?（默認為`false`?），然后如果在percolator查詢中引用的字段不存在，則它將作為默認字符串字段處理，以便添加滲濾查詢不會失敗。 ## 限制 因為`percolate`查詢一次處理一個文檔，它不支持針對子文件，如`has_child`和`has_parent`運行的查詢和過濾器。 ?在查詢解析過程中有許多通過調用進行獲取數據的查詢。?例如使用`terms`查詢時的術語查詢，使用索引腳本時的`template`查詢以及使用預索引形狀時的`geo_shape`?。?當這些查詢由`percolator`字段類型索引時，get調用將被執行一次。?因此，每次`percolator`查詢評估這些查詢時，將使用索引時間獲取術語，形狀等。如果源索引在索引時更改,需要注意的是要獲取這些查詢所執行的術語，每次在滲濾器查詢在主分片和副本分片上進行索引時都會發生，所以實際索引的術語在分片副本之間可能不同。