› › ›

API обновления трансформаций

Обновляет все трансформации.

Запрос

POST _transform/_upgrade

Предварительные условия

Требуются следующие разрешения:

cluster: manage_transform (роль transform_admin предоставляет это разрешение)

Описание

Трансформации совместимы между младшими версиями и поддерживаемыми версиями. Однако со временем формат информации о конфигурации трансформации может изменяться. Этот API определяет трансформации, имеющие устаревший формат конфигурации, и обновляет их до последней версии, включая очистку внутренних структур данных, хранящих состояние и контрольные точки трансформации. Обновление трансформации не влияет на исходные и целевые индексы.

Если этап обновления трансформации завершается ошибкой, обновление останавливается, и возвращается ошибка об основной проблеме. Исправьте проблему, а затем запустите процесс снова. После завершения обновления возвращается сводка.

Для обеспечения непрерывной работы трансформаций во время обновления кластера до основной версии (например, с 7.16 до 8.0) рекомендуется обновить трансформации перед обновлением кластера. Перед обновлением рекомендуется выполнить резервное копирование кластера.

При включенных функциях безопасности Elasticsearch, ваша трансформация запоминает роли пользователя, который её последним создал или обновил. В отличие от API обновления трансформации, обновление трансформации не изменяет сохранённые роли, поэтому роль, используемая для чтения исходных данных и записи в целевой индекс, остаётся неизменной.

Параметры запроса

dry_run: (Необязательно, булево) При значении `true` проверяет наличие обновлений, но не выполняет их. По умолчанию `false`.
timeout: (Необязательно, время) Время ожидания ответа. Если ответ не получен до истечения времени ожидания, запрос завершается ошибкой. По умолчанию 30s.

Тело ответа

needs_update: (целое число) Количество трансформаций, которые необходимо обновить.
no_action: (целое число) Количество трансформаций, которые не требуют обновления.
updated: (целое число) Количество трансформаций, которые были обновлены.

Примеры

Для обновления устаревших трансформаций до последнего формата конфигурации выполните следующий API-запрос:

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/7.17/upgrade-transforms.html