SHOW PROC
説明
StarRocks クラスターの特定の指標を表示します。
SHOW PROC は Linux の /proc ファイルシステムに相当する。/proc のパスと同様に、SHOW PROC のパラメータはツリーのような階層構造になっており、それぞれの階層で異なる情報が表示される。SHOW PROC '/dbs' を例にとってみよう:
SHOW PROC '/dbs'はクラスタ内のすべてのデータベースの情報を返す。SHOW PROC '/dbs/<db_name>'は指定したデータベースの情報を返す。SHOW PROC '/dbs/<db_name>/tables'は指定したデータベースの全てのテーブルの情報を返す。SHOW PROC '/dbs/<db_name>/<table_name>'は指定したテーブルの情報を返す。SHOW PROC '/dbs/<db_name>/<table_name>/partitions'は指定したテーブルのすべてのパーティションの情報を返す。
SHOW PROC のパラメータはリーフノードまで指定できます。
ヒント
この操作には SYSTEM レベルの OPERATE 権限が必要です。この権限を付与するには、 GRANT の指示に従ってください。
構文
SHOW PROC { '/backends' | '/compute_nodes' | '/dbs' | '/jobs'
| '/statistic' | '/tasks' | '/frontends' | '/brokers'
| '/resources' | '/load_error_hub' | '/transactions'
| '/monitor' | '/current_queries' | '/current_backend_instances'
| '/cluster_balance' | '/routine_loads' | '/colocation_group'
| '/catalog' | '/replications' | '/global_current_queries' }
パラメータ
| パラメータ | 説明 |
|---|---|
| '/backends' | クラスター内の BE ノードの情報を表示します。 |
| '/compute_nodes' | クラスター内の CN ノードの情報を表示します。 |
| '/dbs' | クラスター内のデータベースの情報を表示します。 |
| '/jobs' | クラスター内のジョブの情報を表示します。 |
| '/statistic' | クラスター内の各データベースの統計情報を表示します。 |
| '/tasks' | クラスター内のすべての一般的なタスクと失敗したタスクの総数を表示します。 |
| '/frontends' | クラスター内の FE ノードの情報を表示します。 |
| '/brokers' | クラスター内の Broker ノードの情報を表示します。 |
| '/resources' | クラスター内のリソースの情報を表示します。 |
| '/load_error_hub' | ロードエラーハブの設定を表示します。これは、ロードジョブのエラーメッセージを管理するために使用されます。 |
| '/transactions' | クラスター内のトランザクションの情報を表示します。 |
| '/monitor' | クラスター内の監視情 報を表示します。 |
| '/current_queries' | 現在の FE ノードで実行中のクエリの情報を表示します。 |
| '/current_backend_instances' | クラスター内でリクエストを処理している BE ノードを表示します。 |
| '/cluster_balance' | クラスター内のロードバランス情報を表示します。 |
| '/routine_loads' | クラスター内の Routine Load の情報を表示します。 |
| '/colocation_group' | クラスター内の Colocate Join グループの情報を表示します。 |
| '/catalog' | クラスター内のカタログの情報を表示します。 |
| '/replications' | クラスター内のデータレプリケーションタスクの情報を表示します。 |
| '/global_current_queries' | クラスター内のすべての FE ノードで実行中のクエリの情報を表示します。 |
例
例 1: クラスター内の BE ノードの情報を表示します。
mysql> SHOW PROC '/backends'\G
*************************** 1. row ***************************
BackendId: 10004
IP: xxx.xx.92.200
HeartbeatPort: 9354
BePort: 9360
HttpPort: 8338
BrpcPort: 8360
LastStartTime: 2023-04-21 09:56:10
LastHeartbeat: 2023-04-21 09:56:10
Alive: true
SystemDecommissioned: false
ClusterDecommissioned: false
TabletNum: 2199
DataUsedCapacity: 0.000
AvailCapacity: 584.578 GB
TotalCapacity: 1.968 TB
UsedPct: 71.00 %
MaxDiskUsedPct: 71.00 %
ErrMsg:
Version: BRANCH-3.0-RELEASE-8eb8705
Status: {"lastSuccessReportTabletsTime":"N/A"}
DataTotalCapacity: 584.578 GB
DataUsedPct: 0.00 %
CpuCores: 16
NumRunningQueries: 0
MemUsedPct: 0.52 %
CpuUsedPct: 0.0 %
| 戻り値 | 説明 |
|---|---|
| BackendId | BE ノードの ID。 |
| IP | BE ノードの IP アドレス。 |
| HeartbeatPort | BE ノードのハートビートサービスのポート。 |
| BePort | BE ノードの Thrift サーバーのポート。 |
| HttpPort | BE ノードの HTTP サーバーのポート。 |
| BrpcPort | BE ノードの bRPC ポート。 |
| LastStartTime | BE ノードが最後に開始された時刻。 |
| LastHeartbeat | BE ノードが最後にハートビートを受信した時刻。 |
| Alive | BE ノードが生存しているかどうか。 |
| SystemDecommissioned | BE ノードがシステムから除外されているかどうか。 |
| ClusterDecommissioned | BE ノードがクラスター内で除外されているかどうか。 |
| TabletNum | BE ノード内のタブレットの数。 |
| DataUsedCapacity | BE ノード内でデータに使用されているストレージ容量。 |
| AvailCapacity | BE ノード内の利用可能なストレージ容量。 |
| TotalCapacity | BE ノード内の総ストレージ容量。 |
| UsedPct | BE ノード内でストレージ容量が使用されている割合。 |
| MaxDiskUsedPct | BE ノード内でストレージ容量が使用されている最大割合。 |
| ErrMsg | BE ノード内のエラーメッセージ。 |
| Version | BE ノードの StarRocks バージョン。 |
| Status | BE ノードのステータス情報。タブレットを最後に報告した時刻を含む。 |
| DataTotalCapacity | 使用済みおよび利用可能なデータストレージ容量の合計。 DataUsedCapacity と AvailCapacity の合計。 |
| DataUsedPct | データストレージが総データ容量に占める割合 (DataUsedCapacity/DataTotalCapacity)。 |
| CpuCores | BE ノード内の CPU コア数。 |
| NumRunningQueries | クラスター内で現在実行中のクエリの数。 |
| MemUsedPct | 現在のメモリ使用率。 |
| CpuUsedPct | 現在の CPU 使用率。 |
例 2: クラスター内のデータベースの情報を表示します。
mysql> show proc "/dbs";
+-------+--------------------+----------+----------------+--------------------------+---------------------+
| DbId | DbName | TableNum | Quota | LastConsistencyCheckTime | ReplicaQuota |
+-------+--------------------+----------+----------------+--------------------------+---------------------+
| 1 | information_schema | 54 | 8388608.000 TB | NULL | 9223372036854775807 |
| 100 | sys | 6 | 8388608.000 TB | NULL | 9223372036854775807 |
| 10001 | _statistics_ | 12 | 8388608.000 TB | NULL | 9223372036854775807 |
| 10015 | test | 1 | 8388608.000 TB | NULL | 9223372036854775807 |
+-------+--------------------+----------+----------------+--------------------------+---------------------+
4 rows in set (0.00 sec)
mysql> show proc "/dbs/test";
+---------+------------------+----------+---------------------+--------------+--------+--------------+--------------------------+--------------+---------------+--------------------------------------------------------------------------------------------------------+
| TableId | TableName | IndexNum | PartitionColumnName | PartitionNum | State | Type | LastConsistencyCheckTime | ReplicaCount | PartitionType | StoragePath |
+---------+------------------+----------+---------------------+--------------+--------+--------------+--------------------------+--------------+---------------+--------------------------------------------------------------------------------------------------------+
| 10207 | source_wiki_edit | 1 | event_time | 4 | NORMAL | CLOUD_NATIVE | NULL | 8 | RANGE | s3://test/xxx |
+---------+------------------+----------+---------------------+--------------+--------+--------------+--------------------------+--------------+---------------+--------------------------------------------------------------------------------------------------------+
1 row in set (0.00 sec)
mysql> show proc "/dbs/test/source_wiki_edit";
+-----------------+
| Nodes |
+-----------------+
| partitions |
| temp_partitions |
| index_schema |
+-----------------+
3 rows in set (0.00 sec)
| 戻り値 | 説明 |
|---|---|
| DbId | データベース ID。 |
| DbName | データベース名。 |
| TableNum | データベース内のテーブル数。 |
| Quota | データベースのストレージクォータ。 |
| LastConsistencyCheckTime | 一貫性チェックが最後に実行された時刻。 |
| ReplicaQuota | データベースのデータレプリカクォータ。 |
| TableId | テーブル ID。 |
| TableName | テーブル名。 |
| PartitionColumnName | パーティションカラム名。 |
| PartitionNum | テーブルのパーティション数。 |
| State | テーブルの状態。 |
| Type | テーブルのタイプ。 |
| LastConsistencyCheckTime | 最後に一致性チェックが実行された時 刻。 |
| ReplicaCount | テーブルのレプリカ数。 |
| PartitionType | テーブルのパーティションの種類。 |
| StoragePath | テーブルのストレージパス。 |
| partitions | テーブルのパーティション。 |
| temp_partitions | テーブルの一時パーティション。 |
| index_schema | テーブルの同期マテリアライズドビュー。 |
例 3: クラスター内のジョブの情報を表示します。
mysql> SHOW PROC '/jobs';
+-------+--------------------------------------+
| DbId | DbName |
+-------+--------------------------------------+
| 10005 | default_cluster:_statistics_ |
| 0 | default_cluster:information_schema |
| 12711 | default_cluster:starrocks_audit_db__ |
+-------+--------------------------------------+
3 rows in set (0.00 sec)
mysql> SHOW PROC '/jobs/10005';
+---------------+---------+---------+----------+-----------+-------+
| JobType | Pending | Running | Finished | Cancelled | Total |
+---------------+---------+---------+----------+-----------+-------+
| load | 0 | 0 | 3 | 0 | 3 |
| rollup | 0 | 0 | 0 | 0 | 0 |
| schema_change | 0 | 0 | 0 | 0 | 0 |
| export | 0 | 0 | 0 | 0 | 0 |
+---------------+---------+---------+----------+-----------+-------+
4 rows in set (0.00 sec)
| 戻り値 | 説明 |
|---|---|
| DbId | データベース ID。 |
| DbName | データベース名。 |
| JobType |