Запуск API трансформации
Запускает трансформацию.
Запрос
POST _transform/<transform_id>/_start
Предварительные условия
Требуются следующие привилегии:
- cluster:
manage_transform(рольtransform_adminпредоставляет эту привилегию)
Описание
При запуске трансформации создаётся целевой индекс, если он ещё не существует. number_of_shards устанавливается в 1, а auto_expand_replicas устанавливается в 0-1.
Если это трансформация агрегации, то определения отображения целевого индекса выводятся из исходных индексов и агрегаций трансформации. Если поля в целевом индексе получены из скриптов (как в случае с агрегациями scripted_metric или bucket_script), трансформация использует динамические отображения, если шаблон индекса не существует.
Если это трансформация последнего состояния, определения отображения не выводятся; используется динамическое отображение.
Чтобы использовать явные отображения, создайте целевой индекс перед запуском трансформации. Альтернативно, вы можете создать шаблон индекса, хотя это не влияет на выводимые отображения в трансформации агрегации.
При запуске трансформации происходит ряд проверок для обеспечения её успешного выполнения. Если проверка была отложена при создании трансформации, она выполняется при её запуске — за исключением проверок привилегий. При включенных функциях безопасности Elasticsearch трансформация сохраняет роли пользователя, который её создал, и использует те же самые роли. Если у этих ролей нет необходимых привилегий для исходных и целевых индексов, трансформация завершается неудачно при попытке несанкционированных операций.
Параметры пути
-
<transform_id> - (Обязательно, строка) Идентификатор трансформации.
Параметры запроса
-
from - (Необязательно, строка) Ограничивает набор преобразованных сущностей теми, которые изменились после указанного времени. Поддерживаются относительные временные интервалы, такие как now-30d. Применимо только к непрерывным трансформациям.
-
timeout - (Необязательно, время) Время ожидания ответа. Если ответ не получен до истечения таймаута, запрос завершается неудачно и возвращает ошибку. По умолчанию
30s.
Примеры
resp = client.transform.start_transform(
transform_id="ecommerce_transform",
)
print(resp) response = client.transform.start_transform( transform_id: 'ecommerce_transform' ) puts response
const response = await client.transform.startTransform({
transform_id: "ecommerce_transform",
});
console.log(response); 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/8.17/start-transform.html