Apache Doris 表值函数 BACKENDS() 详解

概述

在 Apache Doris 分布式数据库系统中，BACKENDS() 是一个非常重要的表值函数（Table-Valued Function），它能够生成一个临时表，展示当前 Doris 集群中所有后端节点（Backend，简称 BE）的详细信息。通过这个函数，管理员可以全面监控集群中各个 BE 节点的运行状态、资源使用情况等重要指标。

函数语法

BACKENDS()

权限要求

使用该函数需要具备 ADMIN_PRIV 全局权限，这是为了确保只有管理员能够查看集群节点信息，保障系统安全。

返回字段详解

BACKENDS() 函数返回的临时表包含多个字段，每个字段都反映了 BE 节点的不同方面信息：

节点基本信息

• BackendId：BE 节点的唯一标识符
• Host：BE 节点的主机名或 IP 地址
• NodeRole：节点角色，如 mix 表示该节点同时处理存储和查询

端口信息

• HeartbeatPort：心跳检测端口
• BePort：BE 节点与集群通信的端口
• HttpPort：HTTP 服务端口
• BrpcPort：BRPC 通信端口
• ArrowFlightSqlPort：Arrow Flight SQL 端口（用于高性能数据传输）

状态信息

• LastStartTime：节点最后一次启动时间
• LastHeartbeat：最后一次收到心跳的时间
• Alive：节点是否存活（true/false）
• SystemDecommissioned：节点是否已被停用
• HeartbeatFailureCounter：心跳失败计数器

存储信息

• TabletNum：管理的 tablet 数量
• DataUsedCapacity：已使用的磁盘空间（MB）
• TrashUsedCapacity：回收站占用的空间（MB）
• AvailCapacity：可用磁盘空间
• TotalCapacity：总磁盘容量
• UsedPct：磁盘使用百分比
• MaxDiskUsedPct：所有 tablet 中的最大磁盘使用率
• RemoteUsedCapacity：远程存储使用的空间

资源信息

• CpuCores：CPU 核心数
• Memory：内存大小

其他信息

• Tag：节点标签（如位置信息）
• ErrMsg：错误信息
• Version：BE 节点版本
• Status：详细状态信息（包括 tablet 报告、加载时间、查询状态等）

使用示例

查看集群中所有 BE 节点的信息：

SELECT * FROM backends();

典型返回结果示例：

+-----------+-----------+---------------+--------+----------+----------+--------------------+---------------------+---------------------+-------+----------------------+-----------+------------------+-------------------+---------------+---------------+---------+----------------+--------------------+--------------------------+--------+-------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------+----------+----------+-----------+
| BackendId | Host      | HeartbeatPort | BePort | HttpPort | BrpcPort | ArrowFlightSqlPort | LastStartTime       | LastHeartbeat       | Alive | SystemDecommissioned | TabletNum | DataUsedCapacity | TrashUsedCapacity | AvailCapacity | TotalCapacity | UsedPct | MaxDiskUsedPct | RemoteUsedCapacity | Tag                      | ErrMsg | Version                 | Status                                                                                                                                                                                                                 | HeartbeatFailureCounter | NodeRole | CpuCores | Memory    |
+-----------+-----------+---------------+--------+----------+----------+--------------------+---------------------+---------------------+-------+----------------------+-----------+------------------+-------------------+---------------+---------------+---------+----------------+--------------------+--------------------------+--------+-------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------+----------+----------+-----------+
| 10020     | 10.xx.xx.90 | 9050          | 9060   | 8040     | 8060     | -1               | 2025-01-13 14:11:31 | 2025-01-16 13:24:55 | true  | false                | 359       | 295.328 MB       | 0.000             | 231.236 GB    | 3.437 TB      | 93.43 % | 93.43 %        | 0.000              | {"location" : "default"} |        | doris-0.0.0--83f899b32b | {"lastSuccessReportTabletsTime":"2025-01-16 13:24:07","lastStreamLoadTime":1737004982210,"isQueryDisabled":false,"isLoadDisabled":false,"isActive":true,"currentFragmentNum":0,"lastFragmentUpdateTime":1737004982195} | 0                       | mix      | 96       | 375.81 GB |
+-----------+-----------+---------------+--------+----------+----------+--------------------+---------------------+---------------------+-------+----------------------+-----------+------------------+-------------------+---------------+---------------+---------+----------------+--------------------+--------------------------+--------+-------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------+----------+----------+-----------+

实际应用场景

1. 集群监控：定期检查 BE 节点的存活状态和资源使用情况
2. 容量规划：通过磁盘使用率预测何时需要扩容
3. 故障排查：当查询性能下降时，检查各节点的负载情况
4. 均衡检查：确保 tablet 在各节点间分布均匀
5. 版本管理：统一集群中各节点的版本

最佳实践

1. 可以结合 WHERE 子句筛选特定状态的节点：

   SELECT * FROM backends() WHERE Alive = false;
   

2. 监控磁盘使用率高的节点：

   SELECT BackendId, Host, UsedPct FROM backends() WHERE UsedPct > 90;
   

3. 查看各节点的 tablet 分布情况：

   SELECT BackendId, Host, TabletNum FROM backends() ORDER BY TabletNum DESC;
   

注意事项

1. 该函数会访问系统元数据，频繁调用可能会对集群性能产生轻微影响
2. 在生产环境中，建议通过监控系统定期采集这些指标，而不是频繁手动查询
3. 当发现节点异常时（如 Alive=false），应及时检查节点日志和系统资源

通过 BACKENDS() 表值函数，Apache Doris 为管理员提供了强大的集群监控能力，是维护分布式数据库健康运行的重要工具。