Spec-Zone.ru › Elasticsearch 7
›Руководство по Elasticsearch [7.17] ›Руководство по миграции

Изменения в 7.8

В этом разделе обсуждаются изменения, о которых необходимо знать при миграции вашего приложения в Elasticsearch 7.8.

См. также Что нового в 7.17 и Заметки к выпуску.

  • Изменения лицензионной информации
  • Изменения агрегаций
  • Изменения отображений
  • Изменения настроек

Изменения лицензионной информации

Начиная с 7.8.1 релиза

Отображение корпоративной лицензии как Платиновой в /_xpack

Подробности Конечная точка GET /_license по умолчанию отображает корпоративные лицензии как Платиновые, чтобы старые клиенты (включая Beats, Kibana и Logstash) понимали, что этот новый тип лицензии следует интерпретировать как Платиновую лицензию.

Этот слой совместимости не был применён к конечной точке GET /_xpack/, которая также отображает тип и режим лицензии. #58217

Изменения агрегаций

Привилегия indices:admin/create больше не позволит автоматически создавать индексы

Подробности Привилегия с именем indices:admin/create больше не позволит автоматически создавать индексы. Используйте create_index вместо этого. #55858

value_count оптимизация агрегаций

Подробности Скрипты, используемые в value_count, теперь будут получать число, если они подсчитывают числовое поле, и GeoPoint, если они подсчитывают geo_point поля. Раньше они всегда получали String представление этих значений. #54854

Изменения отображений

Параметр отображения enabled не может быть изменён для корневого отображения.

Подробности
Запросы отображения, которые пытаются изменить параметр отображения enabled для корневого отображения, завершатся ошибкой.

Ранее Elasticsearch принимал запросы отображения, которые пытались изменить параметр enabled корневого отображения. Эти изменения не применялись, но такие запросы не возвращали ошибки.

Воздействие
Чтобы избежать ошибок, не отправляйте запросы отображения, изменяющие параметр отображения enabled.

Параметры отображения include_in_parent и include_in_root не могут быть изменены для полей nested.

Подробности
Запросы отображения, которые пытаются изменить параметр отображения include_in_parent или include_in_root для поля nested, завершатся ошибкой.

Ранее Elasticsearch принимал запросы отображения, которые пытались изменить параметр include_in_parent или include_in_root. Эти изменения не применялись, но такие запросы не возвращали ошибки.

Воздействие
Чтобы избежать ошибок, не отправляйте запросы отображения, изменяющие параметр отображения include_in_parent или include_in_root.

Параметр запроса local API отображения поля get устарел.

Подробности
Параметр запроса local API отображения поля get устарел и будет удалён в Elasticsearch 8.0.0.

Параметр local является бесполезным. API всегда получает отображения полей локально.

Воздействие
Чтобы избежать предупреждений об устаревании, прекратите использование параметра local.

Изменения настроек

Настройка node.local_storage устарела.

Подробности
Настройка node.local_storage устарела. В Elasticsearch 8.0.0 все узлы требуют локального хранилища.

Воздействие
Чтобы избежать предупреждений об устаревании, прекратите использование настройки node.local_storage.

Несколько настроек X-Pack больше не имеют эффекта и устарели.

Подробности
Базовые функции лицензии X-Pack всегда включены для дистрибутива по умолчанию, и следующие настройки больше не имеют эффекта:

  • xpack.enrich.enabled
  • xpack.flattened.enabled
  • xpack.ilm.enabled
  • xpack.monitoring.enabled
  • xpack.rollup.enabled
  • xpack.slm.enabled
  • xpack.sql.enabled
  • xpack.transform.enabled
  • xpack.vectors.enabled

Ранее их можно было установить в false, чтобы отключить API функций в кластере.

Воздействие
Чтобы избежать предупреждений об устаревании, прекратите использование этих настроек. Если вы отключили ILM, чтобы использовать другой инструмент для управления индексами Watcher, новую настройку xpack.watcher.use_ilm_index_management можно установить в false.

Изменения встроенных пользователей

Пользователь kibana устарел в пользу пользователя kibana_system.

Подробности
Пользователь kibana исторически использовался для аутентификации Kibana с Elasticsearch. Название этого пользователя было запутанным и часто ошибочно использовалось для входа в Kibana. Мы заменили пользователя kibana на пользователя kibana_system, чтобы уменьшить путаницу и лучше согласовать с другими встроенными системными учётными записями.

Воздействие
Если ваш kibana.yml содержал:

elasticsearch.username: kibana

то вам следует обновить на использование нового пользователя kibana_system:

elasticsearch.username: kibana_system

Новый пользователь kibana_system не сохраняет предыдущий пароль пользователя kibana. Вы должны явно установить пароль для пользователя kibana_system.

Изменения встроенных ролей

Роль kibana_user устарела в пользу роли kibana_admin.

Подробности
Пользователи, которым ранее была назначена роль kibana_user, должны вместо этого получить роль kibana_admin. Эта роль предоставляет тот же набор привилегий, что и kibana_user, но была переименована, чтобы лучше отразить её предназначение.

Воздействие
Назначьте пользователям с ролью kibana_user роль kibana_admin. Прекратите использование роли kibana_user.

Изменения в координации кластера

Путь запроса API исключений конфигурации голосования POST _cluster/voting_config_exclusions/<node_name> устарел.

Подробности
Путь запроса API исключений конфигурации голосования POST _cluster/voting_config_exclusions/<node_name> теперь устарел. Для добавления исключения конфигурации голосования укажите имена узлов или идентификаторы узлов с помощью параметра запроса вместо этого:

  • POST _cluster/voting_config_exclusions?node_names=<node_names>
  • POST _cluster/voting_config_exclusions?node_ids=<node_ids>

Воздействие
Чтобы избежать предупреждений об устаревании, прекратите использование пути запроса POST _cluster/voting_config_exclusions/<node_name>.

Изменения преобразований

Свойство max_page_search_size устарело в объекте конфигурации преобразования pivot

Подробности
Свойство max_page_search_size в pivot устарело в API создания преобразования и предварительного просмотра преобразования.

Воздействие
Используйте свойство max_page_search_size в settings вместо этого.

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/breaking-changes-7.8.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API