已归档的设置

编辑

如果您将具有已弃用持久集群设置的集群升级到不再支持该设置的版本,Elasticsearch 会自动归档该设置。 类似地,如果您升级的集群包含具有不支持的索引设置的索引,Elasticsearch 会归档该索引设置。

我们建议您在升级后删除任何已归档的设置。已归档的设置被认为是无效的,并且会干扰您配置其他设置的能力。

已归档的设置以 archived. 前缀开头。

已归档的集群设置

编辑

使用以下 集群更新设置 请求来检查已归档的集群设置。 如果请求返回一个空对象 ({ }),则表示没有已归档的集群设置。

resp = client.cluster.get_settings(
    flat_settings=True,
    filter_path="persistent.archived*",
)
print(resp)
response = client.cluster.get_settings(
  flat_settings: true,
  filter_path: 'persistent.archived*'
)
puts response
const response = await client.cluster.getSettings({
  flat_settings: "true",
  filter_path: "persistent.archived*",
});
console.log(response);
GET _cluster/settings?flat_settings=true&filter_path=persistent.archived*

要删除任何已归档的集群设置,请使用以下 集群更新设置 请求。

resp = client.cluster.put_settings(
    persistent={
        "archived.*": None
    },
)
print(resp)
response = client.cluster.put_settings(
  body: {
    persistent: {
      "archived.*": nil
    }
  }
)
puts response
const response = await client.cluster.putSettings({
  persistent: {
    "archived.*": null,
  },
});
console.log(response);
PUT _cluster/settings
{
  "persistent": {
    "archived.*": null
  }
}

Elasticsearch 不会归档瞬态集群设置或 elasticsearch.yml 中的设置。 如果节点在 elasticsearch.yml 中包含不支持的设置,它将在启动时返回错误。

已归档的索引设置

编辑

在升级之前,请从索引和组件模板中删除任何不支持的索引设置。 Elasticsearch 在升级期间不会归档模板中不支持的索引设置。 尝试使用包含不支持的索引设置的模板将失败并返回错误。 这包括自动化操作,例如 ILM 滚动操作。

已归档的索引设置不会影响索引的配置或大多数索引操作,例如索引或搜索。 但是,您需要先删除它们,然后才能为索引配置其他设置,例如 index.hidden

使用以下 获取索引设置 请求来获取具有已归档设置的索引列表。 如果请求返回一个空对象 ({ }),则表示没有已归档的索引设置。

resp = client.indices.get_settings(
    index="*",
    flat_settings=True,
    filter_path="**.settings.archived*",
)
print(resp)
response = client.indices.get_settings(
  index: '*',
  flat_settings: true,
  filter_path: '**.settings.archived*'
)
puts response
const response = await client.indices.getSettings({
  index: "*",
  flat_settings: "true",
  filter_path: "**.settings.archived*",
});
console.log(response);
GET */_settings?flat_settings=true&filter_path=**.settings.archived*

要删除任何已归档的索引设置,请使用以下 更新索引设置 请求。

resp = client.indices.put_settings(
    index="my-index",
    settings={
        "archived.*": None
    },
)
print(resp)
response = client.indices.put_settings(
  index: 'my-index',
  body: {
    "archived.*": nil
  }
)
puts response
const response = await client.indices.putSettings({
  index: "my-index",
  settings: {
    "archived.*": null,
  },
});
console.log(response);
PUT /my-index/_settings
{
  "archived.*": null
}