已归档设置

编辑

如果您将具有已弃用持久性集群设置的集群升级到不再支持该设置的版本,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
}