Doris 功能介绍-Proc 系统

ApacheDoris 2021-05-07

2057

## Proc 系统

Proc 系统是 Doris 的一个比较有特色的功能。使用过 Linux 的同学可能比较了解这个概念。在 Linux 系统中，proc 是一个虚拟的文件系统，通常挂载在 proc 目录下。用户可以通过这个文件系统来查看系统内部的数据结构。比如可以通过 proc/pid 查看指定 pid 进程的详细情况。

和 Linux 中的 proc 系统类似，Doris 中的 proc 系统也被组织成一个类似目录的结构，根据用户指定的“目录路径（proc 路径）”，来查看不同的系统信息。

proc 系统被设计为主要面向系统管理人员，方便其查看系统内部的一些运行状态。如表的tablet状态、集群均衡状态、各种作业的状态等等。是一个非常实用的功能。

### 查看 Proc 系统

Doris 中有两种方式可以查看 proc 系统。

通过 SHOW PROC 命令

mysql> show proc "/";
+---------------------------+
| name                      |
+---------------------------+
| statistic                 |
| brokers                   |
| frontends                 |
| routine_loads             |
| auth                      |
| jobs                      |
| resources                 |
| monitor                   |
| transactions              |
| colocation_group          |
| backends                  |
| cluster_balance           |
| current_queries           |
| dbs                       |
| load_error_hub            |
| current_backend_instances |
| tasks                     |
+---------------------------+
17 rows in set (0.00 sec)

mysql> show proc "/dbs";
+-------+------------------------------------+----------+-------------+--------------------------+--------------+
| DbId  | DbName                             | TableNum | Quota       | LastConsistencyCheckTime | ReplicaQuota |
+-------+------------------------------------+----------+-------------+--------------------------+--------------+
| 0     | default_cluster:information_schema | 17       | 1024.000 GB | NULL                     | 1073741824   |
| 10003 | default_cluster:db1                | 3        | 1024.000 GB | NULL                     | 1073741824   |
| 10013 | default_cluster:doris_audit_db__   | 1        | 1024.000 GB | NULL                     | 1073741824   |
+-------+------------------------------------+----------+-------------+--------------------------+--------------+
3 rows in set (0.00 sec)

通过 MySQL 客户端连接 Doris 后，可以执行 SHOW PROC 语句查看指定 proc 目录的信息。proc 目录是以 "/" 开头的绝对路径。

show proc 语句的结果以二维表的形式展现。而通常结果表的第一列的值为 proc 的下一级子目录。如 "/dbs" 展示所有数据库，而 "/dbs/10003" 展示 id 为 10003 的数据库下的所有表。

mysql> show proc "/dbs";
+-------+------------------------------------+----------+-------------+--------------------------+--------------+
| DbId  | DbName                             | TableNum | Quota       | LastConsistencyCheckTime | ReplicaQuota |
+-------+------------------------------------+----------+-------------+--------------------------+--------------+
| 0     | default_cluster:information_schema | 17       | 1024.000 GB | NULL                     | 1073741824   |
| 10003 | default_cluster:db1                | 3        | 1024.000 GB | NULL                     | 1073741824   |
| 10013 | default_cluster:doris_audit_db__   | 1        | 1024.000 GB | NULL                     | 1073741824   |
+-------+------------------------------------+----------+-------------+--------------------------+--------------+
3 rows in set (0.00 sec)

mysql> show proc "/dbs/10003";
+---------+-----------+----------+---------------------+--------------+--------+------+--------------------------+--------------+
| TableId | TableName | IndexNum | PartitionColumnName | PartitionNum | State  | Type | LastConsistencyCheckTime | ReplicaCount |
+---------+-----------+----------+---------------------+--------------+--------+------+--------------------------+--------------+
| 10063   | tbl1      | 1        | NULL                | 1            | NORMAL | OLAP | NULL                     | 1            |
| 10069   | tbl2      | 1        | k2                  | 2            | NORMAL | OLAP | NULL                     | 2            |
| 11007   | tbl3      | 1        | k1                  | 2            | NORMAL | OLAP | NULL                     | 2            |
+---------+-----------+----------+---------------------+--------------+--------+------+--------------------------+--------------+
3 rows in set (0.00 sec)