SHOW ALTER
デスクリプション
このステートメントは、実行中の様々な変更タスクの実行状況を表示するために使用されます。
SHOW ALTER [TABLE [COLUMN | ROLLUP] [FROM db_name]];
注意事項:
- TABLE COLUMN: カラムを変更するためのALTERタスクを表示します。
- サポートされる構文: [WHERE TableName|CreateTime|FinishTime|State] [ORDER BY] [LIMIT]。
- TABLE ROLLUP: ROLLUPを作成または削除するためのタスクを表示します。
- db_nameが指定されていない場合、現在のデフォルトデータベースが使用されます。
結果
SHOW ALTER TABLE COLUMN
| フィールド名 | 説明 |
|---|---|
| JobId | 各Schema Changeジョブの一意のID。 |
| TableName | Schema Changeに対応するベースTableの名前。 |
| CreateTime | ジョブ作成時刻。 |
| FinishedTime | ジョブ完了時刻。完了していない場合は「N/A」を表示します。 |
| IndexName | この変更に関わるベースTable/同期マテリアライズドビューの名前。 |
| IndexId | 新しいベースTable/同期マテリアライズドビューのID。 |
| OriginIndexId | この変更に関わるベースTable/同期マテリアライズドビューのID。 |
| SchemaVersion | M:N形式で表示されます。MはSchema Changeのバージョンを表し、Nは対応するハッシュ値を表します。各Schema Changeはバージョンを増加させます。 |
| TransactionId | 履歴データを変換するためのトランザクションID。 |
| State | ジョブのフェーズ。 |
| - PENDING: ジョブはキューでスケジュールされるのを待機中です。 | |
| - WAITING_TXN: 境界トランザクションID以前のインポートタスクの完了を待機中です。 | |
| - RUNNING: 現在履歴データ変換を実行中です。 | |
| - FINISHED: ジョブが正常に完了しました。 | |
| - CANCELLED: ジョブが失敗しました。 | |
| Msg | ジョブが失敗した場合、失敗メッセージを表示します。 |
| Progress | ジョブの進捗状況。RUNNING状態でのみ表示されます。進捗はM/N形式で表示されます。NはSchema Changeに関わるレプリカの総数です。Mは履歴データ変換が完了したレプリカの数です。 |
| Timeout | ジョブのタイムアウト時間(秒)。 |
例
-
デフォルトデータベースのすべての変更カラムタスクの実行状況を表示します。
SHOW ALTER TABLE COLUMN; -
特定のTableに対する最新の列変更タスクの実行状況を表示します。
SHOW ALTER TABLE COLUMN WHERE TableName = "table1" ORDER BY CreateTime DESC LIMIT 1; -
指定されたデータベースに対するROLLUPタスクの作成または削除の実行状況を表示します。
SHOW ALTER TABLE ROLLUP FROM example_db;
キーワード
SHOW, ALTER