【Elasticsearch】settings

发布于:2025-07-22 ⋅ 阅读:(13) ⋅ 点赞:(0)

通过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

```

 

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

 

```json

PUT /my_index

{

  "settings": {

    "number_of_shards": 3

  }

}

```

 

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

- 这个 `2` 就是 fallback 值。

 

---

 

✅ 一句话总结

 

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


网站公告

今日签到

点亮在社区的每一天
去签到