メインコンテンツまでスキップ
バージョン: Latest-3.4

SHOW PROC

説明

StarRocks クラスターの特定の指標を表示します。

ヒント

この操作には 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 %
戻り値説明
BackendIdBE ノードの ID。
IPBE ノードの IP アドレス。
HeartbeatPortBE ノードのハートビートサービスのポート。
BePortBE ノードの Thrift サーバーのポート。
HttpPortBE ノードの HTTP サーバーのポート。
BrpcPortBE ノードの bRPC ポート。
LastStartTimeBE ノードが最後に開始された時刻。
LastHeartbeatBE ノードが最後にハートビートを受信した時刻。
AliveBE ノードが生存しているかどうか。
SystemDecommissionedBE ノードがシステムから除外されているかどうか。
ClusterDecommissionedBE ノードがクラスター内で除外されているかどうか。
TabletNumBE ノード内のタブレットの数。
DataUsedCapacityBE ノード内でデータに使用されているストレージ容量。
AvailCapacityBE ノード内の利用可能なストレージ容量。
TotalCapacityBE ノード内の総ストレージ容量。
UsedPctBE ノード内でストレージ容量が使用されている割合。
MaxDiskUsedPctBE ノード内でストレージ容量が使用されている最大割合。
ErrMsgBE ノード内のエラーメッセージ。
VersionBE ノードの StarRocks バージョン。
StatusBE ノードのステータス情報。タブレットを最後に報告した時刻を含む。
DataTotalCapacity使用済みおよび利用可能なデータストレージ容量の合計。 DataUsedCapacityAvailCapacity の合計。
DataUsedPctデータストレージが総データ容量に占める割合 (DataUsedCapacity/DataTotalCapacity)。
CpuCoresBE ノード内の CPU コア数。
NumRunningQueriesクラスター内で現在実行中のクエリの数。
MemUsedPct現在のメモリ使用率。
CpuUsedPct現在の CPU 使用率。

例 2: クラスター内のデータベースの情報を表示します。

mysql> SHOW PROC '/dbs';
+---------+------------------------+----------+----------------+--------------------------+---------------------+
| DbId | DbName | TableNum | Quota | LastConsistencyCheckTime | ReplicaQuota |
+---------+------------------------+----------+----------------+--------------------------+---------------------+
| 1 | information_schema | 22 | 8388608.000 TB | NULL | 9223372036854775807 |
| 840997 | tpcds_100g | 25 | 1024.000 GB | NULL | 1073741824 |
| 1275196 | _statistics_ | 3 | 8388608.000 TB | 2022-09-06 23:00:58 | 9223372036854775807 |
| 1286207 | tpcds_n | 24 | 8388608.000 TB | NULL | 9223372036854775807 |
| 1381289 | test | 6 | 8388608.000 TB | 2022-01-14 23:10:18 | 9223372036854775807 |
| 6186781 | test_stddev | 1 | 8388608.000 TB | 2022-09-06 23:00:58 | 9223372036854775807 |
+---------+------------------------+----------+----------------+--------------------------+---------------------+
戻り値説明
DbIdデータベース ID。
DbNameデータベース名。
TableNumデータベース内のテーブル数。
Quotaデータベースのストレージクォータ。
LastConsistencyCheckTime一貫性チェックが最後に実行された時刻。
ReplicaQuotaデータベースのデータレプリカクォータ。

例 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ジョブタイプ。
Pending保留中のジョブの数。
Running実行中のジョブの数。
Finished完了したジョブの数。
Cancelledキャンセルされたジョブの数。
Totalジョブの総数。

例 4: クラスター内の各データベースの統計情報を表示します。

mysql> SHOW PROC '/statistic';
+--------+----------------------------------------------------------+----------+--------------+----------+-----------+------------+--------------------+-----------------------+------------------+---------------------+
| DbId | DbName | TableNum | PartitionNum | IndexNum | TabletNum | ReplicaNum | UnhealthyTabletNum | InconsistentTabletNum | CloningTabletNum | ErrorStateTabletNum |
+--------+----------------------------------------------------------+----------+--------------+----------+-----------+------------+--------------------+-----------------------+------------------+---------------------+
| 10004 | _statistics_ | 3 | 3 | 3 | 30 | 60 | 0 | 0 | 0 | 0 |
| 1 | information_schema | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| 92498 | stream_load_test_db_03afc714_b1cb_11ed_a82c_00163e237e98 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| 92542 | stream_load_test_db_79876e92_b1da_11ed_b50e_00163e237e98 | 1 | 1 | 1 | 3 | 3 | 0 | 0 | 0 | 0 |
| 115476 | testdb | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| 10002 | zq_test | 8 | 8 | 8 | 5043 | 7063 | 0 | 0 | 0 | 2 |
| Total | 6 | 12 | 12 | 12 | 5076 | 7126 | 0 | 0 | 0 | 2 |
+--------+----------------------------------------------------------+----------+--------------+----------+-----------+------------+--------------------+-----------------------+------------------+---------------------+
7 rows in set (0.01 sec)

