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

编者荐语：

来自PowerData-海军同学的优秀文章

以下文章来源于数据微光，作者黄海军

[

数据微光 .

数据微光，专注于分享 Apache Doris 的使用指南、实战经验与技术解读。无论新手还是资深用户，这里都有助你深入掌握 Doris 的实用内容。探索数据的微光，共同点亮技术之路！

](#)

在日常运维和管理 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;

往期推荐

[

「FE 倒下了，但我挺住了」—— Doris FE 挂机应急指南

](http://mp.weixin.qq.com/s?__b...

[

从源码到运行：深入解析 Apache Doris 的编译与 Debug 流程

](http://mp.weixin.qq.com/s?__b...

[

成为 Apache 顶级项目贡献者之路：Apache Doris 的语法迁移攻略

](http://mp.weixin.qq.com/s?__b...

【Apache Doris】数据副本问题排查指南