SHOW ALTER

説明

このステートメントは、進行中のさまざまな変更タスクの実行状況を表示するために使用されます。

SHOW ALTER [TABLE [COLUMN | ROLLUP] [FROM db_name]];

注意:

1. TABLE COLUMN: カラムを変更するALTERタスクを表示します。
2. サポートされている構文: [WHERE TableName|CreateTime|FinishTime|State] [ORDER BY] [LIMIT]。
3. TABLE ROLLUP: ROLLUPの作成または削除のタスクを表示します。
4. db_nameが指定されていない場合は、現在のデフォルトデータベースが使用されます。

Result

SHOW ALTER TABLE COLUMN

Field Name	Description
JobId	各Schema Changeジョブの一意のID。
TableName	Schema Changeに対応するベーステーブルの名前。
CreateTime	ジョブ作成時刻。
FinishedTime	ジョブ完了時刻。完了していない場合は「N/A」を表示します。
IndexName	この変更に関係するベーステーブル/同期マテリアライズドビューの名前。
IndexId	新しいベーステーブル/同期マテリアライズドビューのID。
OriginIndexId	この変更に関係するベーステーブル/同期マテリアライズドビューの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	ジョブのタイムアウト時間（秒）。

Examples

1. デフォルトデータベースのすべての変更カラムタスクの実行状況を表示します。

   SHOW ALTER TABLE COLUMN;

2. 特定のテーブルに対する最新の列修正タスクの実行ステータスを表示します。

   SHOW ALTER TABLE COLUMN WHERE TableName = "table1" ORDER BY CreateTime DESC LIMIT 1;

3. 指定されたデータベースに対するROLLUPタスクの作成または削除の実行ステータスを表示します。

   SHOW ALTER TABLE ROLLUP FROM example_db;

キーワード

SHOW, ALTER

ベストプラクティス