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

Apache Doris 中文参考:ADD BACKEND

· 52CE 我爱测

ADD BACKEND 命令用于向 Doris 集群中添加一个或多个 BE 节点。此命令允许管理员指定新 BE 节点的主机和端口,以及可选的属性来配置它们的行为。

描述

ADD BACKEND 命令用于向 Doris 集群中添加一个或多个 BE 节点。此命令允许管理员指定新 BE 节点的主机和端口,以及可选的属性来配置它们的行为。

语法

ALTER SYSTEM ADD BACKEND "<host>:<heartbeat_port>"[,"<host>:<heartbeat_port>"...] [PROPERTIES ("<key>"="<value>" [, ...] )]

必选参数

1. <host>

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

2. <heartbeat_port>

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

可选参数

1. PROPERTIES ("key"="value", ...)

一组键值对,用于定义 BE 节点的附加属性。这些属性可用于自定义正在添加的 BE 的配置。可用属性包括:

  • tag.location:存算一体模式下用于指定 BE 节点所属的资源组。
  • tag.compute_group_name:存算分离模式下用于指定 BE 节点所属的计算组。
  • tag.public_endpoint:用于指定 BE 节点的公网端点,供外部访问使用(如 11.10.20.12:8010)。通常是负载均衡器的域名或公网 IP,用于外部用户访问。
  • tag.private_endpoint:用于指定 BE 节点的私网端点,供私有网络访问使用(如 10.10.10.9:8020)。通常用于 VPC 内部访问或 Kubernetes 集群内的 Service IP。

权限控制

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

权限 对象 说明
NODE_PRIV

注意事项

  1. 在添加新的 BE 节点之前,确保节点已正确配置并运行。
  2. 使用Resource Group可以帮助您更好地管理和组织集群中的 BE 节点。
  3. 添加多个 BE 节点时,可以在一个命令中指定它们,以提高效率。
  4. 添加 BE 节点后,使用SHOW BACKENDS命令验证它们是否已成功添加并处于正常状态。
  5. 考虑在不同的物理位置或机架上添加 BE 节点,以提高集群的可用性和容错能力。
  6. 定期检查和平衡集群中的负载,确保新添加的 BE 节点得到适当利用。

示例

  1. 不带附加属性添加 BE

    ALTER SYSTEM ADD BACKEND "192.168.0.1:9050,192.168.0.2:9050";
    

    此命令向集群添加两个 BE 节点:

    • 192.168.0.1,端口 9050
    • 192.168.0.2,端口 9050 未指定附加属性,因此将应用默认设置。
  2. 存算一体模式下,添加指定资源组的 BE

    ALTER SYSTEM ADD BACKEND "doris-be01:9050" PROPERTIES ("tag.location" = "groupb");
    

    此命令将单个 BE 节点(主机名 doris-be01,端口 9050)添加到集群中的资源组groupb。

  3. 存算分离模式下,添加指定计算组的 BE

    ALTER SYSTEM ADD BACKEND "192.168.0.3:9050" PROPERTIES ("tag.compute_group_name" = "cloud_groupc");
    

    此命令将单个 BE 节点(IP 192.168.0.3,端口 9050)添加到集群中的计算组cloud_groupc。

  4. 在复杂网络环境下,添加配置了公网和私网端点的 BE 节点

    ALTER SYSTEM ADD BACKEND "192.168.1.1:9050" PROPERTIES (
        "tag.public_endpoint" = "11.10.20.12:8010",
        "tag.private_endpoint" = "10.10.10.9:8020"
    );
    

    此命令添加一个具有多个网络端点的 BE 节点:

    • 192.168.1.1:9050:用于集群内部通信的内部地址(be_host)
    • 11.10.20.12:8010:公网端点,用于外部用户通过负载均衡器访问
    • 10.10.10.9:8020:私网端点,用于 VPC 内部或 Kubernetes 跨集群访问

    此配置在云环境或 Kubernetes 集群中非常有用,BE 节点需要从不同的网络环境进行访问。详情请参阅复杂网络环境下的 Stream Load 实践。

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

资料来源与适用范围

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

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

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