索引模块

索引模块

索引模块是按索引创建的模块，控制有关索引的所有方面。

索引设置

可以为每个索引设置索引级的设置。设置如下：

静态设置

只能在索引创建时，或者关闭的索引上设置。

动态设置

可以通过更新索引 API 在活动的索引上修改。

!> 在关闭的索引上修改静态或动态索引设置，可能会导致不正确的设置。如果不删除并重建索引，是无法修正这些设置。

静态索引设置

以下是与特定索引模块无关的静态索引设置的列表：

index.number_of_shards

索引应该具有的主分片数量。默认为 1。此设置只能在创建索引时设置。在关闭的索引上也不能修改。

?> 每个分片数量限定为 1,024。这是一个安全限定，以防止意外创建索引，而这些索引会由于资源分配而破坏集群的稳定性。这个限定可以通过指定 export ES_JAVA_OPTS="-Des.index.max_number_of_shards=128" 系统属性来修改，这个属性属于集群的每个节点。

index.number_of_routing_shards

用于拆分索引的路由分片数。例如，number_of_routing_shards 设置为 30（5 x 3 x 2）的 5 分片索引，可以除以因子 2 或 3。换言之，可以按以下方式拆分：

5 → 10 → 30 (除以 2, 再除以 3)
5 → 15 → 30 (除以 3, 再除以 2)
5 → 30 (除以 6)

这个设置的默认值基于索引的主分片数。默认情况下，允许按 2 的因子拆分最多 1,024 个分片。

?> 在 Elasticsearch 7.0.0 以及更新的版本，这个设置影响文档在分片中的分布方式。使用自定义路由重新索引旧索引时，你必须显式设置 index.number_of_routing_shards 以维持相同的文档分布。参阅相关的碎裂变化。

index.shard.check_on_startup

在打开之前是否应该检查分片是否损坏。当检测到损坏时，它将阻止打开分片，允许的值：

- `false`
（默认值）当打开分片时不检测损坏。
- `checksum`
检测物理损坏。
- `true`
检测物理和逻辑损坏。这会消耗更高的 CPU 和内存。

!> 仅限专家。在大型索引上检查分片可能花费更多的时间。

index.codec default 值使用 LZ4 压缩来压缩存储的数据，但可以设置为 best_compression,即使用 DEFLATE 来获得更高的压缩比，但会降低存储字段的性能。如果要更新压缩类型，合并段后将应用新的压缩类型。段合并可以使用强制合并来强制合并。
index.routing_partition_size

自定义路由值可以转到的分片数。默认为 1，只能在索引创建时设置。此值必须小于 index.number_of_shards，除非 index.number_of_shards 值也是 1。参阅路由到索引分区，获取如何使用此设置的更多信息。

index.soft_deletes.enabled

标示索引是否允许软删除。软删除只能在索引创建时设置，也只能配置在 Elasticsearch 6.5.0 及后续版本创建的索引上。默认为 true。（7.6.0版本就不推荐，不推荐禁用软删除创建索引，并在未来版本移除此设置）

index.soft_deletes.retention_lease.period

分片历史保持租约在它被认为过期前的最大周期。分片历史保留租约，确保在 Lucene 索引上进行合并时保留软删除。如果软删除在可以复制到跟随者之前被合并，由于领导者的历史记录不完整，后续过程将失败。默认为 12h。

index.load_fixed_bitset_filters_eagerly

标示是否为嵌套查询预加载缓存过滤器。可能值为 true（默认值）和 false。

index.hidden

标示默认情况下，索引是否应该隐藏。当使用通配符表达式时，隐藏索引默认不会返回。通过 expand_wildcards 参数，每个请求都可以控制此行为。可能的值为 true 和 false（默认值）。

动态索引设置

以下是与任何特定索引模块无关的所有动态设置列表：

index.number_of_replicas

每个主分片的副本数。默认为 1。

index.auto_expand_replicas

根据集群中数据节点的数量，自动扩展副本的数量。设置为以连接符分隔的下限和上限（如，0-5）或者使用 all 作为上限（如，0-all）。默认为 false（即禁用）。请注意自动扩展的副本数量只考虑分配筛选规则，而忽略其他分配规则，如分片分配感知和每个节点分片总数，如果适用规则阻止分配所有副本，则这可能导致集群健康变为 YELLOW（黄色）。

index.search.idle.after

在被认为是搜索空闲之前，分片不能接收搜索或获取请求的时间。（默认值为 30s）

index.refresh_interval

执行刷新操作的频率，它可以使最近对索引的修改对搜索可见。默认为 1s。可以设置为 -1 为禁止刷新。如果这个设置未显示设置，则至少在 index.search.idle.after 秒后，未看到搜索流量的分片在收到搜索请求前不会接收后台刷新。此行为旨在在默认情况下，当不执行搜索时自动优化批量索引。为了选择退出此行为，应将显式值 1s 设置为刷新间隔。