テーブルのインデックスを照会する - Lindorm - Alibaba Cloud ドキュメントセンター

SHOW INDEX構文を使用して、指定したテーブルのインデックスに関する情報 (インデックスタイプ、インデックス構築の進捗状況、インデックス列など) を表示できます。この方法で、指定したテーブルのインデックススキーマをすばやく照会できます。また、セカンダリインデックスまたは検索インデックスを削除する前にSHOW INDEX構文を使用して、インデックスが無効になっているかどうかを確認することもできます。

適用可能なエンジン

SHOW INDEX構文はLindormTableにのみ適用されます。

構文

show_index_statement     ::= SHOW INDEX FROM table_identifier;

返される結果

フィールド	説明
TABLE_SCHEMA	照会されたテーブルを格納するデータベース。
DATA_TABLE	照会されたテーブルの名前。
INDEX_NAME	照会されたテーブルのインデックスの名前。
INDEX_STATE	インデックスの状態。有効な値： BUILDING：インデックスが構築中です。 ACTIVE：インデックスは既存のデータ用に構築されており、増分データ用に構築中です。 INACTIVE：インデックスの構築に失敗しました。 DISABLED：インデックスは無効になっています。
INDEX_PROGRESS	インデックスの構築の進捗状況。表示される構築の進捗状況は、インデックスタイプによって異なります。セカンダリインデックス：セカンダリインデックスの構築の進捗状況は、ステージごとに表示されます。セカンダリインデックスの構築タスクは、次のいずれかのステージにあります。 NOT_STARTED：タスクは送信されていません。 WAITING：タスクは送信済みで、実行待ちです。 EXECUTING：タスクは実行中です。このステージのタスクの進捗状況は、`xx.xx%`形式のパーセンテージで表示されます。 FAILED：タスクは失敗しました。この場合、返されたエラーメッセージの最初の256文字が表示されます。 CANCELLED：タスクはキャンセルされました。重要セカンダリインデックスは、LindormTable 2.6.7以降のバージョンでのみサポートされています。 LindormTableのバージョンを表示またはアップグレードする方法の詳細については、「LindormTableのリリースノート」および「Lindormインスタンスのマイナーエンジンバージョンをアップグレードする」をご参照ください。コンソールでLindormインスタンスのLindormTableバージョンを 2.6.7 以降にアップグレードできない場合は、テクニカルサポート（DingTalk ID：s0s3eg3）にお問い合わせください。検索インデックス：検索インデックスの実際の構築の進捗状況は表示できません。したがって、検索インデックスの構築の進捗状況は、`N/A`と表示されます。説明検索インデックスの構築の進捗状況を表示するには、次の手順を実行します。LTSコンソールの左側のナビゲーションペインで、[lindorm Search] > [フルデータの検索へのレプリケーション] を選択します。表示されるページで、[状態]フィールドの値を表示します。
INDEX_TYPE	インデックスタイプ。有効な値： SECONDARY：インデックスはセカンダリインデックスです。 SEARCH：インデックスは検索インデックスです。
INDEX_COVERED	インデックスに冗余列が含まれているかどうかを示します。セカンダリインデックス：インデックスに冗余列が含まれている場合、`TRUE` が返されます。それ以外の場合は、`FALSE` が返されます。説明冗余列の詳細については、「セカンダリインデックス」をご参照ください。検索インデックス：検索インデックスは冗余列をサポートしていません。したがって、照会されたインデックスが検索インデックスの場合、このフィールドには `NA` が返されます。
INDEX_COLUMN	インデックス内の列。
INDEX_TTL	インデックス付きデータのTTL。単位：秒。重要
INDEX_DESCRIPTION	インデックスに関する追加情報。セカンダリインデックス：セカンダリインデックスには追加情報がありません。このフィールドの値は空です。検索インデックス：検索インデックスには追加情報がありません。このフィールドの値は空です。

例

次の例では、次のステートメントを実行して、ベーステーブルとインデックスを作成します。

-- Create the base table. // ベーステーブルを作成します。
CREATE TABLE test (
  p1 VARCHAR NOT NULL,
  p2 INTEGER NOT NULL,
  c1 BIGINT,
  c2 DOUBLE,
  c3 VARCHAR,
  c4 TIMESTAMP,
  PRIMARY KEY(p1, p2)
) WITH (CONSISTENCY = 'strong', MUTABILITY='MUTABLE_LATEST');

-- Create a secondary index named idx1. // idx1 という名前のセカンダリインデックスを作成します。
CREATE INDEX idx1 ON test(c1 desc) include(c3,c4) WITH (COMPRESSION='ZSTD');

-- Create a search index named idx2. // idx2 という名前の検索インデックスを作成します。
CREATE INDEX IF NOT EXISTS idx2 USING SEARCH ON test(p1, p2, c1, c2, c3);

次のステートメントを実行して、testテーブルのすべてのインデックスを表示します。

SHOW INDEX FROM test;

次の結果が返されます。

+--------------+------------+------------+-------------+-------------------------------+------------+---------------+----------------+-----------+---------------------------------------+
| TABLE_SCHEMA | DATA_TABLE | INDEX_NAME | INDEX_STATE |        INDEX_PROGRESS         | INDEX_TYPE | INDEX_COVERED |  INDEX_COLUMN  | INDEX_TTL |           INDEX_DESCRIPTION           |
+--------------+------------+------------+-------------+-------------------------------+------------+---------------+----------------+-----------+---------------------------------------+
| hd           | test       | idx1       | ACTIVE      | 100%                          | SECONDARY  | TRUE          | c1,p1,p2       |           |                                       |
| hd           | test       | idx2       | ACTIVE      | N/A                           | SEARCH     | NA            | p1,c3,p2,c2,c1 | 0         |                                       |
+--------------+------------+------------+-------------+-------------------------------+------------+---------------+----------------+-----------+---------------------------------------+