メインコンテンツまでスキップ

SHOW PROC

説明​

Procシステムは、Dorisのユニークな機能です。Linuxを使用したことがある学生は、この概念をよりよく理解できるでしょう。Linuxシステムでは、procは仮想ファイルシステムで、通常/procディレクトリにマウントされています。ユーザーは、このファイルシステムを通してシステムの内部データ構造を表示できます。例えば、/proc/pidを通して指定されたpidプロセスの詳細を表示できます。

Linuxのprocシステムと同様に、Dorisのprocシステムも、ユーザーが指定した「ディレクトリパス（procパス）」に従って異なるシステム情報を表示するために、ディレクトリのような構造に編成されています。

procシステムは主にシステム管理者のために設計されており、システム内部の実行状態を表示するのに便利です。テーブルのtabletステータス、クラスタバランスステータス、様々なジョブのステータスなどです。これは非常に有用な機能です。

Dorisでprocシステムを表示するには、2つの方法があります。

  1. DorisによってプロバイドされるWEB UIインターフェースを通して表示する。アドレスにアクセス：http://FE_IP:FE_HTTP_PORT
  2. もう一つの方法はコマンドによる方法です

DorisでサポートされているすべてのPROCコマンドはSHOW PROC "/";を通して確認できます。

MySQLクライアントを通してDorisに接続した後、SHOW PROC文を実行して指定されたprocディレクトリの情報を表示できます。procディレクトリは、"/"で始まる絶対パスです。

show proc文の結果は二次元テーブルで表示されます。そして通常、結果テーブルの最初の列はprocの次のサブディレクトリです。

mysql> show proc "/";
+---------------------------+
| name                      |
+---------------------------+
| auth                      |
| backends                  |
| bdbje                     |
| brokers                   |
| catalogs                  |
| cluster_balance           |
| cluster_health            |
| colocation_group          |
| current_backend_instances |
| current_queries           |
| current_query_stmts       |
| dbs                       |
| diagnose                  |
| frontends                 |
| jobs                      |
| load_error_hub            |
| monitor                   |
| resources                 |
| routine_loads             |
| statistic                 |
| stream_loads              |
| tasks                     |
| transactions              |
| trash                     |
+---------------------------+
23 rows in set (0.00 sec)

illustrate:

  1. auth: ユーザー名と対応する権限情報
  2. backends: クラスター内のBEのノードリストを表示、SHOW BACKENDSと同等
  3. bdbje: bdbjeデータベースリストを表示するには、fe.confファイルを変更してenable_bdbje_debug_mode=trueを追加し、sh start_fe.sh --daemonでFEを起動してdebugモードに入る必要があります。debugモードに入ると、http serverとMySQLServerのみが起動され、BDBJEインスタンスが開かれますが、メタデータの読み込みやその後の起動プロセスには入りません。
  4. binlog: binlog関連情報を表示。binlogレコード数、binlogサイズ（バイト）、binlog時間範囲などの情報を含みます。
  5. brokers : クラスターbrokerノード情報を表示、SHOW BROKERと同等
  6. catalogs : 現在作成されているデータcatalogを表示、SHOW CATALOGSと同等
  7. cluster_balance : クラスターのバランスを確認するには、Data Copy Managementを参照してください
  8. cluster_health: SHOW PROC '/cluster_health/tablet_health';文を実行してクラスター全体のレプリカ状態を表示します。
  9. colocation_group : このコマンドでクラスター内の既存のGroup情報を表示できます。詳細については、Colocation Joinの章を参照してください
  10. current_backend_instances : 現在ジョブを実行しているbeノードのリストを表示
  11. current_queries : 実行中のクエリリスト、現在実行中のSQL文を表示。
  12. current_query_stmts: 現在実行中のクエリを返します。
  13. dbs: 主にDorisクラスター内の各データベースとテーブルのメタデータ情報を表示するために使用されます。この情報には、テーブル構造、パーティション、マテリアライズドビュー、データシャードとレプリカなどが含まれます。このディレクトリとそのサブディレクトリを通じて、クラスター内のテーブルメタデータを明確に表示し、データスキュー、レプリカ障害などの問題を特定できます。
  14. diagnose: クラスター内の一般的な管理制御の問題を報告・診断します。レプリカのバランスと移行、トランザクション異常などが含まれます。
  15. frontends: クラスター内のすべてのFEノード情報を表示。IPアドレス、ロール、ステータス、マスターかどうかなどを含み、SHOW FRONTENDSと同等
  16. jobs: すべての種類のジョブの統計を表示。特定のdbIdが指定された場合は、そのデータベースの統計データを返します。dbIdが-1の場合は、すべてのデータベースの総統計データを返します
  17. load_error_hub: Dorisはロードジョブで生成されたエラー情報をerror hubに集中保存することをサポートしています。その後、SHOW LOAD WARNINGS;文でエラーメッセージを直接表示できます。ここにはerror hubの設定情報が表示されます。
  18. monitor : FE JVMのリソース使用量を表示
  19. resources : システムリソースを表示。一般アカウントはUSAGE_PRIV権限を持つリソースのみ表示できます。rootとadminアカウントのみがすべてのリソースを表示できます。SHOW RESOURCESと同等
  20. routine_loads: すべてのroutine loadジョブ情報を表示。ジョブ名、ステータスなどを含みます。
  21. statistics: 主にDorisクラスター内のデータベース、テーブル、パーティション、シャード、レプリカの数を要約・表示するために使用されます。また、不健全なコピーの数も表示されます。この情報は、クラスターのメタ情報のサイズを全体的に制御するのに役立ちます。全体的な視点からクラスターのシャーディング状況を表示し、クラスターシャーディングの健全性を迅速にチェックできます。これにより、問題のあるデータシャードをさらに特定できます。
  22. stream_loads: 実行中のstream loadタスクを返します。
  23. tasks : 様々なジョブの総タスク数と失敗数を表示。
  24. transactions : 指定されたトランザクションidのトランザクション詳細を表示するために使用、SHOW TRANSACTIONと同等
  25. trash: この文はbackend内のガベージデータが占める容量を表示するために使用されます。SHOW TRASHと同等

