Apache Doris 运维命令 100 条

Apache Doris 是一款面向实时分析场景的 MPP 数据库。它由 FE、BE 等组件组成，数据按照分区、分桶、Tablet 和 Replica 分布在不同节点上。Doris 出现问题时，不能只看一条 SQL 是否走索引，还要检查 FE 元数据、BE 存活状态、Tablet 副本、Compaction、导入任务和磁盘容量。

2026年8月3日阅读—点赞—收藏—

dba100apache墨力计划apache doris

前言

下面整理了 Apache Doris DBA 日常使用频率较高的 100 条命令，覆盖连接、集群节点、数据库对象、分区分桶、Tablet、副本、会话、SQL 性能、数据导入、Compaction、用户权限、备份恢复和服务日志等场景。

本文主要面向当前主流 Apache Doris 版本。不同版本的系统表、HTTP API 和命令参数可能存在差异，执行前应先确认版本和账号权限。文中的 IP、端口、数据库、表、用户和目录均为示例。

涉及节点下线、终止查询、取消任务、删除分区、触发 Compaction、恢复备份和修改配置等操作时，应先确认影响范围。

一、连接与基础信息

1. 使用 MySQL 客户端连接 Doris

Bash

1mysql -h 192.168.1.10 -P 9030 -u root -p

9030 是 FE 默认 MySQL 协议端口，实际端口以 fe.conf 为准。

2. 查看 Doris 版本

SQL

1SELECT VERSION();

3. 查看当前数据库

SQL

1SELECT DATABASE();

4. 查看当前用户

SQL

1SELECT CURRENT_USER();

5. 查看当前时间

SQL

1SELECT
2    NOW(),
3    CURRENT_TIMESTAMP();

6. 查看前端节点

SQL

1SHOW FRONTENDS;

重点关注 Role、IsMaster、Alive、ReplayedJournalId 和 LastHeartbeat。

7. 查看后端节点

SQL

1SHOW BACKENDS;

重点关注 Alive、SystemDecommissioned、TabletNum、磁盘使用率和心跳时间。

8. 查看 Broker

SQL

1SHOW BROKER;

只有使用 Broker Load 或相关外部存储功能时才会配置 Broker。

9. 查看 FE 配置

SQL

1SHOW FRONTEND CONFIG;

10. 查看 BE 配置

SQL

1SHOW BACKEND CONFIG;

二、数据库、表与对象

11. 查看所有数据库

SQL

1SHOW DATABASES;

12. 创建数据库

SQL

1CREATE DATABASE appdb;

13. 切换数据库

SQL

1USE appdb;

14. 查看所有表

SQL

1SHOW TABLES FROM appdb;

15. 查看表结构

SQL

1DESC appdb.orders;

16. 查看完整建表语句

SQL

1SHOW CREATE TABLE appdb.orders;

17. 查看表状态

SQL

1SHOW TABLE STATUS FROM appdb;

18. 查看视图

SQL

1SHOW FULL TABLES FROM appdb
2WHERE Table_type = 'VIEW';

19. 查看物化视图

SQL

1SHOW MATERIALIZED VIEWS FROM appdb;

20. 删除表

SQL

1DROP TABLE appdb.orders_old;

删除前应确认回收站保留策略和备份状态。

三、表模型、分区与分桶

21. 创建 Duplicate Key 表

SQL

1CREATE TABLE appdb.events
2(
3    event_date DATE,
4    user_id BIGINT,
5    event_type VARCHAR(50),
6    event_time DATETIME
7)
8DUPLICATE KEY(event_date, user_id)
9PARTITION BY RANGE(event_date)()
10DISTRIBUTED BY HASH(user_id) BUCKETS 16
11PROPERTIES("replication_num" = "3");

22. 创建 Unique Key 表

SQL

1CREATE TABLE appdb.users
2(
3    user_id BIGINT,
4    user_name VARCHAR(100),
5    update_time DATETIME
6)
7UNIQUE KEY(user_id)
8DISTRIBUTED BY HASH(user_id) BUCKETS 16
9PROPERTIES("replication_num" = "3");

