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

CANCEL ALTER TABLE

デスクリプション​

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

Syntax​

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. ジョブIDに基づいてALTER TABLE ROLLUP操作をバッチ単位でキャンセルする
CANCEL ALTER TABLE ROLLUP
FROM db_name.table_name (jobid,...)
  1. ALTER CLUSTER操作をキャンセルする
(To be implemented...)