Utilisez la syntaxe SHOW INDEX pour consulter les informations relatives aux index de la table spécifiée, notamment le type d'index, la progression de la construction et les colonnes indexées. Cette commande permet d'interroger rapidement le schéma d'index de la table cible. Vous pouvez également l'utiliser avant de supprimer un index secondaire ou un index de recherche afin de vérifier si l'index est désactivé.
Moteurs compatibles
La syntaxe SHOW INDEX s'applique uniquement à LindormTable.
Syntaxe
show_index_statement ::= SHOW INDEX FROM table_identifier;
Résultats renvoyés
Champ | Description |
TABLE_SCHEMA | Base de données contenant la table interrogée. |
DATA_TABLE | Nom de la table interrogée. |
INDEX_NAME | Nom de l'index associé à la table interrogée. |
INDEX_STATE | État de l'index. Valeurs possibles :
|
INDEX_PROGRESS | Progression de la construction de l'index. L'affichage de cette progression varie selon le type d'index.
|
INDEX_TYPE | Type d'index. Valeurs possibles :
|
INDEX_COVERED | Indique si l'index contient des colonnes incluses.
|
INDEX_COLUMN | Colonnes présentes dans l'index. |
INDEX_TTL | TTL (Time To Live) des données indexées. Unité : secondes. Important Si le TTL des données indexées n'est pas configuré, ce champ est vide pour un index secondaire et vaut 0 pour un index de recherche. |
INDEX_DESCRIPTION | Informations complémentaires sur l'index.
|
Exemples
Dans l'exemple suivant, la table de base et les index sont créés à l'aide des instructions suivantes :
-- Create the primary 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 secondary index idx1
CREATE INDEX idx1 ON test(c1 desc) include(c3,c4) WITH (COMPRESSION='ZSTD');
-- Create search index idx2
CREATE INDEX IF NOT EXISTS idx2 USING SEARCH ON test(p1, p2, c1, c2, c3);
Exécutez l'instruction suivante pour afficher tous les index de la table test :
SHOW INDEX FROM test;
Le résultat suivant est renvoyé :
+--------------+------------+------------+-------------+-------------------------------+------------+---------------+----------------+-----------+---------------------------------------+
| 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 | |
+--------------+------------+------------+-------------+-------------------------------+------------+---------------+----------------+-----------+---------------------------------------+