23. 创建 Aggregate Key 表

SQL

1CREATE TABLE appdb.sales_summary
2(
3    sale_date DATE,
4    region_id INT,
5    amount_sum DECIMAL(18,2) SUM
6)
7AGGREGATE KEY(sale_date, region_id)
8DISTRIBUTED BY HASH(region_id) BUCKETS 16
9PROPERTIES("replication_num" = "3");

24. 查看表分区

SQL

1SHOW PARTITIONS FROM appdb.events;

25. 增加分区

SQL

1ALTER TABLE appdb.events
2ADD PARTITION p202607
3VALUES [('2026-07-01'), ('2026-08-01'))
4DISTRIBUTED BY HASH(user_id) BUCKETS 16;

26. 删除分区

SQL

1ALTER TABLE appdb.events
2DROP PARTITION p202601;

删除分区会删除其中的数据，应先确认数据保留要求。

27. 查看动态分区属性

SQL

1SHOW DYNAMIC PARTITION TABLES FROM appdb;

28. 修改副本数量

SQL

1ALTER TABLE appdb.events
2MODIFY PARTITION p202607
3SET ("replication_num" = "3");

29. 查看数据分布

SQL

1SHOW DATA FROM appdb.events;

30. 查看数据库总体数据量

SQL

1SHOW DATA FROM appdb;

四、Tablet 与副本

31. 查看表 Tablet

SQL

1SHOW TABLETS FROM appdb.events;

32. 查看指定 Tablet

SQL

1SHOW TABLET 10001;

33. 通过 PROC 查看 Tablet

SQL

1SHOW PROC '/dbs';

先逐层查看数据库、表、分区和索引 ID，再进入 Tablet 路径。

34. 查看所有 BE

SQL

1SHOW PROC '/backends';

35. 查看前端节点状态

SQL

1SHOW PROC '/frontends';

36. 查看 Tablet 调度任务

SQL

1SHOW PROC '/cluster_balance';

具体 PROC 路径可能随版本变化，可从 SHOW PROC '/' 逐层查看。

37. 查看坏副本

SQL

1SHOW PROC '/statistic';

重点关注不健康 Tablet 和副本统计。

38. 查看副本状态

SQL

1ADMIN SHOW REPLICA STATUS
2FROM appdb.events;

39. 标记副本状态

SQL

1ADMIN SET REPLICA STATUS
2PROPERTIES
3(
4    "tablet_id" = "10001",
5    "backend_id" = "10002",
6    "status" = "bad"
7);

该操作风险较高，只应在明确副本异常并按官方恢复流程处理时执行。

40. 查看 Tablet 调度状态

SQL

1SHOW TABLET FROM appdb.events;

不同版本可能推荐使用 SHOW TABLETS，应以当前版本帮助为准。

五、会话、查询与执行计划

41. 查看当前连接

SQL

1SHOW PROCESSLIST;

42. 查看完整 SQL

SQL

1SHOW FULL PROCESSLIST;

43. 终止连接

SQL

1KILL CONNECTION 12345;

44. 终止查询

SQL

1KILL QUERY 12345;

45. 查看执行计划

SQL

1EXPLAIN
2SELECT *
3FROM appdb.events
4WHERE event_date = '2026-07-27';

46. 查看详细执行计划

SQL

1EXPLAIN VERBOSE
2SELECT *
3FROM appdb.events
4WHERE event_date = '2026-07-27';

47. 查看运行时 Profile

SQL

1SHOW QUERY PROFILE '/';

根据返回的 Query ID 继续查看指定 Profile。

48. 查看指定查询 Profile

SQL

1SHOW QUERY PROFILE '/query_id';

Profile 语法和启用方式可能随版本变化，应结合当前版本文档。

49. 查看查询审计日志

SQL

1SELECT *
2FROM information_schema.active_queries
3ORDER BY query_start_time DESC;

系统表是否存在以及字段名称取决于版本。

50. 查看会话变量

SQL

1SHOW VARIABLES;

六、数据导入与任务

51. 使用 Stream Load 导入 CSV

Bash