mysql> show proc '/statistic/10002';
+------------------+---------------------+----------------+-------------------+
| UnhealthyTablets | InconsistentTablets | CloningTablets | ErrorStateTablets |
+------------------+---------------------+----------------+-------------------+
| [] | [] | [] | [116703, 116706] |
+------------------+---------------------+----------------+-------------------+
戻り値説明
DbIdデータベース ID。
DbNameデータベース名。
TableNumデータベース内のテーブル数。
PartitionNumデータベース内のパーティション数。
IndexNumデータベース内のインデックス数。
TabletNumデータベース内のタブレット数。
ReplicaNumデータベース内のレプリカ数。
UnhealthyTabletNumデータ再配布中に未完了 (不健康) のタブレット数。
InconsistentTabletNumデータベース内の不一致タブレット数。
CloningTabletNumデータベース内でクローン中のタブレット数。
ErrorStateTabletNumプライマリキー型テーブルで、エラー状態のタブレット数。
ErrorStateTabletsプライマリキー型テーブルで、エラー状態のタブレットの ID。

例 5: クラスター内のすべての一般的なタスクと失敗したタスクの総数を表示します。

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 |
| NUM_TASK_TYPE | 0 | 0 |
| Total | 0 | 0 |
+-------------------------+-----------+----------+
戻り値説明
TaskTypeタスクタイプ。
FailedNum失敗したタスクの数。
TotalNumタスクの総数。

例 6: クラスター内の FE ノードの情報を表示します。

mysql> SHOW PROC '/frontends';
+----------------------------------+---------------+-------------+----------+-----------+---------+----------+------------+-------+-------+-------------------+---------------+----------+---------------+-----------+---------+
| Name | IP | EditLogPort | HttpPort | QueryPort | RpcPort | Role | ClusterId | Join | Alive | ReplayedJournalId | LastHeartbeat | IsHelper | ErrMsg | StartTime | Version |
+----------------------------------+---------------+-------------+----------+-----------+---------+----------+------------+-------+-------+-------------------+---------------+----------+---------------+-----------+---------+
| xxx.xx.xx.xxx_9009_1600088918395 | xxx.xx.xx.xxx | 9009 | 7390 | 0 | 0 | FOLLOWER | 1747363037 | false | false | 0 | NULL | true | got exception | NULL | NULL |
+----------------------------------+---------------+-------------+----------+-----------+---------+----------+------------+-------+-------+-------------------+---------------+----------+---------------+-----------+---------+
戻り値説明
NameFE ノード名。
IPFE ノードの IP アドレス。
EditLogPortFE ノード間の通信ポート。
HttpPortFE ノードの HTTP サーバーポート。
QueryPortFE ノードの MySQL サーバーポート。
RpcPortFE ノードの RPC ポート。
RoleFE ノードの役割 (Leader, Follower, または Observer)。
ClusterIdクラスター ID。
JoinFE ノードがクラスターに参加しているかどうか。
AliveFE ノードが生存しているかどうか。
ReplayedJournalIdFE ノードが再生した最大のメタデータ ID。
LastHeartbeatFE ノードが最後にハートビートを送信した時刻。
IsHelperFE ノードが BDBJE ヘルパーノードであるかどうか。
ErrMsgFE ノード内のエラーメッセージ。
StartTimeFE ノードが開始された時刻。
VersionFE ノードの StarRocks バージョン。

例 7: クラスター内の Broker ノードの情報を表示します。

mysql> SHOW PROC '/brokers';
+-------------+---------------+------+-------+---------------+---------------------+--------+
| Name | IP | Port | Alive | LastStartTime | LastUpdateTime | ErrMsg |
+-------------+---------------+------+-------+---------------+---------------------+--------+
| hdfs_broker | xxx.xx.xx.xxx | 8500 | true | NULL | 2022-10-10 16:37:59 | |
| hdfs_broker | xxx.xx.xx.xxx | 8500 | true | NULL | 2022-10-10 16:37:59 | |
| hdfs_broker | xxx.xx.xx.xxx | 8500 | true | NULL | 2022-10-10 16:37:59 | |
+-------------+---------------+------+-------+---------------+---------------------+--------+
戻り値説明
NameBroker ノード名。
IPBroker ノードの IP アドレス。
PortBroker ノードの Thrift サーバーポート。リクエストを受信するために使用されるポート。
AliveBroker ノードが生存しているかどうか。
LastStartTimeBroker ノードが最後に開始された時刻。
LastUpdateTimeBroker ノードが最後に更新された時刻。
ErrMsgBroker ノード内のエラーメッセージ。

