原英文版地址: https://www.elastic.co/guide/en/elasticsearch/reference/7.7/transform-settings.html, 原文档版权归 www.elastic.co 所有
本地英文版地址: ../en/transform-settings.html

转换(transform)设置

使用 转换(transform) 不需要配置任何设置。它是默认开启的。

所有这些设置都可以添加到 elasticsearch.yml 配置文件中。 动态设置也可以使用 集群更新设置 API 来更新整个集群。

动态设置优先于 elasticsearch.yml 文件中的设置。

常规转换设置

node.transform

设置为 true 以将节点标识为 转换节点(transform node)。 如果节点的 node.dataxpack.transform.enabledfalse,则该设置默认为 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.enabledtrue。 这是默认行为。 至少,必须在所有符合主节点条件的节点和所有数据节点上启用它。 如果你想在客户端 或 Kibana 中使用转换功能,必须在所有的 协调节点(coordinating node) 上启用它。

xpack.transform.num_transform_failure_retries (动态)
转换遇到非致命错误时重试的次数。 一旦达到重试次数限制,转换任务将被标记为 failed。 默认值为 10,有效最小值为 0,最大值为 100。 如果转换已经在运行,则必须重新启动才能使用更改后的设置。