Start data frame transforms APIedit

Starts one or more data frame transforms.

Warning

This functionality is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features.

Requestedit

POST _data_frame/transforms/<data_frame_transform_id>/_start

Prerequisitesedit

  • If the Elasticsearch security features are enabled, you must have manage_data_frame_transforms cluster privileges to use this API. You must also have view_index_metadata privileges on the source index for the data frame transform. For more information, see Security privileges and Built-in roles.

Descriptionedit

When you start a data frame transform, it creates the destination index if it does not already exist. The number_of_shards is set to 1 and the auto_expand_replicas is set to 0-1.

The transform deduces the mapping definitions from the source indices. For scripted fields, it uses dynamic mappings. If a field in the destination index is created by scripted_metric or bucket_script aggregations, the transform uses dynamic mappings unless a template exists or the destination index already exists. Mapping definitions in the destination index take precedence over dynamic mappings and templates.

When a data frame transform starts, a series of validations occur to ensure its success. However, there are no initial privilege checks. When Elasticsearch security features are enabled, the data frame transform remembers which roles the user that created it had at the time of creation and uses those same roles. If those roles do not have the required privileges on the source and destination indices, the data frame transform fails when it attempts unauthorized operations.

Path parametersedit

<data_frame_transform_id>
(Required, string) Identifier for the data frame transform. This identifier can contain lowercase alphanumeric characters (a-z and 0-9), hyphens, and underscores. It must start and end with alphanumeric characters.

Examplesedit

POST _data_frame/transforms/ecommerce_transform/_start

When the data frame transform starts, you receive the following results:

{
  "acknowledged" : true
}