詳細説明​

  1. /binlog

BinlogはDorisの重要な機能で、データ変更を記録し、クラスター間データ同期（CCR）などのシナリオに使用できます。このコマンドにより、管理者はBinlogのステータスを監視し、正常な動作を確保し、ストレージ容量を合理的に計画できます。

Field NameData TypeDescription
NameStringデータベース名またはテーブル名
TypeStringデータオブジェクトのタイプ、値は"db"（データベース）または"table"（テーブル）
IdNumberDatabase IDまたはTable ID
DroppedBooleanデータベースまたはテーブルが削除されているかどうか。値が"true"の場合はオブジェクトがDorisから削除されているが、そのBinlogレコードはまだ保持されていることを示す；値が"false"の場合はオブジェクトがシステムにまだ存在することを示す。データベースやテーブルが削除されても、システムはTTLが期限切れになるか手動でクリーンアップされるまで、Binlogレコードを一定期間保持する
BinlogLengthNumberこのデータベースまたはテーブルのバイナリログエントリの総数
BinlogSizeNumberバイナリログの総サイズ（バイト）
FirstBinlogCommittedTimeNumber最初のバイナリログコミットのタイムスタンプ（Unixタイムスタンプ、ミリ秒）
ReadableFirstBinlogCommittedTimeString最初のバイナリログのコミット時刻（可読形式）
LastBinlogCommittedTimeNumber最後のバイナリログコミットのタイムスタンプ（Unixタイムスタンプ、ミリ秒）
ReadableLastBinlogCommittedTimeString最後のバイナリログのコミット時刻（可読形式）
BinlogTtlSecondsNumberバイナリログの生存時間（秒）、この時間を超えるとログがクリーンアップされる可能性がある
BinlogMaxBytesNumberバイナリログの最大サイズ（バイト）、このサイズを超えるとクリーンアップがトリガーされる可能性がある
BinlogMaxHistoryNumsNumber保持するバイナリログ履歴レコードの最大数、この数を超えるとクリーンアップがトリガーされる可能性がある

注意事項：

  • バイナリログが有効になっているデータベースとテーブルのみがこのコマンドの出力に表示される
  • データベースレベルのバイナリログが有効になっている場合は、データベースのバイナリログ情報が表示される；そうでない場合は、そのデータベース内でバイナリログが有効になっている個別テーブルの情報が表示される

