启动转换 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
。
示例编辑
response = client.transform.start_transform( transform_id: 'ecommerce_transform' ) puts response
POST _transform/ecommerce_transform/_start
转换启动时,您将收到以下结果
{ "acknowledged" : true }