大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:MODIFY BACKEND

· 52CE 我爱测

该语句用于修改 BE 节点属性,修改 BE 节点属性后,会影响到当前的节点的查询、写入和数据分布。以下是支持修改的属性:

描述

该语句用于修改 BE 节点属性,修改 BE 节点属性后,会影响到当前的节点的查询、写入和数据分布。以下是支持修改的属性:

属性 影响
tag.location BE 的标签名,默认值为default。修改后,会影响到同一标签组内的 BE 数据均衡,以及在建表时,数据分布的 BE 节点。更多信息可参考Resource Group
disable_query 是否禁用查询,默认为false。设置为true后,将不会再有新的查询请求规划到这台 BE 节点上。
disable_load 是否禁用导入,默认为false。设置为true后,将不会再有新的导入请求规划到这台 BE 节点上。

存算分离模式暂不支持此命令。

语法

ALTER SYSTEM MODIFY BACKEND <be_identifier> [, <be_identifier> [...] ]
SET (
     "<key>" = "<value>"
)

其中:

be_identifier
  : "<be_host>:<be_heartbeat_port>"
  | "<backend_id>"

必选参数

1. <be_host>

可以是 BE 节点的主机名或 IP 地址

2. <heartbeat_port>

BE 节点的心跳端口,默认为 9050

3. <backend_id>

BE 节点的 ID

<be_host>、<be_heartbeat_port>及<backend_id>均可通过SHOW BACKENDS语句查询获得。

权限控制

执行此 SQL 命令的用户必须至少具有以下权限:

权限 对象 说明
NODE_PRIV

注意事项

由于此操作是针对整个 BE 级别的,影响面较广,如果操作不慎,可能会影响到整个集群的正常查询、导入甚至是建表操作。请谨慎操作。

示例

  1. 修改 BE 的资源标签
ALTER SYSTEM MODIFY BACKEND "127.0.0.1:9050" SET ("tag.location" = "group_a");
  1. 修改 BE 的查询禁用属性
ALTER SYSTEM MODIFY BACKEND "10002" SET ("disable_query" = "true");
  1. 修改 BE 的导入禁用属性
ALTER SYSTEM MODIFY BACKEND "127.0.0.1:9050" SET ("disable_load" = "true");

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。