4、索引映射基础：Mapping概念、字段类型与映射策略

索引映射（Mapping）是 Elasticsearch 中定义文档结构及其字段类型的过程，类似于关系型数据库中的表结构定义（Schema）。在构建搜索服务时，映射的正确性直接决定了数据的存储效率、查询性能以及搜索结果的准确性。本章将系统讲解 Mapping 的核心概念、字段类型体系以及动态映射与显式映射的适用场景。

4.1 Mapping 核心概念

Mapping 定义了索引中每个字段的名称、数据类型、索引方式以及分析器配置。Elasticsearch 在写入文档时，会根据 Mapping 对字段进行分词、索引和存储。理解 Mapping 的关键在于区分以下三个层次：

4.2 核心字段类型详解

Elasticsearch 提供了丰富的字段类型，按用途可分为核心类型、复杂类型和专用类型。以下是搜索服务中最常用的字段类型：

4.3 text 与 keyword 的深度对比

text 和 keyword 是搜索服务中最容易混淆的一对类型。它们的核心区别在于是否经过分析器（Analyzer）处理：

在实际项目中，经常需要对同一个字段同时支持全文搜索和精确聚合。Elasticsearch 提供了 multi-fields 机制：

{
  "mappings": {
    "properties": {
      "title": {
        "type": "text",
        "fields": {
          "keyword": {
            "type": "keyword",
            "ignore_above": 256
          }
        }
      }
    }
  }
}

上述映射中，title 字段默认按 text 类型进行全文搜索，而 title.keyword 子字段则支持精确匹配和聚合操作。

4.4 动态映射与显式映射

Elasticsearch 提供了两种映射定义方式：动态映射（Dynamic Mapping）和显式映射（Explicit Mapping）。理解它们的差异对于构建稳定的搜索服务至关重要。

4.4.1 动态映射

动态映射允许 Elasticsearch 在索引文档时自动检测并添加新字段。其推断规则如下：

4.4.2 显式映射

显式映射要求开发者在创建索引时手动定义所有字段的类型和参数。这是生产环境的推荐做法：

// NestJS 中使用 Elasticsearch 客户端创建索引并定义 Mapping
async createProductIndex() {
  const index = 'products';
  const exists = await this.elasticsearch.indices.exists({ index });

  if (!exists) {
    await this.elasticsearch.indices.create({
      index,
      body: {
        settings: {
          number_of_shards: 3,
          number_of_replicas: 1
        },
        mappings: {
          dynamic: 'strict', // 严格模式：禁止动态添加字段
          properties: {
            productId: { type: 'keyword' },
            name: {
              type: 'text',
              fields: {
                keyword: { type: 'keyword', ignore_above: 256 }
              }
            },
            description: { type: 'text', analyzer: 'ik_max_word' },
            price: { type: 'double' },
            category: { type: 'keyword' },
            tags: { type: 'keyword' },
            stock: { type: 'integer' },
            createdAt: { type: 'date', format: 'yyyy-MM-dd HH:mm:ss' },
            isActive: { type: 'boolean' },
            attributes: {
              type: 'object',
              properties: {
                color: { type: 'keyword' },
                size: { type: 'keyword' }
              }
            }
          }
        }
      }
    });
  }
}

4.4.3 动态映射的三种模式

Elasticsearch 允许通过 dynamic 参数控制动态映射的行为：

4.5 映射的更新与限制

Mapping 一旦创建，某些属性就无法修改。理解这些限制有助于在设计阶段做出正确决策：

4.6 本章小结

• Mapping 是 Elasticsearch 索引的核心结构定义，决定了字段的存储和查询行为。
• text 用于全文搜索，keyword 用于精确匹配和聚合，两者可通过 multi-fields 共存。
• 动态映射 适合开发阶段和日志场景，但存在类型推断风险。
• 显式映射 是生产环境的标准做法，配合 dynamic: 'strict' 可避免字段类型混乱。
• 映射一旦创建，字段类型不可修改，变更需通过 reindex 实现。
• 在 NestJS 中，建议在模块初始化时通过 Elasticsearch 客户端统一创建索引和 Mapping。