API обновления трансформаций
Обновляет все трансформации.
Запрос
POST _transform/_upgrade
Предварительные условия
Требуются следующие привилегии:
- cluster:
manage_transform(рольtransform_adminпредоставляет эту привилегию)
Описание
Трансформации совместимы между младшими версиями и поддерживаемыми версиями основных версий. Однако со временем формат конфигурации трансформации может измениться. Этот API определяет трансформации, имеющие устаревший формат конфигурации, и обновляет их до последней версии, включая очистку внутренних структур данных, хранящих состояние и контрольные точки трансформации. Обновление трансформации не влияет на исходные и целевые индексы.
С Elasticsearch 8.10.0 используется новый номер версии для отслеживания изменений конфигурации и состояния плагина трансформации. Этот новый номер версии не связан с версией продукта и будет увеличиваться независимо.
Если шаг обновления трансформации завершается ошибкой, обновление останавливается, и возвращается ошибка об основной проблеме. Исправьте проблему, а затем запустите процесс снова. При завершении обновления возвращается сводка.
Для обеспечения непрерывной работы трансформаций во время обновления кластера до основной версии — например, с 7.16 до 8.0 — рекомендуется обновить трансформации перед обновлением кластера. Возможно, вам потребуется выполнить резервное копирование кластера перед обновлением.
- Если включены функции безопасности Elasticsearch, ваша трансформация запоминает роли пользователя, который последний раз её создал или обновил. В отличие от обновления трансформации, обновление трансформации не изменяет сохраненные роли, поэтому роль, используемая для чтения исходных данных и записи в целевой индекс, остаётся неизменной.
Параметры запроса
-
dry_run - (Необязательно, логический тип) Если значение
true, то проверяет только обновления, но не выполняет их. По умолчаниюfalse. -
timeout - (Необязательно, время) Срок ожидания ответа. Если ответ не получен до истечения срока ожидания, запрос завершается ошибкой. По умолчанию
30s.
Тело ответа
-
needs_update - (целое число) Количество трансформаций, требующих обновления.
-
no_action - (целое число) Количество трансформаций, не требующих обновления.
-
updated - (целое число) Количество обновленных трансформаций.
Примеры
Для обновления устаревших трансформаций до последнего формата конфигурации выполните следующий API-запрос:
resp = client.transform.upgrade_transforms() print(resp)
response = client.transform.upgrade_transforms puts response
const response = await client.transform.upgradeTransforms(); console.log(response);
POST _transform/_upgrade
При обновлении всех трансформаций вы получите сводку:
{
"needs_update": 0,
"updated": 2,
"no_action": 1
}
© 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/upgrade-transforms.html