Tous les produits
Search
Centre de documentation

Lindorm:SHOW INDEX

Dernière mise à jour :Sep 18, 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 sa construction et les colonnes indexées. Cette commande permet d'interroger rapidement le schéma d'indexation de la table cible. Utilisez également cette syntaxe 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 s'affiche 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 attend son 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 2.6.7 et versions 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 Lindorm 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 attend son 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 affichés.

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

    • Pour les versions antérieures, ou pour afficher des informations plus détaillées 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 prise en charge 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 possède 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 la TTL des données indexées n'est pas configurée, 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         |                                       |
+--------------+------------+------------+-------------+-------------------------------+------------+---------------+----------------+-----------+---------------------------------------+