当前位置：首页 > article >正文

Elasticsearch 索引

article 2026/3/4 4:12:31

一、简介

在 Elasticsearch 中，索引（Index）是存储相关文档的地方，类似于关系数据库中的数据库。索引是 Elasticsearch 中最重要的概念之一，用于组织和存储数据。

二、索引的基本概念

索引（Index）：
- 索引是 Elasticsearch 中存储相关文档的地方，类似于关系数据库中的数据库。
- 每个索引有一个唯一的名称，用于标识和访问该索引。
文档（Document）：
- 文档是索引中的基本数据单元，格式为 JSON。每个文档包含多个字段（Fields），字段可以是各种数据类型，如文本、数字、日期等。
- 文档是 Elasticsearch 中存储和搜索的基本单位。
类型（Type）：
- 在 Elasticsearch 7.x 之前，索引中可以包含多个类型（Types），类似于关系数据库中的表。但在 7.x 及以后版本中，类型已被弃用，每个索引只能包含一种类型，默认类型为 _doc。
分片（Shard）：
- 索引被分成多个分片，每个分片是一个独立的 Lucene 索引。
- 分片允许数据分布在集群中的多个节点上，从而实现水平扩展和并行处理。
副本（Replica）：
- 每个分片可以有零个或多个副本，副本是分片的拷贝，用于提供高可用性和负载均衡。
- 副本分片可以与主分片存储在不同的节点上，以防止数据丢失。

三、索引的组成

在 Elasticsearch 中，创建索引时通常包含以下几个主要部分：

索引名称：唯一标识符。
设置（Settings）：配置分片、副本、分析器等。
映射（Mappings）：定义文档结构和字段类型。
别名（Aliases，可选）：为索引创建虚拟名称。

示例：

PUT /my_index
{"settings": {"number_of_shards": 3,"number_of_replicas": 2,"refresh_interval": "2s","analysis": {"analyzer": {"my_analyzer": {"type": "custom","tokenizer": "standard","filter": ["lowercase", "my_filter"]}},"filter": {"my_filter": {"type": "stop","stopwords": ["and", "the"]}}},"merge": {"policy": {"max_merged_segment": "5gb","segments_per_tier": 10}},"indexing_buffer": "512mb","codec": "best_compression","max_result_window": 20000},"mappings": {"properties": {"title": {"type": "text","analyzer": "my_analyzer"},"date": {"type": "date"},"author": {"type": "keyword"},"content": {"type": "text","analyzer": "my_analyzer"},"views": {"type": "integer"}}},"aliases": {"my_alias": {}}
}

3.1 索引名称

索引名称是索引的唯一标识符，用于在集群中识别该索引。
索引名称必须是小写字母，不能包含特殊字符（如 , /, *, ?, ", <, >, |, , , # 等）。
示例：my_index。

3.2 设置（Settings）

在 Elasticsearch 中，Settings（设置）是创建索引时用于配置索引行为和属性的部分。Settings 定义了索引的分片、副本、分析器、刷新间隔等核心参数，直接影响索引的性能、可用性和功能。

Settings 的作用
- 分片和副本：定义索引的分片数和副本数，影响数据的分布和高可用性。
- 分析器：定义文本字段的分词器和过滤器，影响全文搜索的行为。
- 刷新和合并策略：控制索引的刷新频率和段合并策略，影响写入性能和查询性能。
- 其他高级配置：如缓存、压缩、路由等。
Settings 的核心配置项
- 分片和副本
  - number_of_shards：
    - 定义索引的主分片数量。
    - 分片是 Elasticsearch 分布式存储的基本单位，每个分片是一个独立的 Lucene 索引。
    - 分片数在索引创建时指定，创建后不可更改。
    - 默认值：5。
    - 示例：
```
"number_of_shards": 3
```
  - number_of_replicas：
    - 定义每个主分片的副本数量。
    - 副本用于提供高可用性和负载均衡，副本分片可以与主分片存储在不同的节点上。
    - 副本数可以在索引创建后动态调整。
    - 默认值：1。
    - 示例：
```
"number_of_replicas": 2
```
- 分析器（Analysis）
  - analyzer：
    - 定义自定义分析器，用于在索引和搜索时处理文本字段。
    - 分析器由分词器（Tokenizer）和过滤器（Filter）组成。
    - 示例：
```
"analysis": {"analyzer": {"my_analyzer": {"type": "custom","tokenizer": "standard","filter": ["lowercase", "my_filter"]}},"filter": {"my_filter": {"type": "stop","stopwords": ["and", "the"]}}
}
```
  - tokenizer：
    - 定义分词器，用于将文本拆分为词项（Token）。
    - 常见的分词器：standard、whitespace、keyword 等。
  - filter：
    - 定义过滤器，用于对分词后的词项进行处理。
    - 常见的过滤器：lowercase（转换为小写）、stop（去除停用词）、synonym（同义词）等。