Example​

  1. 例えば、"/dbs"はすべてのデータベースを表示し、"/dbs/10002"はid 10002のデータベース配下のすべてのテーブルを表示します

    mysql> show proc "/dbs/10002";
    +---------+----------------------+----------+---------------------+--------------+--------+------+--------------------------+--------------+
    | TableId | TableName            | IndexNum | PartitionColumnName | PartitionNum | State  | Type | LastConsistencyCheckTime | ReplicaCount |
    +---------+----------------------+----------+---------------------+--------------+--------+------+--------------------------+--------------+
    | 10065   | dwd_product_live     | 1        | dt                  | 9            | NORMAL | OLAP | NULL                     | 18           |
    | 10109   | ODS_MR_BILL_COSTS_DO | 1        | NULL                | 1            | NORMAL | OLAP | NULL                     | 1            |
    | 10119   | test                 | 1        | NULL                | 1            | NORMAL | OLAP | NULL                     | 1            |
    | 10124   | test_parquet_import  | 1        | NULL                | 1            | NORMAL | OLAP | NULL                     | 1            |
    +---------+----------------------+----------+---------------------+--------------+--------+------+--------------------------+--------------+
    4 rows in set (0.00 sec)

  2. クラスター内のすべてのデータベーステーブル数に関する情報を表示します。

    mysql> show proc '/statistic';
    +-------+----------------------+----------+--------------+----------+-----------+------------+
    | DbId  | DbName               | TableNum | PartitionNum | IndexNum | TabletNum | ReplicaNum |
    +-------+----------------------+----------+--------------+----------+-----------+------------+
    | 10002 | default_cluster:test | 4        | 12           | 12       | 21        | 21         |
    | Total | 1                    | 4        | 12           | 12       | 21        | 21         |
    +-------+----------------------+----------+--------------+----------+-----------+------------+
    2 rows in set (0.00 sec)

  3. 以下のコマンドでクラスタ内の既存のGroup情報を確認できます。

    SHOW PROC '/colocation_group';

    +-------------+--------------+--------------+------------+----------------+----------+----------+
    | GroupId     | GroupName    | TableIds     | BucketsNum | ReplicationNum | DistCols | IsStable |
    +-------------+--------------+--------------+------------+----------------+----------+----------+
    | 10005.10008 | 10005_group1 | 10007, 10040 | 10         | 3              | int(11)  | true     |
    +-------------+--------------+--------------+------------+----------------+----------+----------+
  • GroupId: グループのクラスター全体における一意識別子。前半はdb id、後半はgroup idです。
    • GroupName: Groupの完全名。
    • TabletIds: このGroupに含まれるTableのidリスト。
    • BucketsNum: バケット数。
    • ReplicationNum: レプリカ数。
    • DistCols: 分散列、つまりバケット列タイプ。
    • IsStable: Groupが安定しているかどうか（安定性の定義については、Colocation replica balance and repairセクションを参照してください）。

  1. 以下のコマンドを使用して、Groupのデータ分散をさらに詳しく確認します：

    SHOW PROC '/colocation_group/10005.10008';

    +-------------+---------------------+
    | BucketIndex | BackendIds          |
    +-------------+---------------------+
    | 0           | 10004, 10002, 10001 |
    | 1           | 10003, 10002, 10004 |
    | 2           | 10002, 10004, 10001 |
    | 3           | 10003, 10002, 10004 |
    | 4           | 10002, 10004, 10003 |
    | 5           | 10003, 10002, 10001 |
    | 6           | 10003, 10004, 10001 |
    | 7           | 10003, 10004, 10002 |
    +-------------+---------------------+
  • BucketIndex: バケットシーケンスのインデックス。
    • BackendIds: バケット内のデータシャードが配置されているBEノードIDのリスト。

  1. 各種ジョブのタスクの総数と失敗数を表示する。

    mysql> show proc '/tasks';
    +-------------------------+-----------+----------+
    | TaskType                | FailedNum | TotalNum |
    +-------------------------+-----------+----------+
    | CREATE                  | 0         | 0        |
    | DROP                    | 0         | 0        |
    | PUSH                    | 0         | 0        |
    | CLONE                   | 0         | 0        |
    | STORAGE_MEDIUM_MIGRATE  | 0         | 0        |
    | ROLLUP                  | 0         | 0        |
    | SCHEMA_CHANGE           | 0         | 0        |
    | CANCEL_DELETE           | 0         | 0        |
    | MAKE_SNAPSHOT           | 0         | 0        |
    | RELEASE_SNAPSHOT        | 0         | 0        |
    | CHECK_CONSISTENCY       | 0         | 0        |
    | UPLOAD                  | 0         | 0        |
    | DOWNLOAD                | 0         | 0        |
    | CLEAR_REMOTE_FILE       | 0         | 0        |
    | MOVE                    | 0         | 0        |
    | REALTIME_PUSH           | 0         | 0        |
    | PUBLISH_VERSION         | 0         | 0        |
    | CLEAR_ALTER_TASK        | 0         | 0        |
    | CLEAR_TRANSACTION_TASK  | 0         | 0        |
    | RECOVER_TABLET          | 0         | 0        |
    | STREAM_LOAD             | 0         | 0        |
    | UPDATE_TABLET_META_INFO | 0         | 0        |
    | ALTER                   | 0         | 0        |
    | INSTALL_PLUGIN          | 0         | 0        |
    | UNINSTALL_PLUGIN        | 0         | 0        |
    | Total                   | 0         | 0        |
    +-------------------------+-----------+----------+
    26 rows in set (0.01 sec)

  2. クラスター全体のレプリカステータスを表示します。

    mysql> show proc '/cluster_health/tablet_health';
    +----------+---------------------------+-----------+------------+-------------------+----------------------+----------------------+--------------+----------------------------+-------------------------+-------------------+---------------------+----------------------+----------------------+------------------+-----------------------------+-----------------+-------------+------------+
    | DbId     | DbName                    | TabletNum | HealthyNum | ReplicaMissingNum | VersionIncompleteNum | ReplicaRelocatingNum | RedundantNum | ReplicaMissingInClusterNum | ReplicaMissingForTagNum | ForceRedundantNum | ColocateMismatchNum | ColocateRedundantNum | NeedFurtherRepairNum | UnrecoverableNum | ReplicaCompactionTooSlowNum | InconsistentNum | OversizeNum | CloningNum |
    +----------+---------------------------+-----------+------------+-------------------+----------------------+----------------------+--------------+----------------------------+-------------------------+-------------------+---------------------+----------------------+----------------------+------------------+-----------------------------+-----------------+-------------+------------+
    | 25852112 | default_cluster:bowen     | 1920      | 1920       | 0                 | 0                    | 0                    | 0            | 0                          | 0                       | 0                 | 0                   | 0                    | 0                    | 0                | 0                           | 0               | 0           | 0          |
    | 25342914 | default_cluster:bw        | 128       | 128        | 0                 | 0                    | 0                    | 0            | 0                          | 0                       | 0                 | 0                   | 0                    | 0                    | 0                | 0                           | 0               | 0           | 0          |
    | 2575532  | default_cluster:cps       | 1440      | 1440       | 0                 | 0                    | 0                    | 0            | 0                          | 0                       | 0                 | 0                   | 0                    | 0                    | 0                | 0                           | 0               | 16          | 0          |
    | 26150325 | default_cluster:db        | 38374     | 38374      | 0                 | 0                    | 0                    | 0            | 0                          | 0                       | 0                 | 0                   | 0                    | 0                    | 0                | 0                           | 0               | 453         | 0          |
    +----------+---------------------------+-----------+------------+-------------------+----------------------+----------------------+--------------+----------------------------+-------------------------+-------------------+---------------------+----------------------+----------------------+------------------+-----------------------------+-----------------+-------------+------------+
    4 rows in set (0.01 sec)

