启动转换 API
编辑启动转换 API
编辑启动一个转换。
请求
编辑POST _transform/<transform_id>/_start
描述
编辑当你启动一个转换时,它会创建目标索引(如果该索引尚不存在)。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 }