【建议收藏】Apache Doris 常用命令速查手册

数据微光 2025-01-20

161

在日常运维和管理 Apache Doris 集群的过程中，熟练掌握数据管理命令不仅能显著提升操作效率，还能助你迅速定位并解决潜在问题，从而增强系统的稳定性。本文精心整理了 Apache Doris 中的一系列关键命令和结果示例，为你的数据库管理工作提供强有力的支持。为了方便查阅与使用，文末特别附录了所有提及的命令，供你一键收藏。

特别提示：本文所述命令内容基于 Apache Doris 2.1.7 版本，部分命令可能在早期版本不支持。

一、集群状态监控

查看 FRONTEND(FE) 状态：

SHOW FRONTENDS\G;

查看 BACKEND(BE) 状态：

SHOW BACKENDS\G;

查看 Doris 版本：

SELECT @@VERSION_COMMENT;

查看集群副本状态：

SHOW PROC "/cluster_health/tablet_health"\G;

查看不健康副本：

SHOW REPLICA STATUS FROM tbl1 WHERE STATUS != "OK";

正常结果显示为空

如果结果不为空，可参考数据副本问题排查指南。

二、集群配置管理

显示系统变量：

SHOW VARIABLES;

可配合 like 进行检索，Changed 为 1 表示变量被修改过了。

设置系统变量（如全局打开 profile）：

SET GLOBAL enable_profile = TRUE;

查看 FE 配置项：

ADMIN SHOW FRONTEND CONFIG LIKE '%check_java_version%';

设置 FE 配置项（如允许最长表名长度）：

ADMIN SET FRONTEND CONFIG ("table_name_length_limit" = "128");

三、副本与分布管理

查看副本状态：

ADMIN SHOW REPLICA STATUS FROM db.table;

可配合下面命令一起使用

SHOW REPLICA STATUS FROM tbl1 WHERE STATUS != "OK";

查看副本分布：

ADMIN SHOW REPLICA DISTRIBUTION FROM db.table;

如果是多个 BE，会以图形化的方式展示每个 BE 上副本数的分布情况

查看表的副本数：

SELECT * FROM information_schema.table_properties WHERE PROPERTY_NAME LIKE '%replication_allocation%';

四、表与分区管理

查看表的所有 tablets：

SHOW TABLETS FROM db.table;

查看表的所有分区：

SHOW PARTITIONS FROM db.table;

查看特定分区的 tablets：

SHOW TABLETS FROM db.table PARTITION(PartitionName);

查询特定分区的数据：

SELECT * FROM db.table PARTITION(PartitionName);

查询特定 tablet 的数据：

SELECT * FROM db.table TABLET(tablet_id);

五、数据管理与优化

查看数据倾斜情况：

SHOW DATA SKEW FROM table_name PARTITION(partition_name);

查看库数据大小和 tablet 信息：

SHOW DATA;

六、回收站与垃圾数据清理

展示回收站元数据：

SHOW CATALOG RECYCLE BIN;

设置回收站过期时间（如设置为 0）：

ADMIN SET FRONTEND CONFIG ("catalog_trash_expire_second" = "0");

清理垃圾数据：

ADMIN CLEAN TRASH;

恢复回收站默认过期时间（如 1 天）：

ADMIN SET FRONTEND CONFIG ("catalog_trash_expire_second" = "86400");

七、物化视图与任务管理

查看物化视图 job：

SELECT * FROM jobs("type"="mv");

查看特定物化视图的 Task 状态：

SELECT * FROM tasks("type"="mv") WHERE mvName = 'mv_name' ORDER BY CreateTime DESC \G;

八、其他实用命令

查看 table_id 和 be_id：

SELECT * FROM information_schema.metadata_name_ids;

查看 schema change 进度（如 BloomFilter等）：

SHOW ALTER TABLE COLUMN;

设置中文列名支持：

SET GLOBAL enable_unicode_name_support = TRUE;

附录

一、集群状态监控

-- 查看 FE 状态：
SHOW FRONTENDS\G;
-- 查看 BE 状态：
SHOW BACKENDS\G;
-- 查看 Doris 版本：
SELECT @@VERSION_COMMENT;
-- 查看集群副本状态：
SHOW PROC "/cluster_health/tablet_health";
-- 查看不健康副本：
SHOW REPLICA STATUSFROM tbl1 WHERESTATUS != "OK"; 

二、集群配置管理

-- 显示系统变量：
SHOWVARIABLES;
-- 设置系统变量（如全局打开 profile）：
SETGLOBAL enable_profile = TRUE;
-- 查看 FE 配置项：
  ADMIN SHOW FRONTEND CONFIG LIKE'%check_java_version%';
-- 设置 FE 配置项（如允许最长表名长度）：
  ADMIN SET FRONTEND CONFIG ("table_name_length_limit" = "128"); 

三、副本与分布管理

-- 查看副本状态：
  ADMIN SHOW REPLICA STATUSFROM db.table;
-- 查看副本分布：
  ADMIN SHOW REPLICA DISTRIBUTION FROM db.table;
-- 查看表的副本数：
SELECT * FROM information_schema.table_properties WHERE PROPERTY_NAME LIKE'%replication_allocation%'; 

四、表与分区管理

-- 查看表的所有 tablets：
SHOW TABLETS FROM db.table;
-- 查看特定分区的 tablets：
SHOW TABLETS FROM db.table PARTITION(p20241025);
-- 查看表的所有分区：
SHOWPARTITIONSFROM db.table;
-- 查询特定分区的数据：
SELECT * FROM db.table PARTITION(p20241025);
-- 查询特定 tablet 的数据：
SELECT * FROM db.table TABLET(tablet_id); 

五、数据管理与优化

-- 查看数据倾斜情况：
SHOWDATA SKEW FROM table_name PARTITION(partition_name);
-- 查看库数据大小和 tablet 信息：
SHOWDATA; 

六、回收站与垃圾数据清理

-- 展示回收站元数据：
SHOWCATALOGRECYCLEBIN;
-- 设置回收站过期时间（如设置为 0）：
  ADMIN SET FRONTEND CONFIG ("catalog_trash_expire_second" = "0");
-- 清理垃圾数据：
  ADMIN CLEAN TRASH;
-- 恢复回收站默认过期时间（如 1 天）：
  ADMIN SET FRONTEND CONFIG ("catalog_trash_expire_second" = "86400");

七、物化视图与任务管理

-- 查看物化视图 job：
SELECT * FROM jobs("type"="mv");
-- 查看特定物化视图的 Task 状态：
SELECT * FROM tasks("type"="mv") WHERE mvName = 'mv_name'ORDERBY CreateTime DESC \G; 

八、其他实用命令

-- 查看 table_id 和 be_id：
SELECT * FROM information_schema.metadata_name_ids;
-- 查看 schema change 进度（如 BloomFilter等）：
SHOWALTERTABLECOLUMN;
-- 设置中文列名支持：
SETGLOBAL enable_unicode_name_support = TRUE;