Tous les produits
Search
Centre de documentation

Lindorm:SHOW INDEX

Dernière mise à jour :Aug 25, 2026

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 :

  • BUILDING : L'index est en cours de construction.

  • ACTIVE : L'index a été construit pour les données existantes et sa construction se poursuit pour les données incrémentielles.

  • INACTIVE : La construction de l'index a échoué.

  • DISABLED : L'index est désactivé.

INDEX_PROGRESS

Progression de la construction de l'index. L'affichage de cette progression varie selon le type d'index.

  • Index secondaire : La progression est affichée par étape. Une tâche de construction d'index secondaire peut se trouver dans l'un des états suivants :

    • NOT_STARTED : La tâche n'a pas été soumise.

    • WAITING : La tâche a été soumise et est en attente d'exécution.

    • EXECUTING : La tâche est en cours d'exécution. La progression en temps réel s'affiche sous forme de pourcentage au format xx.xx%.

    • FAILED : La tâche a échoué. Dans ce cas, les 256 premiers caractères du message d'erreur renvoyé s'affichent.

    • CANCELLED : La tâche a été annulée.

    Important

    Les index secondaires sont pris en charge uniquement dans LindormTable version 2.6.7 et ultérieures. Pour plus d'informations sur la consultation ou la mise à niveau de la version de LindormTable, consultez les Notes de version de LindormTable et la rubrique Mettre à niveau la version mineure du moteur d'une instance Lindorm. Si vous ne parvenez pas à mettre à niveau la version LindormTable de votre instance vers la version 2.6.7 ou ultérieure depuis la console, contactez le support technique (ID DingTalk : s0s3eg3).

  • Index de recherche : La progression est indiquée par les états suivants.

    • DONE : La tâche est terminée.

    • WAITING : La tâche a été soumise et est en attente d'exécution.

    • EXECUTING : La tâche est en cours d'exécution. La progression en temps réel s'affiche sous forme de pourcentage au format xx.xx%.

    • FAILED : La tâche a échoué. Le message d'erreur s'affiche dans le champ INDEX_DESCRIPTION. Seuls les 256 premiers caractères du message sont visibles.

    Remarque
    • La progression de la construction d'un index de recherche s'affiche uniquement si vous utilisez LindormTable version 2.8.5 ou ultérieure et LTS version 3.8.13.5 ou ultérieure.

    • Pour les versions antérieures, ou pour afficher des détails plus précis sur la progression et les erreurs, accédez à la console LTS. Dans le volet de navigation de gauche, choisissez Lindorm Search > Full Data replication to Search et consultez la valeur du paramètre State ainsi que les autres détails de la tâche.

    • Pour consulter ou mettre à niveau votre version actuelle, reportez-vous à la rubrique Mettre à niveau la version mineure du moteur d'une instance Lindorm. Si vous ne parvenez pas à effectuer la mise à niveau vers une version compatible depuis la console, contactez le support technique Lindorm (ID DingTalk : s0s3eg3).

INDEX_TYPE

Type d'index. Valeurs possibles :

  • SECONDARY : Il s'agit d'un index secondaire.

  • SEARCH : Il s'agit d'un index de recherche.

INDEX_COVERED

Indique si l'index contient des colonnes incluses.

  • Index secondaire : Renvoie TRUE si l'index comporte des colonnes incluses, et FALSE dans le cas contraire.

    Remarque

    Pour plus d'informations sur les colonnes incluses, consultez la rubrique Index secondaires.

  • Index de recherche : Renvoie toujours NA. Ce type d'index ne prend pas en charge les 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.

  • Index secondaire : Les index secondaires ne comportent pas d'informations supplémentaires. La valeur de ce champ est vide.

  • Index de recherche : Les index de recherche ne comportent pas d'informations supplémentaires. La valeur de ce champ est vide.

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         |                                       |
+--------------+------------+------------+-------------+-------------------------------+------------+---------------+----------------+-----------+---------------------------------------+