一、简介
在 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
- number_of_shards:
-
分析器(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(同义词)等。
- analyzer:
-
刷新间隔(Refresh Interval)
- refresh_interval:
- 定义索引的刷新频率,即新写入的文档在多长时间后可以被搜索到。
- 刷新间隔越短,搜索的实时性越高,但写入性能可能下降。
- 默认值:1s(1 秒)。
- 示例:
"refresh_interval": "2s"
- refresh_interval:
-
段合并策略(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 } }
- merge.policy:
-
写入缓冲区(Indexing Buffer)
- indexing_buffer:
- 定义索引写入缓冲区的大小,影响写入性能。
- 默认值:10% 的 JVM 堆内存。
- 示例:
"indexing_buffer": "512mb"
- indexing_buffer:
-
压缩(Compression)
- codec:
- 定义索引数据的压缩算法。
- 常见的压缩算法:default(默认)、best_compression(更高压缩率)。
- 示例:
"codec": "best_compression"
- codec:
-
路由(Routing)
- routing:
- 定义文档的路由规则,影响文档存储的分片。
- 示例:
"routing": { "allocation": { "include": { "region": "us-east" } } }
- routing:
-
其他配置
- max_result_window:
- 定义搜索结果的最大返回条数。
- 默认值:10000。
- 示例:
"max_result_window": 20000
- max_refresh_listeners:
- 定义每个分片的最大刷新监听器数量。
- 默认值:1000。
- 示例:
"max_refresh_listeners": 2000
- max_result_window:
-
-
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:用于存储数组中的嵌套对象(每个对象独立索引)。
- 常见的字段类型:
- 字段属性(Field Properties)
-
动态映射(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:
- 对于已存在的字段,不能直接修改其类型,但可以添加新字段。
- 如果需要修改字段类型,通常需要重新创建索引并重新索引数据。
- 查看 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
- 使用 GET 请求可以查看索引的详细信息,包括设置、映射、分片等。
-
删除索引:
- 使用 DELETE 请求可以删除一个索引。
DELETE /my_index
- 使用 DELETE 请求可以删除一个索引。
-
更新索引
在 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" } } ] }
- 索引别名是一个指向一个或多个索引的虚拟名称。创建索引后,可以随时添加、删除或更新别名。
- 索引的设置(Settings)