テーブルのインデックスのクエリ - 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) までお問い合わせください。検索インデックス：進捗は次の状態で示されます。 DONE：タスクは完了しました。 WAITING：タスクは送信済みで、実行を待機中です。 EXECUTING：タスクは実行中です。リアルタイムの進捗は `xx.xx%` の形式でパーセンテージで表示されます。 FAILED：タスクは失敗しました。エラーメッセージは INDEX_DESCRIPTION フィールドに表示されます。メッセージの最初の 256 文字のみが表示されます。説明検索インデックスの構築進捗は、LindormTable 2.8.5 以降および LTS 3.8.13.5 以降を使用している場合にのみ表示されます。以前のバージョン、またはより詳細な進捗状況とエラー情報を表示するには、LTS コンソールに移動します。左側のナビゲーションペインで、 [Lindorm Search] > [検索への全量データレプリケーション] を選択し、 [状態] パラメーターの値とその他のタスク詳細を表示します。現在のバージョンを表示またはアップグレードするには、「Lindorm インスタンスのマイナーエンジンバージョンのアップグレード」をご参照ください。コンソールでサポートされているバージョンにアップグレードできない場合は、Lindorm テクニカルサポート (DingTalk ID: s0s3eg3) までお問い合わせください。
INDEX_TYPE	インデックスタイプ。有効値： SECONDARY：インデックスはセカンダリインデックスです。 SEARCH：インデックスは検索インデックスです。
INDEX_COVERED	インデックスに付加列が含まれているかどうかを示します。セカンダリインデックス：インデックスに付加列がある場合は `TRUE` を返し、それ以外の場合は `FALSE` を返します。説明付加列の詳細については、「セカンダリインデックス」をご参照ください。検索インデックス：常に `NA` を返します。このインデックスタイプは付加列をサポートしていません。
INDEX_COLUMN	インデックスに含まれる列。
INDEX_TTL	インデックス付きデータの TTL。単位：秒。重要インデックスデータの TTL が設定されていない場合、このフィールドはセカンダリインデックスでは空になり、検索インデックスでは 0 になります。
INDEX_DESCRIPTION	インデックスに関する追加情報。セカンダリインデックス：セカンダリインデックスには追加情報はありません。このフィールドの値は空です。検索インデックス：検索インデックスには追加情報はありません。このフィールドの値は空です。

例

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

-- ベーステーブルの作成
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');

-- セカンダリインデックス idx1 の作成
CREATE INDEX idx1 ON test(c1 desc) include(c3,c4) WITH (COMPRESSION='ZSTD');

-- 検索インデックス 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         |                                       |
+--------------+------------+------------+-------------+-------------------------------+------------+---------------+----------------+-----------+---------------------------------------+