启动转换 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

示例

编辑
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
}