SHOW INDEX - Lindorm - Centro de documentación de Alibaba Cloud

La sintaxis SHOW INDEX le permite consultar la información de los índices de una tabla específica. Esta incluye el tipo de índice, el progreso de compilación y las columnas del índice. De este modo, puede obtener rápidamente el esquema de índices de la tabla indicada. También es útil ejecutar esta sintaxis antes de eliminar un índice secundario o un search index para comprobar si el índice está deshabilitado.

Motores compatibles

La sintaxis SHOW INDEX solo es compatible con LindormTable.

Sintaxis

show_index_statement     ::= SHOW INDEX FROM table_identifier;

Resultados devueltos

Campo	Descripción
TABLE_SCHEMA	Base de datos que almacena la tabla consultada.
DATA_TABLE	Nombre de la tabla consultada.
INDEX_NAME	Nombre del índice de la tabla consultada.
INDEX_STATE	Estado del índice. Valores válidos: BUILDING: el índice se está compilando. ACTIVE: el índice ya se compiló para los datos existentes y se compila para los datos incrementales. INACTIVE: la compilación del índice terminó con errores. DISABLED: el índice está deshabilitado.
INDEX_PROGRESS	Progreso de compilación del índice. El avance mostrado varía según el tipo de índice. Índice secundario: el progreso de compilación se muestra por etapas. Una tarea de compilación de índice secundario puede encontrarse en alguna de a continuación: NOT_STARTED: la tarea no se ha enviado. WAITING: la tarea se envió y está pendiente de ejecución. EXECUTING: la tarea se está ejecutando. El progreso en tiempo real se muestra como porcentaje con el formato `xx.xx%`. FAILED: la tarea terminó con errores. En este caso, se muestran los primeros 256 caracteres del mensaje de error devuelto. CANCELLED: la tarea se canceló. Importante Los índices secundarios solo son compatibles con LindormTable 2.6.7 y versiones posteriores. Para más información sobre cómo consultar o actualizar la versión de LindormTable, consulte Release notes of LindormTable y Upgrade the minor engine version of a Lindorm instance. Si no logra actualizar la versión de LindormTable de su instancia de Lindorm a la 2.6.7 o posterior desde la consola, comuníquese con el soporte técnico (ID de DingTalk: s0s3eg3). search index: el progreso se indica mediante los siguientes estados. DONE: la tarea finalizó. WAITING: la tarea se envió y espera su ejecución. EXECUTING: la tarea se está ejecutando. El progreso en tiempo real se muestra como porcentaje con el formato `xx.xx%`. FAILED: la tarea terminó con errores. El mensaje de error se muestra en el campo INDEX_DESCRIPTION. Solo se presentan los primeros 256 caracteres del mensaje. Nota El progreso de compilación de un search index solo se muestra si utiliza LindormTable 2.8.5 o posterior junto con LTS 3.8.13.5 o posterior. Para versiones anteriores, o si necesita consultar información más detallada sobre el progreso y los errores, acceda a la consola de LTS. En el panel de navegación izquierdo, elija Lindorm Search > Full Data replication to Search y consulte el valor del parámetro State, así como otros detalles de la tarea. Para consultar o actualizar su versión actual, consulte Upgrade the minor engine version of a Lindorm instance. Si no logra actualizar a una versión compatible desde la consola, comuníquese con el soporte técnico de Lindorm (ID de DingTalk: s0s3eg3).
INDEX_TYPE	Tipo de índice. Valores válidos: SECONDARY: el índice es un índice secundario. SEARCH: el índice es un search index.
INDEX_COVERED	Indica si el índice contiene columnas incluidas. Índice secundario: devuelve `TRUE` si el índice tiene columnas incluidas y `FALSE` en caso contrario. Nota Para más información sobre las columnas incluidas, consulte Secondary indexes. search index: siempre devuelve `NA`. Este tipo de índice no admite columnas incluidas.
INDEX_COLUMN	Columnas del índice.
INDEX_TTL	TTL de los datos indexados. Unidad: segundos. Importante Si no se configura el TTL de los datos indexados, este campo queda vacío para un índice secundario y muestra 0 para un search index.
INDEX_DESCRIPTION	Información adicional sobre el índice. Índice secundario: estos índices no tienen información adicional. El valor de este campo queda vacío. search index: estos índices no tienen información adicional. El valor de este campo queda vacío.

Ejemplos

En el siguiente ejemplo, la tabla base y el índice se crean al ejecutar estas instrucciones:

-- 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.
CREATE INDEX idx1 ON test(c1 desc) include(c3,c4) WITH (COMPRESSION='ZSTD');

-- Create a search index named idx2.
CREATE INDEX IF NOT EXISTS idx2 USING SEARCH ON test(p1, p2, c1, c2, c3);

Ejecute la siguiente instrucción para consultar todos los índices de la tabla test:

SHOW INDEX FROM test;

Se devuelve el siguiente resultado:

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