1curl --location-trusted \
2  -u loader:password \
3  -H "label:orders_20260727" \
4  -H "column_separator:," \
5  -T orders.csv \
6  http://fe-host:8030/api/appdb/orders/_stream_load

生产环境不要在文章或脚本中保留真实密码。

52. 查看 Load 任务

SQL

1SHOW LOAD FROM appdb;

53. 查看指定 Label 的 Load

SQL

1SHOW LOAD FROM appdb
2WHERE LABEL = 'orders_20260727';

54. 取消 Load

SQL

1CANCEL LOAD
2FROM appdb
3WHERE LABEL = 'orders_20260727';

55. 创建 Routine Load

SQL

1CREATE ROUTINE LOAD appdb.kafka_orders
2ON orders
3COLUMNS TERMINATED BY ","
4PROPERTIES
5(
6    "desired_concurrent_number" = "3",
7    "max_batch_interval" = "10"
8)
9FROM KAFKA
10(
11    "kafka_broker_list" = "kafka1:9092,kafka2:9092",
12    "kafka_topic" = "orders"
13);

56. 查看 Routine Load

SQL

1SHOW ROUTINE LOAD FOR appdb.kafka_orders;

57. 暂停 Routine Load

SQL

1PAUSE ROUTINE LOAD
2FOR appdb.kafka_orders;

58. 恢复 Routine Load

SQL

1RESUME ROUTINE LOAD
2FOR appdb.kafka_orders;

59. 停止 Routine Load

SQL

1STOP ROUTINE LOAD
2FOR appdb.kafka_orders;

停止后不能直接恢复，需要重新创建任务。

60. 查看 Export 任务

SQL

1SHOW EXPORT FROM appdb;

七、Compaction、事务与统计信息

61. 查看事务

SQL

1SHOW TRANSACTION FROM appdb;

62. 查看 Compaction 状态

Bash

1curl -sS \
2  'http://be-host:8040/api/compaction/show?tablet_id=10001'

63. 手工触发 Cumulative Compaction

Bash

1curl -X POST \
2  'http://be-host:8040/api/compaction/run?tablet_id=10001&compact_type=cumulative'

64. 手工触发 Base Compaction

Bash

1curl -X POST \
2  'http://be-host:8040/api/compaction/run?tablet_id=10001&compact_type=base'

手工 Compaction 会消耗 I/O 和 CPU，不应作为日常定时操作。

65. 查看 BE Compaction 配置

SQL

1SHOW BACKEND CONFIG
2LIKE '%compaction%';

66. 查看表统计信息

SQL

1SHOW TABLE STATS appdb.orders;

67. 收集表统计信息

SQL

1ANALYZE TABLE appdb.orders;

68. 查看分析任务

SQL

1SHOW ANALYZE;

69. 查看列统计信息

SQL

1SHOW COLUMN STATS appdb.orders;

70. 修改会话查询超时

SQL

1SET query_timeout = 300;

八、配置、用户与权限

71. 动态修改 FE 配置

SQL

1ADMIN SET FRONTEND CONFIG
2("dynamic_partition_enable" = "true");

只有 SHOW FRONTEND CONFIG 中 IsMutable=true 的参数才能动态修改。

72. 动态修改 BE 配置

SQL

1ADMIN SET BACKEND CONFIG
2("disable_auto_compaction" = "false");

应根据当前版本支持的配置项执行。

73. 查看用户

SQL

1SHOW ALL GRANTS;

74. 创建用户

SQL

1CREATE USER 'appuser'@'%'
2IDENTIFIED BY 'Replace_With_Strong_Password';

75. 修改用户密码

SQL

1SET PASSWORD FOR 'appuser'@'%'
2= PASSWORD('Replace_With_New_Strong_Password');

76. 创建角色

SQL

1CREATE ROLE readonly_role;

77. 授予只读权限

SQL

1GRANT SELECT_PRIV
2ON appdb.*
3TO ROLE readonly_role;

78. 将角色授予用户

SQL

1GRANT readonly_role
2TO 'appuser'@'%';

79. 查看用户授权

SQL