例 8: クラスター内のリソースの情報を表示します。

mysql> SHOW PROC '/resources';
+-------------------------+--------------+---------------------+------------------------------+
| Name | ResourceType | Key | Value |
+-------------------------+--------------+---------------------+------------------------------+
| hive_resource_stability | hive | hive.metastore.uris | thrift://xxx.xx.xxx.xxx:9083 |
| hive2 | hive | hive.metastore.uris | thrift://xxx.xx.xx.xxx:9083 |
+-------------------------+--------------+---------------------+------------------------------+
戻り値説明
Nameリソース名。
ResourceTypeリソースタイプ。
Keyリソースキー。
Valueリソース値。

例 9: クラスター内のトランザクションの情報を表示します。

mysql> SHOW PROC '/transactions';
+-------+--------------------------------------+
| DbId | DbName |
+-------+--------------------------------------+
| 10005 | default_cluster:_statistics_ |
| 12711 | default_cluster:starrocks_audit_db__ |
+-------+--------------------------------------+
2 rows in set (0.00 sec)

mysql> SHOW PROC '/transactions/10005';
+----------+--------+
| State | Number |
+----------+--------+
| running | 0 |
| finished | 4 |
+----------+--------+
2 rows in set (0.00 sec)
戻り値説明
DbIdデータベース ID。
DbNameデータベース名。
Stateトランザクションの状態。
Numberトランザクションの数。

例 10: クラスター内の監視情報を表示します。

mysql> SHOW PROC '/monitor';
+------+------+
| Name | Info |
+------+------+
| jvm | |
+------+------+
戻り値説明
NameJVM 名。
InfoJVM 情報。

例 11: クラスター内のロードバランス情報を表示します。

mysql> SHOW PROC '/cluster_balance';
+-------------------+--------+
| Item | Number |
+-------------------+--------+
| cluster_load_stat | 1 |
| working_slots | 3 |
| sched_stat | 1 |
| priority_repair | 0 |
| pending_tablets | 2001 |
| running_tablets | 0 |
| history_tablets | 1000 |
+-------------------+--------+
戻り値説明
Itemcluster_balance のサブコマンド項目。
  • cluster_load_stat: クラスターの現在の負荷状況。
  • working_slots: 現在利用可能な作業スロットの数。
  • sched_stat: スケジューラの現在の状態。
  • priority_repair: 優先されるタブレット修復タスクの数。
  • pending_tablets: 処理待ちのタブレットの数。
  • running_tablets: 現在修復中のタブレットの数。
  • history_tablets: 過去に修復されたタブレットの総数。
Numbercluster_balance の各サブコマンドの数。

例 12: クラスター内の Colocate Join グループの情報を表示します。

mysql> SHOW PROC '/colocation_group';
+-----------------+----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+------------+----------------+-------------+----------+
| GroupId | GroupName | TableIds | BucketsNum | ReplicationNum | DistCols | IsStable |
+-----------------+----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+------------+----------------+-------------+----------+
| 24010.177354 | 24010_lineitem_str_g1 | 177672 | 12 | 1 | varchar(-1) | true |
| 24010.182146 | 24010_lineitem_str_g2 | 182144 | 192 | 1 | varchar(-1) | true |
| 1439318.1735496 | 1439318_group_agent_uid | 1735677, 1738390 | 12 | 2 | bigint(20) | true |
| 24010.37804 | 24010_gsdaf2449s9e | 37802 | 192 | 1 | int(11) | true |
| 174844.175370 | 174844_groupa4 | 175368, 591307, 591362, 591389, 591416 | 12 | 1 | int(11) | true |
| 24010.30587 | 24010_group2 | 30585, 30669 | 12 | 1 | int(11) | true |
| 10005.181366 | 10005_lineorder_str_normal | 181364 | 192 | 1 | varchar(-1) | true |
| 1904968.5973175 | 1904968_groupa2 | 5973173 | 12 | 1 | int(11) | true |
| 24010.182535 | 24010_lineitem_str_g3 | 182533 | 192 | 1 | varchar(-1) | true |
+-----------------+----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+------------+----------------+-------------+----------+
戻り値説明
GroupIdColocate Join グループ ID。
GroupNameColocate Join グループ名。
TableIdsColocate Join グループ内のテーブル ID。
BucketsNumColocate Join グループ内のバケット数。
ReplicationNumColocate Join グループ内のレプリケーション数。
DistColsColocate Join グループの分散列。
IsStableColocate Join グループが安定しているかどうか。

