本地英文版地址: ../en/transform-settings.html
使用 转换(transform) 不需要配置任何设置。它是默认开启的。
所有这些设置都可以添加到 elasticsearch.yml
配置文件中。
动态设置也可以使用 集群更新设置 API 来更新整个集群。
动态设置优先于 elasticsearch.yml
文件中的设置。
常规转换设置
-
node.transform
-
设置为
true
以将节点标识为 转换节点(transform node)。 如果节点的node.data
或xpack.transform.enabled
是false
,则该设置默认为false
; 否则,默认值为true
。如果在
elasticsearch.yml
配置文件中设置为false
, 该该节点无法运行 转换。 如果设置为true
,但是xpack.transform.enabled
被设置为false
,则node.transform
设置会被忽略,这也意味着该该节点无法运行 转换。 如果要运行转换,集群中必须且至少要有一个转换节点。建议使用
node.transform
设置将转换的执行限制在某些节点上,而不是使用xpack.transform.enabled
。 在专用的协调节点或专用的主节点上,禁用 node.transform 角色。 -
xpack.transform.enabled
-
设置为
true
(默认值) 以在节点上启用转换。如果在
elasticsearch.yml
中设置为false
,则该节点上的 转换API 会被禁用。 因此,该节点不能启动或管理转换,也不能接收与 转换API 相关的传输(内部的)通信请求。 如果该节点是 协调节点(coordinating node),来自客户端(包括Kibana)的转换请求也会失败。如果你想在集群中使用转换功能,推荐在所有节点上设置
xpack.transform.enabled
为true
。 这是默认行为。 至少,必须在所有符合主节点条件的节点和所有数据节点上启用它。 如果你想在客户端 或 Kibana 中使用转换功能,必须在所有的 协调节点(coordinating node) 上启用它。 -
xpack.transform.num_transform_failure_retries
(动态) -
转换遇到非致命错误时重试的次数。
一旦达到重试次数限制,转换任务将被标记为
failed
。 默认值为10
,有效最小值为0
,最大值为100
。 如果转换已经在运行,则必须重新启动才能使用更改后的设置。