メインコンテンツまでスキップ
バージョン: 4.x

CANCEL ALTER TABLE

説明​

このステートメントは、実行中のALTER TABLE操作をキャンセル（取り消し）するために使用されます。このコマンドを使用して、ALTER TABLE操作が実行されている間にそれを終了することができます。

構文​

CANCEL ALTER TABLE { COLUMN | MATERIALIZED VIEW | ROLLUP } FROM <db_name>.<table_name> [ <job_id1> [ , <job_id2> ... ]]

必須パラメータ​

1. { COLUMN | MATERIALIZED VIEW | ROLLUP }

キャンセルする変更の種類を指定します。次のいずれかを選択する必要があります

  • COLUMN: Tableカラムの変更操作をキャンセルします
  • ROLLUP: ビューの変更操作をキャンセルします
  • MATERIALIZED VIEW: マテリアライズドビューの変更操作をキャンセルします

2.<db_name>

データベースの識別子（名前）を指定します。

識別子はアルファベット文字で始まる必要があります（Unicode名前サポートが有効な場合は、任意の言語の文字が許可されます）。識別子全体が引用符で囲まれている場合（例：My Database）を除き、スペースや特殊文字を含めることはできません。

識別子は予約キーワードを使用できません。

詳細については、識別子の要件と予約キーワードを参照してください。

3.<table_name>

データベース（Database）内のTableの識別子（名前）を指定します。

識別子はアルファベット文字で始まる必要があります（Unicode名前サポートが有効な場合は、任意の言語の文字が許可されます）。識別子全体が引用符で囲まれている場合（例：My Object）を除き、スペースや特殊文字を含めることはできません。

識別子は予約キーワードを使用できません。

詳細については、識別子の要件と予約キーワードを参照してください。

オプションパラメータ​

1. <job_id>

キャンセルする特定のジョブIDです。

ジョブIDが指定された場合、指定されたジョブのみがキャンセルされます。指定されていない場合、Table上で指定されたタイプ（COLUMNまたはROLLUP）のすべての進行中の変更がキャンセルされます。

複数のジョブIDをカンマ区切りで指定できます。

ジョブIDはSHOW ALTER TABLE COLUMNまたはSHOW ALTER TABLE ROLLUPコマンドを使用して取得できます。

権限制御​

このSQLコマンドを実行するユーザーは、少なくとも以下の権限を持つ必要があります：

権限オブジェクト備考
ALTER_PRIVTableCANCEL ALTER TABLEはTableのALTER操作に属します

注意事項​

  • このコマンドは非同期操作であり、実際の実行結果はSHOW ALTER TABLE COLUMNまたはSHOW ALTER TABLE ROLLUPを使用してタスクのステータスを確認する必要があります。

例​

  1. ALTER TABLE COLUMN操作をキャンセル
CANCEL ALTER TABLE COLUMN
FROM db_name.table_name
  1. ALTER TABLE ROLLUP操作をキャンセルする
CANCEL ALTER TABLE ROLLUP
FROM db_name.table_name
  1. job IDに基づいてALTER TABLE ROLLUP操作をバッチでキャンセルする
CANCEL ALTER TABLE ROLLUP
FROM db_name.table_name (jobid,...)
  1. ALTER CLUSTER操作のキャンセル
(To be implemented...)