启动转换 API编辑

启动转换。

请求编辑

POST _transform/<transform_id>/_start

先决条件编辑

需要以下权限

  • 集群:manage_transformtransform_admin 内置角色授予此权限)

描述编辑

启动转换时,如果目标索引不存在,它将创建该索引。 number_of_shards 设置为 1auto_expand_replicas 设置为 0-1

如果是枢轴转换,它会从源索引和转换聚合中推断出目标索引的映射定义。 如果目标索引中的字段来自脚本(如 scripted_metricbucket_script 聚合),则转换使用 动态映射,除非存在索引模板。

如果是最新转换,它不会推断映射定义;它使用动态映射。

要使用显式映射,请在启动转换之前创建目标索引。 或者,您可以创建索引模板,但这不会影响枢轴转换中的推断映射。

转换启动时,会执行一系列验证以确保其成功。 如果您在创建转换时延迟了验证,则它们会在您启动转换时执行,但权限检查除外。 当启用 Elasticsearch 安全功能时,转换会记住创建它时用户的角色,并使用相同的角色。 如果这些角色在源索引和目标索引上没有所需的权限,则转换在尝试执行未经授权的操作时会失败。

路径参数编辑

<transform_id>
(必需,字符串) 转换的标识符。

查询参数编辑

from
(可选,字符串) 将转换的实体集限制为在此时间之后更改的实体。 支持相对时间,例如 now-30d。 仅适用于连续转换。
timeout
(可选,时间) 等待响应的期限。 如果在超时到期之前没有收到响应,则请求失败并返回错误。 默认值为 30s

示例编辑

response = client.transform.start_transform(
  transform_id: 'ecommerce_transform'
)
puts response
POST _transform/ecommerce_transform/_start

转换启动时,您将收到以下结果

{
  "acknowledged" : true
}