Архивированные настройки

Если вы обновляете кластер с устаревленной постоянной настройкой кластера до версии, которая больше не поддерживает эту настройку, 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, он вернёт ошибку при запуске.

Архивированные настройки индекса не влияют на конфигурацию индекса или большинство операций с индексом, таких как индексирование или поиск. Однако вам необходимо удалить их, прежде чем вы сможете настроить другие параметры для индекса, такие как 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
}