Elasticsearch 参考指南（索引模块）

索引模块

索引模块是按索引建立的模块，控制与索引相关的全部方面。

索引设置

能够按索引设置索引级别，设置多是：

静态

• 它们只能在索引建立时或在关闭的索引上设置。

动态

• 能够使用update-index-settings API在活动索引上更改它们。

更改关闭的索引上的静态或动态索引设置可能致使不正确的设置，在不删除和从新建立索引的状况下，不可能纠正这些设置。

静态索引设置

下面是与任何特定索引模块无关的全部静态索引设置的列表：

index.number_of_shards

• 索引应该具备的主碎片的数量，默认为1。此设置只能在建立索引时设置，它不能在关闭的索引上更改，注意：每一个索引的碎片数量限制为1024个，这种限制是一种安全限制，以防止意外地建立可能因为资源分配而破坏集群稳定的索引。能够在集群的每一个节点上经过指定系统变量export ES_JAVA_OPTS="-Des.index.max_number_of_shards=128"来修改该限制。

index.shard.check_on_startup

• 碎片在打开以前是否应该检查是否损坏，当检测到损坏时，它将阻止碎片被打开，接受：
  
  false：（默认）打开碎片时不要检查是否有损坏。
  checksum：检查物理损坏。
  true：检查物理和逻辑损坏，就CPU和内存使用而言，这要昂贵得多。

index.codec

• 默认值使用LZ4压缩压缩存储的数据，可是能够将这个值设置为best_compression，它使用DEFLATE得到更高的压缩比，代价是下降存储字段的性能。若是你正在更新压缩类型，则新的压缩类型将在段合并后应用，段合并能够使用强制合并来强制执行。

index.routing_partition_size

• 自定义路由值能够转到的碎片数，默认值为1，只能在建立索引时设置，这个值必须小于index.number_of_shards，除非index.number_of_shards值也是1。

index.load_fixed_bitset_filters_eagerly

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

动态索引设置

如下是与任何特定索引模块无关的全部动态索引设置列表：

index.number_of_replicas

• 每一个主碎片拥有的副本数量，默认为1。

index.auto_expand_replicas

• 根据集群中数据节点的数量自动扩展副本的数量，设置为以破折号分隔的下界和上界（例如0-5），或将all用于上界（例如0-all），默认为false（即禁用）。注意，自动扩展的副本数量没有考虑任何其余分配规则，好比碎片分配感知、过滤或每一个节点的总碎片，若是适用的规则阻止分配全部副本，则可能致使集群健康状态变为黄色。

index.search.idle.after

• 一个碎片在被认为是搜索空闲以前不能接收搜索或获取请求的时间（默认是30s）。

index.refresh_interval

• 多久执行一次刷新操做，使最近对索引的更改对搜索可见，默认为1s，能够设置为-1以禁用刷新。若是没有显式设置此设置，至少在index.search.idle.after秒内没有看到搜索流量的碎片在收到搜索请求以前不会收到后台刷新，当刷新挂起时，搜索到空闲碎片，将等待下一次后台刷新（在1秒内）。此行为的目的是在不执行搜索的默认状况下自动优化批量索引，为了不这种行为，应该将显式值1s设置为刷新间隔。

index.max_result_window

• 此索引的搜索from + size的最大值，默认为10000，搜索请求占用的堆内存和时间与from + size成正比，这限制了内存。

index.max_inner_result_window

• from + size的最大值，用于将内部命中定义和顶部命中聚合到此索引，默认为100，内部命中和顶部命中聚合占用堆内存，而且时间与from + size成正比，这限制了内存。

index.max_rescore_window

• 在此索引的搜索中，rescore请求的window_size的最大值，默认为index.max_result_window，其默认值为10000，搜索请求占用堆内存，时间与max(window_size, from + size)成正比，这限制了内存。

index.max_docvalue_fields_search

• 查询中容许的docvalue_fields的最大数量，默认为100，Doc-value字段代价高昂，由于它们可能致使每一个字段每一个文档的搜索。

index.max_script_fields

• 查询中容许的最大script_fields数量，默认为32。

index.max_ngram_diff

• NGramTokenizer和NGramTokenFilter的min_gram和max_gram之间容许的最大差别，默认为1。

index.max_shingle_diff

• 对于ShingleTokenFilter，max_shingle_size和min_shingle_size之间容许的最大差别，默认为3。

index.blocks.read_only

• 设置为true使索引和索引元数据只读，设置为false容许写入和元数据更改。

index.blocks.read_only_allow_delete

• 与index.blocks.read_only相同，可是容许删除索引来释放资源。

index.blocks.read

• 设置为true以禁用对索引的读取操做。

index.blocks.write

• 设置为true可禁用对索引的数据写操做，与read_only不一样，此设置不影响元数据，例如，能够用write块关闭索引，但不能用read_only块关闭索引。

index.blocks.metadata

• 设置为true可禁用索引元数据的读写。

index.max_refresh_listeners

• 索引的每一个碎片上可用的刷新侦听器的最大数量，这些侦听器用于实现refresh=wait_for。

index.analyze.max_token_count

• 使用_analyze API能够生成的最大令牌数量，默认为10000。

index.highlight.max_analyzed_offset

• 为高亮显示请求分析的最大字符数，此设置仅适用于在索引没有偏移量或术语向量的文本上请求高亮显示时，默认为1000000。

index.max_terms_count

• 能够在terms查询中使用的术语的最大数量，默认为65536。

index.max_regex_length

• 可用于Regexp查询的正则表达式的最大长度，默认为1000。

index.routing.allocation.enable

• 控制此索引的碎片分配，它能够被设置为：

  • all（默认值）— 容许为全部碎片分配碎片。
  • primaries — 只容许为主碎片分配碎片。
  • new_primary — 只容许为新建立的主碎片分配碎片。
  • none — 不容许碎片分配。

index.routing.rebalance.enable

• 启用此索引的碎片从新平衡，它能够被设置为：

  • all（默认值）—容许对全部碎片进行碎片再平衡。
  • primaries — 只容许对主碎片进行碎片再平衡。
  • replicas — 只容许对复制碎片进行碎片再平衡。
  • none — 不容许再平衡碎片。

index.gc_deletes

• 已删除文档的版本号仍可用于进一步版本化操做的时间长度，默认为60s。

index.default_pipeline

• 此索引的默认摄取节点管道，若是设置了默认管道且管道不存在，则索引请求将失败，能够使用pipeline参数重写默认值，特殊管道名称_none表示不该该运行摄取管道。

其余索引模块中的设置

其余索引设置在索引模块中可用：

分析

• 用于定义分析程序、令牌器、令牌过滤器和字符过滤器的设置。

索引碎片分配

• 控制将碎片分配到节点的位置、时间和方式。

映射

• 为索引启用或禁用动态映射。

合并

• 控制后台合并进程如何合并碎片。

类似性

• 配置自定义类似性设置，以自定义搜索结果的评分方式。

慢日志

• 控制记录查询和获取请求的速度。

存储

• 配置用于访问碎片数据的文件系统类型。

事务日志

• 控制事务日志和后台刷新操做。

X-Pack索引设置

索引生命周期管理

• 指定索引的生命周期策略和滚动别名。