elasticsearch映射如何动态更新

在 Elasticsearch 中，映射（mapping）一旦创建，很多结构是不能随意修改的，但“动态更新映射”有几种常见场景和做法。下面按能否改、怎么改、注意事项给你系统讲清楚。

一、Mapping 的基本限制

❌ 不能直接修改的

以下字段属性创建后不能修改：

• 字段类型（text → keyword、integer → long 等）
• 是否分词（analyzed / not_analyzed）
• 是否是 nested 类型
• index: false → true

如果一定要改这些，只能重建索引（reindex）。

二、可以“动态更新”的 Mapping 方式

✅ 1. 动态字段映射（Dynamic Mapping）

Elasticsearch 默认允许自动添加新字段

PUT /my_index/_doc/1
{
  "name": "Tom",
  "age": 18
}

如果 age 之前不存在，ES 会自动：

• 推断类型（integer）
• 自动加入 mapping

控制动态行为

PUT /my_index
{
  "mappings": {
    "dynamic": "true"   // true | false | strict
  }
}

✅ 2. 显式添加新字段（推荐）

你可以给已有索引增加新字段

PUT /my_index/_mapping
{
  "properties": {
    "email": {
      "type": "keyword"
    }
  }
}

✅ 特点：

• 不影响已有数据
• 只影响后续写入的文档
• 老文档该字段为 null

✅ 3. 动态模板（Dynamic Templates）

适合字段名不规则但类型统一

PUT /my_index
{
  "mappings": {
    "dynamic_templates": [
      {
        "strings_as_keyword": {
          "match": "*_id",
          "mapping": {
            "type": "keyword"
          }
        }
      }
    ]
  }
}

效果：

• user_id、order_id → 自动变成 keyword

✅ 4. 修改“可变更”的字段参数

部分参数可以改：

PUT /my_index/_mapping
{
  "properties": {
    "content": {
      "type": "text",
      "fields": {
        "keyword": {
          "type": "keyword"
        }
      }
    }
  }
}

✅ 可加：

• fields（multi-fields）
• copy_to
• meta

❌ 不能改：

• type
• analyzer（已存在数据）

三、必须重建索引的情况（Reindex）

什么时候必须 reindex？

• 改字段类型
• 改分词器
• 改 nested / object
• 改 index: false → true

标准流程

PUT /my_index_v2
{
  "mappings": {
    "properties": {
      "age": { "type": "long" }
    }
  }
}

POST _reindex
{
  "source": { "index": "my_index" },
  "dest": { "index": "my_index_v2" }
}

# 别名切换
POST _aliases
{
  "actions": [
    { "remove": { "index": "my_index", "alias": "my_index_alias" } },
    { "add": { "index": "my_index_v2", "alias": "my_index_alias" } }
  ]
}

四、最佳实践建议

✅ 生产环境：

• 使用 别名（alias）
• mapping 尽量提前规划
• 新字段用 _mapping 显式添加
• 避免依赖 dynamic mapping

✅ 调试环境：

• 可以开 dynamic: true

五、快速对照表

如果你有具体场景（比如“想把 text 改成 keyword”、“ES 7/8 版本”、“日志/电商场景”），可以直接贴出来，我可以给你最合适的方案。