DROP BACKEND

描述

该语句用于将 BE 节点从 Doris 集群中删除。

语法

ALTER SYSTEM DROP BACKEND "<be_identifier>" [, "<be_identifier>" ... ]

其中：

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

注意事项

1. 不推荐使用该命令下线 BE，该命令会直接将 BE 直接从集群中删去，当前节点的数据并不会负载均衡到其他 BE 节点，如果集群存在单副本的表，那么就有可能出现数据丢失的情况。更好的做法是使用DECOMMISSION BACKEND命令优雅下线 BE。
2. 由于此操作是高危操作，因此当直接运行此命令时：

   ALTER SYSTEM DROP BACKEND "127.0.0.1:9050";

   ERROR 1105 (HY000): errCode = 2, detailMessage = It is highly NOT RECOMMENDED to use DROP BACKEND stmt.It is not safe to directly drop a backend. All data on this backend will be discarded permanently. If you insist, use DROPP instead of DROP
   会出现以上提示信息，如果您明白您当前所做的事情，可将DROP关键字替换成DROPP，并继续下去：

   ALTER SYSTEM DROPP BACKEND "127.0.0.1:9050";

示例

1. 根据 BE 的 Host 和 HeartbeatPort 从集群中删除两个节点

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

2. 根据 BE 的 ID 从集群中删除一个节点

   ALTER SYSTEM DROPP BACKEND "10002";