Dynamic field mapping(動態字段映射) · Elasticsearch 5.4 中文文檔

# Dynamic field mapping(動態字段映射) 默認情況下，當文檔中找到以前未出現過的字段時，Elasticsearch會將新的字段添加到類型映射中。這個行為可以被禁用，通過文檔和[對象](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/object.html)級別上去將[動態](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/dynamic.html)參數設置為false(忽略新的字段)或采用嚴謹的格式(在遇到未知字段時拋出異常)來禁用該行為。假設啟用了動態字段映射，則使用一些簡單的規則來確定該字段應有的數據類型： | JSON datatype(JSON數據類型) | Elasticsearch datatype(Elasticsearch數據類型) | | --- | --- | | null | 空！沒有添加數據 | | true OR false | [boolean](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/boolean.html)字段（布爾類型字段） | | floating point number(浮點型數字) | float字段(浮點類型字段) | | integer | long字段(長整型字段) | | object | 對象字段(對象類型字段) | | array | 數組字段.(具體類型取決于數組中的第一個非空值) | | string | 要么是date字段(值通過日期檢測),要么是double或long型字段(值通過數據檢測)，要么是文本字段，與keyword子字段。 | 只有這些字段類型可以動態檢測出來。因此，必須明確定義其他數據類型。除了以下列出的選項，動態字段映射規則也可以通過dynamic_templates(動態模板)進一步定制。 **Date detection(日期檢測)** 如果啟動date_detection(默認)，則會檢查新的字符串字段，查看其內容是否與dynamic_date_formats中任一日期模式匹配。如果發現匹配，則添加一個相應格式的新的日期字段。 dynamic_date_formats的默認值為： ``` [ "strict_date_optional_time","yyyy/MM/dd HH:mm:ss Z||yyyy/MM/dd Z"] ``` 例子： ``` PUT my_index/my_type/1{ "create_date": "2015/09/02"} GET my_index/_mapping #1 ``` | 1 | create_date字段已經添加成格式為"yyyy/MM/dd HH:mm:ss Z||yyyy/MM/dd Z"的日期字段 | **Disabling date detection(禁用日期檢測)** 可以通過將date_detection設置為false來禁用動態日期檢測： ``` PUT my_index { "mappings": { "my_type": { "date_detection": false } }} PUT my_index/my_type/1 { #1 "create": "2015/09/02"} ``` | 1 | create_date字段已添加為text(文本)字段。 | **Customising detected date formats(自定義檢測到的日期格式)** 或者，可以通過自定義dynamic_date_formats來支持你自己的日期格式: ``` PUT my_index { "mappings": { "my_type": { "dynamic_date_formats": ["MM/dd/yyyy"] } }} PUT my_index/my_type/1{ "create_date": "09/25/2015"} ``` **Numeric detection(數字檢測)** 雖然JSON支持原生的浮點型和整型數據類型，但是有些應用程序或預言有時會將數字作為字符串。通常正確的解決方案是顯式的映射這些字段，但是可以啟用數字檢測（默認情況下是禁用的）來自動執行此操作。 ``` PUT my_index { "mappings": { "my_type": { "numeric_detection": true } }} PUT my_index/my_type/1{ "my_float": "1.0", #1 "my_integer": "1" } #2 ``` | 1 | my_float字段已添加為double類型字段。 | | 2 | my_integer字段已添加為long類型字段。 | 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.3/dynamic-field-mapping.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/dynamic-field-mapping.html)（修改該鏈接為官網對應的鏈接）譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=9406330](http://www.apache.wiki/pages/viewpage.action?pageId=9406330)（修改該鏈接為 **ApacheCN** 對應的譯文鏈接）貢獻者 : [曾少峰](/display/~zengshaofeng)，[ApacheCN](/display/~apachecn)，[Apache中文網](/display/~apachechina)