Миграция на 8.13
В этом разделе рассматриваются изменения, о которых следует помнить при миграции вашего приложения на Elasticsearch 8.13.
См. также Что нового в 8.17 и Справочные материалы по выпуску.
Поступит в 8.13.0.
Изменения, требующие корректировки
В 8.13 нет изменений, требующих корректировки.
Заметные изменения
Ниже перечислены заметные, но не требующие корректировки обновления, о которых следует знать:
- Изменения в функциях, которые находятся в стадии технического предварительного просмотра.
- Изменения в формате логов.
- Изменения в непубличных API.
- Изменения в работе, исправляющие критические ошибки.
Изменения в настройках индекса
Изменение index.look_ahead_time настройки индекса по умолчанию с 2 часов до 30 минут.
Подробности
Уменьшите значение index.look_ahead_time настройки индекса до 30 минут.
Последствия
Документы с @timestamp, превышающим 30 минут в будущем, будут отклонены. Раньше отклонялись документы с @timestamp, превышающим 2 часа в будущем. Если необходимо сохранить предыдущее поведение, то перед обновлением установите значение настройки index.look_ahead_time в два часа.
Уменьшение look_ahead_time значения максимального значения настройки индекса
Подробности
Уменьшите значение look_ahead_time настройки индекса до 2 часов.
Последствия
Любое значение между 2 часами и 7 днями будет рассматриваться как время предварительного просмотра 2 часа.
Изменения в API REST
ESQL: Синтаксис - FROM METADATA больше не требует []
Подробности
Удалите [ ] для параметра METADATA в операторах FROM.
Последствия
Раньше для возврата полей метаданных требовалось использовать квадратные скобки (например, FROM index [METADATA _index]). Теперь это больше не нужно: скобки [ ] опущены, и их не нужно указывать, упрощая команду до 'FROM index METADATA _index'.
ES|QL: Удаление ключевого слова PROJECT из грамматики
Подробности
Удаление ключевого слова PROJECT (псевдоним KEEP) из грамматики ES|QL
Последствия
До этого изменения пользователи могли использовать PROJECT как псевдоним KEEP в запросах ESQL (например, FROM idx | PROJECT name, surname). Парсер заменял PROJECT на KEEP, выводил предупреждение: Команда PROJECT больше не поддерживается, используйте KEEP вместо неё, и запрос выполнялся нормально. В этом изменении команда PROJECT больше не распознаётся парсером запросов; запросы, использующие команду PROJECT, теперь возвращают исключение при разборе.
[ESQL] Удаление is_nan, is_finite и is_infinite
Подробности
Удаление функций is_nan, is_finite и is_infinite.
Последствия
Попытка использовать эти функции теперь будет приводить к ошибке планировщика. Эти функции больше не поддерживаются.
Устаревшие функции
Следующие функции устарели в Elasticsearch 8.13 и будут удалены в будущей версии. Хотя это не повлияет на ваши приложения сразу, мы настоятельно рекомендуем обновить свой код после обновления до 8.13.
Чтобы узнать, используете ли вы устаревшие функции, включите ведение журнала устаревших функций.
Устаревшие настройки кластера и узла
Устаревший client.type
Подробности
Настройка узла client.type игнорировалась с момента удаления клиентского узла в 8.0. Теперь эта настройка устарела и будет удалена в будущей версии.
Последствия
Удалите настройку client.type из elasticsearch.yml
Устаревшие API REST
DesiredNode: устаревший node_version поле и сделайте его необязательным для текущей версии
Подробности
API desired_node включает поле node_version для выполнения проверки на необходимую новую версию узла. Такая проверка слишком общая, и лучше выполнять её внешней логикой, поэтому она была удалена, сделав поле node_version необязательным. Это поле будет удалено в более поздней версии.
Последствия
Пользователи должны обновить своё использование desired_node, чтобы больше не включать поле node_version.
© 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/8.17/migrating-8.13.html
