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

BUILD INDEXのキャンセル

説明​

インデックス構築のバックグラウンドタスクをキャンセルします。

構文​

CANCEL BUILD INDEX ON <table_name> [ job_list ]

ここで：

job_list
  : (<job_id1>[ , job_id2 ][ ... ])

必須パラメータ​

<table_name>

テーブルの識別子（つまり、名前）を指定します。これはそのデータベース（Database）内で一意である必要があります。

識別子は文字で始まる必要があり（unicode名前サポートが有効な場合は任意の言語文字）、識別子文字列全体がバッククォート（例：My Object）で囲まれていない限り、スペースや特殊文字を含むことはできません。

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

詳細については、Identifier RequirementsおよびReserved Keywordsを参照してください。

オプションパラメータ​

<job_list>

インデックス構築タスクの識別子のリストを指定します。カンマで区切り、括弧で囲みます。

識別子は数値である必要があり、SHOW BUILD INDEXで確認できます。

アクセス制御要件​

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

PrivilegeObjectNotes
ALTER_PRIVTableCANCEL BUILD INDEXはテーブルに対するALTER操作とみなされます

使用上の注意​

  • 現在、inverted indexに対してのみ有効で、bloomfilter indexなどの他のインデックスには有効ではありません。
  • 現在、統合ストレージ・コンピューティングモードに対してのみ有効で、分離ストレージ・コンピューティングモードには有効ではありません。
  • BUILD INDEXの進捗とインデックス構築タスクは、SHOW BUILD INDEXで確認できます。

例​

  • テーブルtable1のすべてのインデックス構築タスクをキャンセルする

    CANCEL BUILD INDEX ON table1

  • table1テーブルでインデックス構築タスクjobid1とjobid2をキャンセルする

    CANCEL BUILD INDEX ON table1(jobid1, jobid2)