1SHOW GRANTS FOR 'appuser'@'%';

80. 回收权限

SQL

1REVOKE SELECT_PRIV
2ON appdb.*
3FROM ROLE readonly_role;

九、备份、恢复与节点管理

81. 创建备份仓库

SQL

1CREATE REPOSITORY `backup_repo`
2WITH S3
3ON LOCATION "s3://bucket/doris-backup"
4PROPERTIES
5(
6    "AWS_ENDPOINT" = "s3.example.com",
7    "AWS_REGION" = "us-east-1",
8    "AWS_ACCESS_KEY" = "access_key",
9    "AWS_SECRET_KEY" = "secret_key"
10);

凭据应通过安全方式管理，不能直接保存在公开脚本中。

82. 查看备份仓库

SQL

1SHOW REPOSITORIES;

83. 备份数据库

SQL

1BACKUP SNAPSHOT appdb.snapshot_20260727
2TO backup_repo
3PROPERTIES("type" = "full");

84. 查看备份任务

SQL

1SHOW BACKUP FROM appdb;

85. 查看仓库中的快照

SQL

1SHOW SNAPSHOT ON backup_repo;

86. 恢复快照

SQL

1RESTORE SNAPSHOT appdb.snapshot_20260727
2FROM backup_repo
3ON (orders)
4PROPERTIES("backup_timestamp" = "2026-07-27-10-00-00");

时间戳应以 SHOW SNAPSHOT 返回值为准。

87. 查看恢复任务

SQL

1SHOW RESTORE FROM appdb;

88. 添加 BE

SQL

1ALTER SYSTEM ADD BACKEND
2"192.168.1.21:9050";

89. 下线 BE

SQL

1ALTER SYSTEM DECOMMISSION BACKEND
2"192.168.1.21:9050";

应等待数据迁移完成后再删除节点。

90. 添加 Follower FE

SQL

1ALTER SYSTEM ADD FOLLOWER
2"192.168.1.12:9010";

十、服务、日志与巡检

91. 启动 FE

Bash

1bin/start_fe.sh --daemon

92. 停止 FE

Bash

1bin/stop_fe.sh

93. 启动 BE

Bash

1bin/start_be.sh --daemon

94. 停止 BE

Bash

1bin/stop_be.sh

95. 查看 FE 日志

Bash

1tail -200 log/fe.log
2tail -200 log/fe.warn.log

96. 查看 BE 日志

Bash

1tail -200 log/be.INFO
2tail -200 log/be.WARNING

97. 查看进程

Bash

1ps -ef | grep -E '[P]aloFe|[d]oris_be'

98. 查看磁盘和 I/O

Bash

1df -h
2df -i
3iostat -x 1 5

99. 查看 FE 和 BE HTTP 健康状态

Bash

1curl -sS http://fe-host:8030/api/bootstrap
2curl -sS http://be-host:8040/api/health

接口和鉴权要求可能随版本变化。

100. 执行集群快速巡检

SQL

1SHOW FRONTENDS;
2SHOW BACKENDS;
3SHOW BROKER;
4SHOW LOAD;
5SHOW ROUTINE LOAD;
6SHOW TRANSACTION;
7SHOW BACKUP;
8SHOW RESTORE;

正式巡检还应检查 Tablet 副本、数据倾斜、Compaction、磁盘空间、FE/BE 日志和操作系统资源。

结语

Doris 的很多问题最终都会落到四个对象上：FE、BE、Tablet 和任务。FE 负责元数据和调度，BE 负责数据存储和执行，Tablet 决定数据分布和副本状态，Load、Compaction、Schema Change、Backup 等任务则直接影响集群资源。

排查时建议先确认 FE/BE 是否存活，再检查磁盘、Tablet、副本和任务，最后分析 SQL Profile。不要看到查询慢就立即调整并发或手工触发 Compaction，也不要在副本异常时直接删除 BE。

官方资料

Apache Doris 官方文档：https://doris.apache.org/docs/
FE 配置：https://doris.apache.org/docs/admin-manual/config/fe-config/
管理手册：https://doris.apache.org/docs/admin-manual/