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

Apache Doris 中文参考:DECOMMISSION BACKEND

· 52CE 我爱测

1. 执行此命令后,可以通过SHOW BACKENDS语句查看下线状态( 列的值为 )和下线进度( 列的值会缓慢降到 0) 2. 通常情况下,在 列的值会降到 0 后,此 BE 节点就会被删除,如果您不希望 Doris 自动删除 BE,可以更改 FE Master 的配置 为 false 3. 当前 BE 如果存储的数据量比较大,那么 DECOMMISSION 操作可能持续几个小时甚至是几天 4. 如果 DECOMMISSION 操作的进度卡住不动,具体表现为SHOW BACKENDS语句中的 列一直固定在某个值,那么可能是以下的一些情况: - 当前 BE 上的 tablet 找不到合适的其他 BE 去迁移,比如在一个 3 节点的集

描述

该语句用于将 BE 节点安全地从集群中下线。该操作为异步操作。

语法

ALTER SYSTEM DECOMMISSION 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. 执行此命令后,可以通过SHOW BACKENDS语句查看下线状态(SystemDecommissioned列的值为true)和下线进度(TabletNum列的值会缓慢降到 0)
  2. 通常情况下,在TabletNum列的值会降到 0 后,此 BE 节点就会被删除,如果您不希望 Doris 自动删除 BE,可以更改 FE Master 的配置drop_backend_after_decommission为 false
  3. 当前 BE 如果存储的数据量比较大,那么 DECOMMISSION 操作可能持续几个小时甚至是几天
  4. 如果 DECOMMISSION 操作的进度卡住不动,具体表现为SHOW BACKENDS语句中的TabletNum列一直固定在某个值,那么可能是以下的一些情况:
    • 当前 BE 上的 tablet 找不到合适的其他 BE 去迁移,比如在一个 3 节点的集群有一张 3 副本的表,要下线其中一个节点,那么该节点找不到其他 BE 可用来迁移数据(其他两个 BE 已经各有一个副本了)
    • 当前 BE 上的 tablet 还在回收站中,可以清空回收站后,再等待
    • 当前 BE 上的 tablet 太大,导致在迁移单个 tablet 时,一直因为超时而无法将这个 tablet 迁移走,可以调整 FE Master 的配置max_clone_task_timeout_sec为一个更大的值(默认为 7200 秒)
    • 当前 BE 上的 tablet 存在未完成的事务,可以等事务完成或手动中止事务
    • 其他情况可以在 FE Master 的日志过滤replicas to decommission关键字,找出异常的 tablet,使用SHOW TABLET语句找到该 tablet 所属的表,然后重新建一张新的表,将数据从旧表迁移至新表,最后使用DROP TABLE FORCE的方式将旧表删除掉

示例

  1. 根据 BE 的 Host 和 HeartbeatPort 从集群中安全下线两个节点

    ALTER SYSTEM DECOMMISSION BACKEND "192.168.0.1:9050", "192.168.0.2:9050";
    
  2. 根据 BE 的 ID 从集群中安全下线一个节点

    ALTER SYSTEM DECOMMISSION BACKEND "10002";
    

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

资料来源与适用范围

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

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

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