Eager Global Ordinals 参数 #

eager_global_ordinals 参数控制是否在索引刷新时提前构建全局序数（Global Ordinals）。全局序数是 keyword、ip 等字段执行聚合和排序时使用的内部数据结构。

参数选项 #

值	说明
`false`	默认值。全局序数在首次查询（聚合/排序）时惰性构建。
`true`	在索引刷新（refresh）时立即构建全局序数。

默认行为 #

默认情况下，全局序数采用惰性加载策略：第一次聚合或排序请求会触发构建，后续请求直接使用缓存。当索引发生变更并刷新后，缓存失效，下次查询时重新构建。

示例 #

PUT my-index
{
  "mappings": {
    "properties": {
      "category": {
        "type": "keyword",
        "eager_global_ordinals": true
      }
    }
  }
}

何时启用 #

场景	建议
高频聚合字段，要求低延迟	设为 `true`，将构建开销转移到索引阶段
普通聚合字段	保持默认 `false`，惰性构建已足够
很少聚合的字段	保持默认 `false`，避免浪费资源
写入量远大于查询量	保持默认 `false`，频繁刷新会导致频繁重建

注意事项 #

启用后会增加索引刷新时间，因为每次 refresh 都需要重新构建全局序数
全局序数存储在堆内存中，高基数字段会占用较多内存
可通过 _stats API 查看全局序数占用的内存大小
对于时序数据等写入密集场景，建议保持默认值以避免刷新延迟增加

Eager Global Ordinals 参数 #

相关指南 #

参数选项 #

默认行为 #

示例 #

何时启用 #

注意事项 #