- 刷新间隔（Refresh Interval）
  - refresh_interval：
    - 定义索引的刷新频率，即新写入的文档在多长时间后可以被搜索到。
    - 刷新间隔越短，搜索的实时性越高，但写入性能可能下降。
    - 默认值：1s（1 秒）。
    - 示例：
```
"refresh_interval": "2s"
```
- 段合并策略（Merge Policy）
  - merge.policy：
    - 定义 Lucene 段的合并策略，影响索引的写入性能和查询性能。
    - 常见的配置项：
      - merge.policy.max_merged_segment：最大合并段大小。
      - merge.policy.segments_per_tier：每层的段数。
```
"merge": {"policy": {"max_merged_segment": "5gb","segments_per_tier": 10}
}
```
- 写入缓冲区（Indexing Buffer）
  - indexing_buffer：
    - 定义索引写入缓冲区的大小，影响写入性能。
    - 默认值：10% 的 JVM 堆内存。
    - 示例：
```
"indexing_buffer": "512mb"
```
- 压缩（Compression）
  - codec：
    - 定义索引数据的压缩算法。
    - 常见的压缩算法：default（默认）、best_compression（更高压缩率）。
    - 示例：
```
"codec": "best_compression"
```
- 路由（Routing）
  - routing：
    - 定义文档的路由规则，影响文档存储的分片。
    - 示例：
```
"routing": {"allocation": {"include": {"region": "us-east"}}
}
```
- 其他配置
  - max_result_window：
    - 定义搜索结果的最大返回条数。
    - 默认值：10000。
    - 示例：
```
"max_result_window": 20000
```
  - max_refresh_listeners：
    - 定义每个分片的最大刷新监听器数量。
    - 默认值：1000。
    - 示例：
```
"max_refresh_listeners": 2000
```
Settings 的最佳实践
- 合理设置分片数：
  - 分片数应根据数据量和集群规模合理设置，避免分片过多或过少。
  - 分片过多会增加集群的开销，分片过少会影响查询性能。
- 动态调整副本数：
  - 副本数可以根据集群的负载和可用性需求动态调整。
- 优化分析器：
  - 根据业务需求自定义分析器，提升全文搜索的准确性和性能。
- 调整刷新间隔：
  - 对于实时性要求高的场景，可以缩短刷新间隔；对于写入性能要求高的场景，可以延长刷新间隔。
- 监控和调优：
  - 定期监控索引的性能和资源使用情况，根据实际需求调整 Settings 配置。

3.3 映射（Mappings）

在 Elasticsearch 中，Mappings（映射）是定义索引中文档结构及其字段类型的方式。它类似于关系型数据库中的表结构（Schema），用于指定字段的数据类型、分析器、格式等属性。Mappings 是 Elasticsearch 索引的核心组成部分之一，直接影响数据的存储、索引和搜索行为。

Mappings 的作用
- 定义字段类型：指定每个字段的数据类型（如 text、keyword、date 等）。
- 控制字段行为：设置字段是否可索引、是否存储、是否支持分词等。
- 优化搜索性能：通过合理配置字段类型和分析器，提升搜索效率和准确性。
- 支持复杂数据结构：支持嵌套对象（object）和嵌套类型（nested）等复杂数据结构。
Mappings 的组成部分
- 字段属性（Field Properties）
  - type：字段的数据类型（如 text、keyword 等）。
  - index：是否索引该字段（true 或 false）。
  - analyzer：指定分词器（用于 text 字段）。
  - search_analyzer：指定搜索时的分词器。
  - store：是否单独存储该字段（true 或 false）。
  - format：指定日期格式（用于 date 字段）。
  - fields：多字段（Multi-fields），允许一个字段以多种方式索引。
  - ignore_above：忽略超过指定长度的字符串（用于 keyword 字段）。
  - null_value：为 null 值指定默认值。
- 字段类型（Field Types）
  - 常见的字段类型：
    - text：全文搜索字段，支持分词。
    - keyword：用于精确匹配的字段，不支持分词。
    - date：用于存储日期和时间。
    - long, integer, short, byte, double, float：用于存储数值。
    - boolean：用于存储布尔值（true 或 false）。
    - binary：用于存储二进制数据。
    - geo_point：用于存储地理坐标（经度和纬度）。
    - geo_shape：用于存储复杂的地理形状。
    - object：用于存储嵌套的 JSON 对象。
    - nested：用于存储数组中的嵌套对象（每个对象独立索引）。
动态映射（Dynamic Mapping）
Elasticsearch 支持动态映射，即在索引文档时自动推断字段类型。可以通过 dynamic 参数控制动态映射的行为：
- true：自动添加新字段（默认）。
- false：忽略新字段。
- strict：遇到未定义的字段时抛出异常。
```
"mappings": {"dynamic": "strict","properties": {"title": { "type": "text" }}
}
```