DbIdが25852112などのデータベース配下でレプリカステータスを表示します。

mysql> show proc '/cluster_health/tablet_health/25852112';

  1. クラスター管理の問題の報告と診断

    MySQL > show proc "/diagnose";
    +-----------------+----------+------------+
    | Item            | ErrorNum | WarningNum |
    +-----------------+----------+------------+
    | cluster_balance | 2        | 0          |
    | Total           | 2        | 0          |
    +-----------------+----------+------------+

    2 rows in set

レプリカバランス移行の問題を表示する

```sql
MySQL > show proc "/diagnose/cluster_balance";
+-----------------------+--------+-------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------+------------+
| Item                  | Status | Content                                                                                                     | Detail Cmd                                                          | Suggestion |
+-----------------------+--------+-------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------+------------+
| Tablet Health         | ERROR  | healthy tablet num 691 < total tablet num 1014                                                              | show 	proc "/cluster_health/tablet_health";                          | <null>     |
| BeLoad Balance        | ERROR  | backend load not balance for tag {"location" : "default"}, low load backends [], high load backends 	[10009] | show proc "/cluster_balance/cluster_load_stat/location_default/HDD" | <null>     |
| Disk Balance          | OK     | <null>                                                                                                      | <null>                                                              | <null>     |
| Colocate Group Stable | OK     | <null>                                                                                                      | <null>                                                              | <null>     |
| History Tablet Sched  | OK     | <null>                                                                                                      | <null>                                                              | <null>     |
+-----------------------+--------+-------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------+------------+

5 rows in set
```

キーワード​

SHOW, PROC

ベストプラクティス​

Report issue
ASF
Resources
Community
Join the community
Copyright © 2026 The Apache Software Foundation,Licensed under the Apache License, Version 2.0. Apache, Doris, Apache Doris, the Apache feather logo and the Apache Doris logo are trademarks of The Apache Software Foundation.