• 自定义动态索引
  • 日期检测
  • 动态模板

    自定义动态索引

    如果你想在运行时的增加新的字段，你可能会开启动态索引。虽然有时动态映射的 规则 显得不那么智能，幸运的是我们可以通过设置来自定义这些规则。

    日期检测

    当 Elasticsearch 遇到一个新的字符串字段时，它会检测这个字段是否包含一个可识别的日期，比如 2014-01-01。如果它看起来像一个日期，这个字段会被作为 date 类型添加，否则，它会被作为 string 类型添加。

    有些时候这个规则可能导致一些问题。想象你有一个文档长这样：

    1. { "note": "2014-01-01" }

    假设这是第一次见到 note 字段，它会被添加为 date 字段，但是如果下一个文档像这样：

    1. { "note": "Logged out" }

    这显然不是一个日期，但为时已晚。这个字段已经被添加为日期类型，这个 不合法的日期 将引发异常。

    日期检测可以通过在根对象上设置 date_detection 为 false 来关闭：

    1. PUT /my_index
    2. {
    3.     "mappings": {
    4.         "my_type": {
    5.             "date_detection": false
    6.         }
    7.     }
    8. }

    使用这个映射，字符串将始终是 string 类型。假如你需要一个 date 字段，你得手动添加它。

    提示：

    Elasticsearch 判断字符串为日期的规则可以通过 dynamic_date_formats 配置 来修改。

    动态模板

    使用 dynamic_templates，你可以完全控制新字段的映射，你设置可以通过字段名或数据类型应用一个完全不同的映射。

    每个模板都有一个名字用于描述这个模板的用途，一个 mapping 字段用于指明这个映射怎么使用，和至少一个参数（例如 match）来定义这个模板适用于哪个字段。

    模板按照顺序来检测，第一个匹配的模板会被启用。例如，我们给 string 类型字段定义两个模板：

    • es: 字段名以 _es 结尾需要使用 spanish 分析器。
    • en: 所有其他字段使用 english 分析器。

    我们将 es 模板放在第一位，因为它比匹配所有字符串的 en 模板更特殊一点

    1. PUT /my_index
    2. {
    3.     "mappings": {
    4.         "my_type": {
    5.             "dynamic_templates": [
    6.                 { "es": {
    7.                       "match":              "*_es", <1>
    8.                       "match_mapping_type": "string",
    9.                       "mapping": {
    10.                           "type":           "string",
    11.                           "analyzer":       "spanish"
    12.                       }
    13.                 }},
    14.                 { "en": {
    15.                       "match":              "*", <2>
    16.                       "match_mapping_type": "string",
    17.                       "mapping": {
    18.                           "type":           "string",
    19.                           "analyzer":       "english"
    20.                       }
    21.                 }}
    22.             ]
    23. }}}

    <1> 匹配字段名以 _es 结尾的字段.

    <2> 匹配所有字符串类型字段。

    match_mapping_type 允许你限制模板只能使用在特定的类型上，就像由标准动态映射规则检测的一样，（例如 strong 和 long）

    match 参数只匹配字段名，path_match 参数则匹配字段在一个对象中的完整路径，所以 address.*.name 规则将匹配一个这样的字段：

    1. {
    2.     "address": {
    3.         "city": {
    4.             "name": "New York"
    5.         }
    6.     }
    7. }

    unmatch 和 path_unmatch 规则将用于排除未被匹配的字段。

    更多选项见根对象参考文档