Spec-Zone.ru › Elasticsearch 7
›Elasticsearch Guide [7.17] ›REST API ›Transform API

API запуска трансформации

Запускает трансформацию.

Запрос

POST _transform/<transform_id>/_start

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

Требуются следующие привилегии:

  • cluster: manage_transform (роль transform_admin предоставляет эту привилегию)
  • индексы источника: read, view_index_metadata.

Описание

При запуске трансформации, если целевой индекс не существует, он создаётся. number_of_shards устанавливается в значение 1, а auto_expand_replicas устанавливается в значение 0-1.

Если это трансформация-pivot, она определяет определения схемы для целевого индекса из индексов источника и агрегаций трансформации. Если поля в целевом индексе получены из скриптов (например, в случае агрегаций scripted_metric или bucket_script), трансформация использует динамические схемы, если шаблон индекса не существует.

Если это трансформация-latest, она не определяет определения схемы, а использует динамические схемы.

Для использования явных схем создайте целевой индекс перед запуском трансформации. В качестве альтернативы, вы можете создать шаблон индекса, хотя это не повлияет на выведенные схемы в трансформации-pivot.

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

Параметры пути

<transform_id>
(Обязательный, строка) Идентификатор трансформации.

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

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

Примеры

POST _transform/ecommerce_transform/_start

При запуске трансформации вы получаете следующие результаты:

{
  "acknowledged" : true
}

© 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/start-transform.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API