Миграция на 8.1
В этом разделе обсуждаются изменения, которые необходимо учитывать при миграции вашего приложения на Elasticsearch 8.1.
См. также Что нового в 8.17 и Справочные материалы по выпуску.
Изменения в работе
Следующие изменения в Elasticsearch 8.1 могут повлиять на ваши приложения и помешать их нормальной работе. Перед обновлением до версии 8.1 ознакомьтесь с этими изменениями и выполните описанные шаги для минимизации последствий.
Изменения в REST API
Параметр API поиска fields теперь нормализует геометрические объекты, пересекающие международную дату
Подробности
Параметр API поиска fields теперь нормализует объекты geo_shape, пересекающие международную дату (+/-180° долготы). Например, если многоугольник пересекает дату, параметр fields возвращает его как два многоугольника. Вы по-прежнему можете получить исходные, ненормализованные геометрические объекты из _source.
Последствия
Если ваше приложение требует ненормализованных геометрических объектов, получите их из _source, а не используя параметр fields.
Устаревшие функции
Следующие функции устарели в Elasticsearch 8.1 и будут удалены в будущей версии. Хотя это не окажет немедленного влияния на ваши приложения, мы настоятельно рекомендуем выполнить описанные шаги по обновлению вашего кода после обновления до 8.1.
Чтобы узнать, используете ли вы какие-либо устаревшие функции, включите ведение журнала устаревших функций.
Устаревшие параметры кластера и узла
Устарели устаревшие значения для параметра discovery.type
Подробности
Устаревшие значения параметра discovery.type устарели и будут запрещены в будущей версии.
Последствия
Не устанавливайте discovery.type ни на какое значение, кроме single-node или multi-node. Все остальные значения эквивалентны типу обнаружения по умолчанию, который является multi-node. По возможности опустите этот параметр, чтобы Elasticsearch использовал тип обнаружения по умолчанию.
Устаревшие функции REST API
Устарело мягкое разбор действий массового выполнения
Подробности
Более ранние версии Elasticsearch очень мягко обрабатывали строки действий в запросах массового выполнения и молча игнорировали недопустимые или некорректно сформированные действия. Эта мягкость устарела, и будущая версия отклонит запросы массового выполнения, содержащие недопустимые действия.
Последствия
Убедитесь, что действия массового выполнения являются правильно сформированными объектами JSON, содержащими один элемент с правильным ключом.
Устарел параметр запроса index_include_frozen в API _sql
Подробности
После устаревания замороженных индексов параметр index_include_frozen и синтаксис FROZEN также устарели.
Последствия
Вы должны разморозить замороженные индексы, используя API разморозки индекса и перестать использовать параметр index_include_frozen или ключевое слово FROZEN в запросах SQL. В некоторых случаях замороженный уровень может быть подходящей заменой для замороженных индексов. Подробнее об уровнях данных см. уровни данных.
© 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.1.html
