索引设置（Index Settings） #

索引级别的设置直接影响写入、查询性能以及资源利用率。本页按功能分类列出关键设置及其默认值，帮助你在建索引或调优时有一个清单。

查看与修改索引设置 #

// 查看索引的所有设置
GET /my-index/_settings

// 查看特定设置
GET /my-index/_settings/index.refresh_interval

// 动态修改设置（仅限 Dynamic 类型的设置）
PUT /my-index/_settings
{
  "index.refresh_interval": "30s"
}

Static vs Dynamic：Static 设置只能在索引创建时指定或在关闭索引后修改；Dynamic 设置可以在运行时通过 _settings API 随时修改。

分片与副本 #

设计建议 #

• 主分片数 创建后无法修改（取模路由会变），需要扩容时通过 新索引 + 重建索引 + 别名切换 实现
• 对中小数据量索引，避免设置过多主分片；推荐按时间/业务拆索引
• 副本越多读吞吐越高，但写入与存储成本也越大；写多读少的索引可适当降低副本数

创建索引时指定分片与副本：

PUT /my-index
{
  "settings": {
    "index.number_of_shards": 3,
    "index.number_of_replicas": 2
  }
}

刷新与近实时 #

刷新控制"近实时"行为——新写入的文档需要经过一次 refresh 才能被 _search 检索到（详见 写入与存储机制）。

常见调优场景：

• 高写入吞吐（如批量导入）：临时设为 "-1" 关闭自动刷新，导入完成后手动刷新
• 对实时性要求不高的索引：设为 "30s" 或 "60s" 以减少刷新开销

// 批量导入时关闭自动刷新
PUT /my-index/_settings
{ "index.refresh_interval": "-1" }

// 导入完成后恢复并手动刷新
PUT /my-index/_settings
{ "index.refresh_interval": "1s" }

POST /my-index/_refresh

事务日志（Translog） #

事务日志用于保证数据持久性——在 Lucene 提交（flush）之前，所有写入都记录在 translog 中，以便节点崩溃后恢复。

调优建议：

• 默认 REQUEST 模式最安全，每次写入返回成功即表示数据已持久化
• 如果可以接受极端情况（节点突然断电）下丢失最近几秒的写入，可改为 ASYNC 以提升写入性能
• flush_threshold_size 越大，flush 频率越低，但恢复时间也越长

段合并（Merge） #

写入产生的小段（segment）会被后台合并为更大的段，以维持查询效率。合并策略影响 IO 与 CPU 开销。

合并策略（Merge Policy） #

合并调度器（Merge Scheduler） #

一般情况下，默认策略已经足够。应通过监控观察是否存在长期高合并压力或段数量异常；只有在确有问题时才针对性调整。

编解码器与压缩（Codec） #

选择建议：

• 写入密集型 / 对查询延迟敏感：使用默认的 "default"（LZ4）
• 存储成本敏感 / 冷数据归档：使用 "best_compression"（DEFLATE）

更多关于索引压缩的讨论，参见 索引压缩。

查询与结果限制 #

其他重要设置 #

模板与默认设置 #

为了保持索引配置的一致性，通常使用 索引模板来：

• 为某类索引（按名称模式匹配）统一设置分片数、副本数、刷新策略等
• 统一分析器、动态映射策略

在多租户或多环境（开发/测试/生产）场景下，建议通过模板与自动化来管理索引设置，避免手工创建索引时遗漏关键参数。

小结 #

• index.number_of_shards 和 index.number_of_replicas 是最基础的设置，直接影响数据分布与可用性
• index.refresh_interval 控制近实时可见性，是写入性能调优的首要旋钮
• index.translog.durability 在性能与持久性之间做权衡
• 段合并设置一般保持默认，除非监控显示合并压力异常
• index.codec 在存储成本与查询速度之间选择
• 用 索引模板统一管理设置，避免逐个索引手动配置

下一步可以继续阅读：

• 别名（Aliases）
• 容量规划
• 映射基础