› ›

Миграция на 7.12

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

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

Существенные изменения

Следующие изменения в Elasticsearch 7.12 могут повлиять на ваши приложения и помешать их нормальной работе. Перед обновлением до 7.12 ознакомьтесь с этими изменениями и выполните описанные шаги, чтобы смягчить последствия.

Существенные изменения, внесенные в версии с пометкой «minor», обычно ограничиваются вопросами безопасности и исправлениями ошибок. Значительные изменения поведения устаревают в версии с пометкой «minor», и старое поведение поддерживается до следующей версии с пометкой «major». Чтобы узнать, используете ли вы устаревшие функции, включите ведение журнала устаревших функций.

Изменения в движке

Слияния по требованию для замороженных и доступных для поиска снимков индексов завершатся ошибкой, если требуется слияние.

Подробности
В более ранних версиях слияние по требованию для замороженного индекса или индекса с доступным для поиска снимком неправильно возвращало успешный ответ без выполнения запрошенного слияния. Эта ошибка исправлена в версии 7.12: начиная с этой версии слияние по требованию для этих неизменяемых индексов завершится ошибкой, если запрошенное слияние не является пустым.

Изменения в поиске

Параметр fields API поиска возвращает поля внутри полей nested, сгруппированных вместе.

Подробности
В более ранних версиях поля, извлеченные с помощью fields в API поиска, возвращались как плоский список. Начиная с версии 7.12, поля внутри объекта, который отображается с помощью типа поля nested, группируются вместе для сохранения независимости каждого объекта внутри исходного вложенного массива.

Изменения в SSL/TLS

TLSv1.1 и TLSv1.0 отключены в интегрированной JDK

Подробности
Начиная с Elasticsearch 7.12.1, при использовании интегрированной JDK TLSv1.1 и TLSv1.0 отключены по умолчанию. Это может повлиять на SSL-соединения с API Rest для некоторых устаревших клиентов. Это также может повлиять на исходящие соединения, такие как веб-хуки Watcher, аутентификацию LDAP или доступ к репозиториям снимков.

Большинство развертываний Elasticsearch не будут затронуты этим изменением, так как у этих устаревших версий TLS известны уязвимости и они больше не используются.

Инструкции по включению этих более старых версий TLS в ваш кластер Elasticsearch см. в разделе Включение дополнительных версий SSL/TLS в вашей JDK.

Устаревшие функции

Следующие функции устарели в Elasticsearch 7.12 и будут удалены в 8.0. Хотя это не окажет немедленного влияния на ваши приложения, мы настоятельно рекомендуем обновить свой код после обновления до 7.12.

Значительные изменения в поведении устаревают в версии с пометкой «minor», и старое поведение поддерживается до следующей версии с пометкой «major». Чтобы узнать, используете ли вы устаревшие функции, включите ведение журнала устаревших функций.

Устаревшие настройки

Настройка xpack.searchable.snapshot.shared_cache.size для узлов, не находящихся в состоянии «замороженный», устарела.

Подробности
Настройка xpack.searchable.snapshot.shared_cache.size с положительным значением на узле без роли data_frozen теперь устарела.

Настройка узла xpack.searchable.snapshot.shared_cache.size резервирует место для общего кэша, используемого частично смонтированными индексами с доступным для поиска снимком. Elasticsearch выделяет частично смонтированные индексы только узлам с ролью data_frozen.

Последствия
Чтобы избежать предупреждений об устаревании, прекратите использование настройки на узлах, не находящихся в состоянии «замороженный».

© 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/migrating-7.12.html