SHOW ROUTINE LOAD
説明
このステートメントは、Routine Loadジョブの実行状態を表示するために使用されます。特定のジョブまたは全てのジョブの状態情報を確認できます。
構文
SHOW [ALL] ROUTINE LOAD [FOR <jobName>];
オプションパラメータ
1. [ALL]
オプションパラメータ。指定した場合、すべてのジョブ(停止またはキャンセルされたジョブを含む)が表示されます。指定しない場合、現在実行中のジョブのみが表示されます。
2. [FOR <jobName>]
オプションパラメータ。表示するジョブ名を指定します。指定しない場合、現在のデータベース下のすべてのジョブが表示されます。
以下の形式をサポートします:
<job_name>:現在のデータベース内の指定した名前のジョブを表示<db_name>.<job_name>:指定したデータベース内の指定した名前のジョブを表示
戻り値
| フィールド名 | 説明 |
|---|---|
| Id | ジョブID |
| Name | ジョブ名 |
| CreateTime | ジョブ作成時刻 |
| PauseTime | 最新のジョブ一時停止時刻 |
| EndTime | ジョブ終了時刻 |
| DbName | 対応するデータベース名 |
| TableName | 対応するテーブル名(複数テーブルの場合は'multi-table'を表示) |
| IsMultiTbl | 複数テーブルジョブかどうか |
| State | ジョブ実行ステータス |
| DataSourceType | データソースタイプ:KAFKA |
| CurrentTaskNum | 現在のサブタスク数 |
| JobProperties | ジョブ設定詳細 |
| DataSourceProperties | データソース設定詳細 |
| CustomProperties | カスタム設定 |
| Statistic | ジョブ実行統計 |
| Progress | ジョブ実行進捗 |
| Lag | ジョブ遅延ステータス |
| ReasonOfStateChanged | ジョブ状態変更理由 |
| ErrorLogUrls | 品質チェックに失敗したフィルタされたデータを表示するURL |
| OtherMsg | その他のエラーメッセージ |
アクセス制御要件
このSQLコマンドを実行するユーザーは、最低限以下の権限を持つ必要があります:
| 権限 | オブジェクト | 備考 |
|---|---|---|
| LOAD_PRIV | Table | SHOW ROUTINE LOADにはテーブルに対するLOAD権限が必要です |
注意事項
-
State の説明:
- NEED_SCHEDULE:ジョブはスケジュール待ち
- RUNNING:ジョブは実行中
- PAUSED:ジョブは一時停止中
- STOPPED:ジョブは終了
- CANCELLED:ジョブはキャンセルされました
-
Progress の説明:
- Kafkaデータソースの場合、各パーティションの消費済みオフセットを表示
- 例:{"0":"2"} は Kafkaパーティション0の消費進捗が2であることを意味
-
Lag の説明:
- Kafkaデータソースの場合、各パーティションの消費遅延を表示
- 例:{"0":10} は Kafkaパーティション0の消費遅延が10であることを意味
例
-
test1という名前のすべてのroutine loadジョブ(停止またはキャンセルされたものを含む)を表示
SHOW ALL ROUTINE LOAD FOR test1; -
test1という名前で現在実行中のroutine loadジョブを表示する
SHOW ROUTINE LOAD FOR test1; -
example_db内のすべてのルーチンロードジョブ(停止またはキャンセルされたものを含む)を表示します。結果は1行または複数行になる場合があります。
use example_db;
SHOW ALL ROUTINE LOAD; -
example_db で現在実行中のすべての routine load ジョブを表示する
use example_db;
SHOW ROUTINE LOAD; -
example_db内のtest1という名前で現在実行中のroutine load jobを表示する
SHOW ROUTINE LOAD FOR example_db.test1; -
example_db内のtest1という名前のすべてのroutine loadジョブ(停止またはキャンセルされたものを含む)を表示します。結果は1行または複数行になる場合があります。
SHOW ALL ROUTINE LOAD FOR example_db.test1;