ADD BACKEND
描述
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 |
注意事项
- 在添加新的 BE 节点之前，确保节点已正确配置并运行。
- 使用Resource Group可以帮助您更好地管理和组织集群中的 BE 节点。
- 添加多个 BE 节点时，可以在一个命令中指定它们，以提高效率。
- 添加 BE 节点后，使用
SHOW BACKENDS命令验证它们是否已成功添加并处于正常状态。 - 考虑在不同的物理位置或机架上添加 BE 节点，以提高集群的可用性和容错能力。
- 定期检查和平衡集群中的负载，确保新添加的 BE 节点得到适当利用。
示例
-
不带附加属性添加 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 未指定附加属性，因此将应用默认设置。
-
存算一体模式下，添加指定资源组的 BE
ALTER SYSTEM ADD BACKEND "doris-be01:9050" PROPERTIES ("tag.location" = "groupb");此命令将单个 BE 节点（主机名 doris-be01，端口 9050）添加到集群中的资源组
groupb。 -
存算分离模式下，添加指定计算组的 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。 -
在复杂网络环境下，添加配置了公网和私网端点的 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 实践。