多字段（Multi-fields）
多字段允许一个字段以多种方式索引。例如，一个 text 字段可以同时以 text 和 keyword 类型索引：

"title": {"type": "text","fields": {"keyword": {"type": "keyword"}}
}
这样，title 字段可以用于全文搜索，而 title.keyword 字段可以用于精确匹配。

嵌套对象（Nested Object）

"mappings": {"properties": {"user": {"type": "nested","properties": {"name": { "type": "text" },"age": { "type": "integer" }}}}
}

Mappings 的最佳实践
- 合理选择字段类型：
  - 对于需要全文搜索的字段，使用 text 类型。
  - 对于需要精确匹配的字段，使用 keyword 类型。
  - 对于日期字段，使用 date 类型并指定合适的格式。
- 使用多字段：
  - 对于需要同时支持全文搜索和精确匹配的字段，使用多字段（Multi-fields）。
- 控制动态映射：
  - 根据需求设置 dynamic 参数，避免不必要的字段自动创建。
- 优化嵌套对象：
  - 对于嵌套对象，使用 nested 类型以确保每个对象独立索引。
- 避免过度索引：
  - 对于不需要搜索的字段，设置 index: false 以减少索引开销。
Mappings 的查看和修改
- 查看 Mappings：
```
GET /my_index/_mapping
```
- 修改 Mappings：
  - 对于已存在的字段，不能直接修改其类型，但可以添加新字段。
  - 如果需要修改字段类型，通常需要重新创建索引并重新索引数据。

3.4 别名（Aliases，可选）

别名是一个指向一个或多个索引的虚拟名称，可以用于简化索引管理和查询。
别名可以在创建索引时定义，也可以在索引创建后动态添加。
示例：
```
"aliases": {"my_alias": {}
}
```

四、索引的创建

创建索引
- 使用 PUT 请求创建索引，并指定设置和映射。
- 索引创建成功之后，以下属性将不可修改：
  - 索引名称
  - 主分片数量
  - 字段类型

下面是一个完整的 Elasticsearch 索引创建示例，包含设置、映射和别名：

PUT /my_index
{"settings": {"number_of_shards": 3,"number_of_replicas": 2,"analysis": {"analyzer": {"my_analyzer": {"type": "custom","tokenizer": "standard","filter": ["lowercase", "my_filter"]}},"filter": {"my_filter": {"type": "stop","stopwords": ["and", "the"]}}}},"mappings": {"properties": {"title": {"type": "text","analyzer": "my_analyzer"},"date": {"type": "date"},"author": {"type": "keyword","index": true},"content": {"type": "text","analyzer": "my_analyzer"},"views": {"type": "integer"}}},"aliases": {"my_alias": {}}
}

五、索引的操作

查看索引：
- 使用 GET 请求可以查看索引的详细信息，包括设置、映射、分片等。
```
GET /my_index
```
删除索引：
- 使用 DELETE 请求可以删除一个索引。
```
DELETE /my_index
```
更新索引
在 Elasticsearch 中，索引一旦创建，其核心结构和设置通常是不可变的，但某些部分是可以动态更新的。
- 索引的设置（Settings）
  - 可更新的内容：
    - 副本数（number_of_replicas）：可以动态调整副本数。
    - 刷新间隔（refresh_interval）：可以动态修改刷新间隔。
    - 分析器（analyzer）：可以为新字段添加分析器，但不能修改现有字段的分析器。
  - 不可更新的内容：
    - 分片数（number_of_shards）：分片数在索引创建后不可更改。
    - 主分片的设置：主分片的设置（如分片大小）不可更改。
```
PUT /my_index/_settings
{"index": {"number_of_replicas": 2,"refresh_interval": "30s"}
}
```
- 索引的映射（Mapping）
  - 可更新的内容：
    - 添加新字段：可以向现有映射中添加新字段。
    - 修改字段的多字段（multi-fields）：可以为现有字段添加新的多字段类型。
  - 不可更新的内容：
    - 修改现有字段的类型：例如，不能将 text 类型的字段改为 keyword 类型。
    - 删除字段：不能直接删除字段。
```
PUT /my_index/_mapping
{"properties": {"new_field": {"type": "text"}}
}
```
- 别名（Aliases）
  - 索引别名是一个指向一个或多个索引的虚拟名称。创建索引后，可以随时添加、删除或更新别名。
    - 添加别名：为索引添加新的别名。
    - 删除别名：移除索引的别名。
    - 切换别名：将别名指向另一个索引。
```
POST /_aliases
{"actions": [{ "add": { "index": "my_index", "alias": "my_alias" } }]
}
```