例 13: クラスター内のカタログの情報を表示します。

mysql> SHOW PROC '/catalog';
+--------------------------------------------------------------+----------+----------------------+
| Catalog | Type | Comment |
+--------------------------------------------------------------+----------+----------------------+
| resource_mapping_inside_catalog_hive_hive2 | hive | mapping hive catalog |
| resource_mapping_inside_catalog_hive_hive_resource_stability | hive | mapping hive catalog |
| default_catalog | Internal | Internal Catalog |
+--------------------------------------------------------------+----------+----------------------+
戻り値説明
Catalogカタログ名。
Typeカタログタイプ。
Commentカタログに関するコメント。

例 14: クラスター内のレプリケーションタスクの情報を表示します。

mysql> SHOW PROC '/replications';
+-------------------------------------------------+------------+---------+-------+---------------------+---------------------+-----------+----------+-------+
| JobID | DatabaseID | TableID | TxnID | CreatedTime | FinishedTime | State | Progress | Error |
+-------------------------------------------------+------------+---------+-------+---------------------+---------------------+-----------+----------+-------+
| FAILOVER_GROUP_group1-11006-11010-1725593360156 | 11006 | 11010 | 99 | 2024-09-06 11:29:20 | 2024-09-06 11:29:21 | COMMITTED | | |
| FAILOVER_GROUP_group1-11006-11009-1725593360161 | 11006 | 11009 | 98 | 2024-09-06 11:29:20 | 2024-09-06 11:29:21 | COMMITTED | | |
| FAILOVER_GROUP_group1-11006-11074-1725593360161 | 11006 | 11074 | 100 | 2024-09-06 11:29:20 | 2024-09-06 11:29:21 | COMMITTED | | |
| FAILOVER_GROUP_group1-11006-12474-1725593360250 | 11006 | 12474 | 102 | 2024-09-06 11:29:20 | 2024-09-06 11:29:24 | COMMITTED | | |
| FAILOVER_GROUP_group1-11006-11024-1725593360293 | 11006 | 11024 | 101 | 2024-09-06 11:29:20 | 2024-09-06 11:29:24 | COMMITTED | | |
| FAILOVER_GROUP_group1-11006-13861-1725607270963 | 11006 | 13861 | 627 | 2024-09-06 15:21:10 | 2024-09-06 15:21:14 | COMMITTED | | |
+-------------------------------------------------+------------+---------+-------+---------------------+---------------------+-----------+----------+-------+
戻り値説明
JobIDジョブ ID。
DatabaseIDデータベース ID。
TableIDテーブル ID。
TxnIDトランザクション ID。
CreatedTimeタスクが作成された時刻。
FinishedTimeタスクが終了した時刻。
Stateタスクのステータス。 有効な値: INITIALIZING, SNAPSHOTING, REPLICATING, COMMITTED, ABORTED.
Progressタスクの進捗状況。
Errorエラーメッセージ (あれば)。

例 15: 現在の FE ノードで実行中のクエリの情報を表示します。

MySQL > show proc '/current_queries';
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-------------------+---------------+---------------+
| StartTime | feIp | QueryId | ConnectionId | Database | User | ScanBytes | ScanRows | MemoryUsage | DiskSpillSize | CPUTime | ExecTime | Warehouse | CustomQueryId | ResourceGroup |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-------------------+---------------+---------------+
| 2025-03-07 02:00:19 | 172.26.92.227 | ddbd69b9-fab4-11ef-8063-461f20abc3f0 | 11 | tpcds_2 | root | 120.573 MB | 5859503 rows | 296.432 MB | 0.000 B | 27.888 s | 3.153 s | default_warehouse | | rg1 |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+----------+----------+-------------------+---------------+---------------+

例 16: クラスター内のすべての FE ノードで実行中のクエリの情報を表示します。

MySQL > show proc '/global_current_queries';
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-------------------+---------------+---------------+
| StartTime | feIp | QueryId | ConnectionId | Database | User | ScanBytes | ScanRows | MemoryUsage | DiskSpillSize | CPUTime | ExecTime | Warehouse | CustomQueryId | ResourceGroup |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-------------------+---------------+---------------+
| 2025-03-07 02:02:47 | 172.26.92.227 | 3603d566-fab5-11ef-8063-461f20abc3f0 | 12 | tpcds_2 | root | 100.886 MB | 4899036 rows | 114.491 MB | 0.000 B | 5.700 s | 0.713 s | default_warehouse | | rg1 |
+---------------------+---------------+--------------------------------------+--------------+----------+------+------------+--------------+-------------+---------------+---------+----------+-------------------+---------------+---------------+