【Elasticsearch】settings

通过settings或者yml文件写入的配置是不是最终都会写到settings对象中呢?

是的,最终都会汇总到 `Settings` 对象里,但来源不同、优先级不同、作用范围也不同。可以用一句话总结:

> "yml 文件只是初始来源之一,运行时所有配置最终都会归一到 Settings 对象,但 Settings 对象是分层的,不同层之间可以覆盖。"


🔍 1. 配置来源与层次

来源 写入目标 作用范围 备注

`elasticsearch.yml` 节点级的 `Settings` 整个节点 启动时只读一次

命令行参数 `-E` 同上 同上 优先级高于 yml

索引创建时的 settings 该索引专属的 `Settings` 仅该索引 通过 `PUT /index/_settings` 可修改

集群级动态设置 集群状态的 `Settings` 整个集群 通过 `PUT _cluster/settings` 写入


🔍 2. 最终归一:Settings 对象

  • 节点启动时,`Environment` 会把 `elasticsearch.yml`、CLI 参数、jvm.options 等解析成一个全局的 `Settings` 实例。

  • 索引创建时,会再创建一个 索引级别的 `Settings`,它会把全局配置作为 fallback,然后再把索引自己的 settings 覆盖进去。

  • 运行时,通过 `ClusterService.state().metadata().index("idx").getSettings()` 拿到的是索引级 Settings;通过 `Node.NODE_SETTINGS` 拿到的是节点级 Settings。


✅ 举个例子

假设你在 `elasticsearch.yml` 里写了:

```yaml

index.number_of_shards: 3

```

  • 启动后,节点级 `Settings` 里会有 `index.number_of_shards: 3`。

  • 当你创建索引 `PUT /my_index` 时,如果没有显式指定 `number_of_shards`,就会用到这个全局默认值。

  • 如果你在创建索引时写了:

```json

PUT /my_index

{

"settings": {

"number_of_shards": 5

}

}

```

那么最终该索引的 `Settings` 对象里就是 `5`,覆盖了全局的 `3`。


✅ 总结一句话

> 所有配置最终都会落到某个 `Settings` 对象里,但不同层级之间可以相互覆盖:索引级 > 集群动态 > 节点级(yml)。

"fallback" 就是兜底值、备胎值的意思。

在 Elasticsearch 的 `Settings` 体系里:

> 如果当前层(索引、集群、节点)没有显式配置某个键,就会自动去上一层找这个键的值拿来用,这个"上一层"的值就是 fallback。


✅ 举个例子

  1. 节点级 yml 配置了:

```yaml

index.number_of_replicas: 2

```

  1. 你创建索引时 没写 `number_of_replicas`:

```json

PUT /my_index

{

"settings": {

"number_of_shards": 3

}

}

```

  • 此时 `my_index` 的 `number_of_replicas` 会自动取节点级的 `2`。

  • 这个 `2` 就是 fallback 值。


✅ 一句话总结

> fallback 就是"如果我没配,就用上级默认值"。

相关推荐
Elasticsearch2 小时前
跳过有状态的 OTel Collector:Elasticsearch 9.5 原生存储两种指标时间类型
elasticsearch
C++、Java和Python的菜鸟10 小时前
第2章 项目前置课-代码版本控制Git
大数据·elasticsearch·搜索引擎
Elasticsearch17 小时前
什么是混合搜索?
elasticsearch
Elasticsearch1 天前
从点击流中提升搜索相关性:使用 Learn To Rank 和 OpenTelemetry 行为信号
elasticsearch
倒流时光三十年1 天前
第六阶段 57 · ES|QL 与 SQL API(用 SQL 查 ES)
数据库·sql·elasticsearch
guwentian1 天前
Git Worktree 实战:用并行多 Agent 把开发提速 N 倍
大数据·git·elasticsearch·wroktree
Elastic 中国社区官方博客2 天前
Elasticsearch:使用 AI Agent 来创建 workflow
大数据·运维·人工智能·elasticsearch·搜索引擎·自动化·全文检索
阿里云大数据AI技术2 天前
AI Search+ES 9.4.X最佳实践:“更快、更准、更安全的企业级搜索引擎”"为AI Agent提供坚实底座”
人工智能·elasticsearch·agent
Elasticsearch2 天前
Elastic 社区通讯 — 2026 年 8 月
elasticsearch
lsh曙光2 天前
ES数据备份与恢复
大数据·elasticsearch·搜索引擎