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

BUILD INDEXのキャンセル

デスクリプション​

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

Syntax​

CANCEL BUILD INDEX ON <table_name> [ job_list ]

其中：

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

必須パラメータ​

<table_name>

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

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

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

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

オプションパラメータ​

<job_list>

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

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

アクセス制御要件​

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

権限オブジェクト注記
ALTER_PRIVTableCANCEL BUILD INDEXはTableのALTER操作と見なされます

使用上の注意​

  • 現在はinverted indexに対してのみ有効で、bloomfilter indexなどの他のインデックスには有効ではありません。
  • 現在はintegrated storage and computing modeに対してのみ有効で、separated storage and computing modeには有効ではありません。
  • BUILD INDEXの進行状況とインデックス構築タスクはSHOW BUILD INDEXで確認できます。

例​

  • table1Tableのすべてのインデックス構築タスクをキャンセル

    CANCEL BUILD INDEX ON TABLE table1

  • Table table1 上のインデックス構築タスク jobid1 と jobid2 をキャンセルする

    CANCEL BUILD INDEX ON TABLE table1(jobid1, jobid2)