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

BUILD INDEX desencadena la compilación de un índice secundario después de que usted envíe una tarea de compilación de índices asíncrona. Aplica únicamente a las versiones de LindormTable posteriores a la 2.2.16 e iguales o anteriores a la 2.6.3.

Compatibilidad de versiones

El comportamiento de BUILD INDEX varía según la versión de LindormTable:

Versión de LindormTable	Comportamiento
> 2.2.16 y ≤ 2.6.3	Después de enviar una tarea de compilación de índices asíncrona, ejecute `BUILD INDEX` por separado para desencadenar la compilación.
> 2.6.3	No es obligatorio `BUILD INDEX`. La creación del índice se gestiona automáticamente después de iniciar la solicitud de compilación asíncrona.

Sintaxis

BUILD INDEX [ index_identifier ]
    ON table_identifier

Parámetro	Descripción
`index_identifier`	Nombre del índice que se va a compilar. Ejecute `SHOW INDEX` para listar todos los índices de una tabla.
`table_identifier`	Nombre de la tabla para la cual se compilará el índice.

Notas de uso

Límites de concurrencia

LindormTable aplica los siguientes límites a las tareas de compilación de índices simultáneas:

Se permite un máximo de 2 tareas de compilación de índices ejecutándose al mismo tiempo en todas las tablas.
Solo se admite 1 tarea de compilación de índices por tabla a la vez.

Esto significa que dos tareas se ejecutan de forma simultánea únicamente si cada una apunta a una tabla distinta.

Nota

Si usted envía dos o más tareas para la misma tabla, solo la primera se completa correctamente. Las tareas adicionales fallan con errores de inmediato. Para ejecutar otra tarea en esa tabla, espere hasta que la primera alcance INDEX_STATE = ACTIVE y INDEX_PROGRESS = 100%. Luego, envíe una nueva instrucción BUILD INDEX.

De igual manera, si ya hay dos tareas ejecutándose en dos tablas distintas, cualquier tarea adicional falla con errores hasta que ambas finalicen.

Estado de la compilación del índice

Utilice SHOW INDEX para supervisar el progreso de la compilación del índice. A continuación se muestran los campos que indican el estado actual de una compilación:

Campo	Valor	Significado
`INDEX_STATE`	`BUILDING`	La tarea no se inició debido a un conflicto de concurrencia.
`INDEX_STATE`	`ACTIVE`	El índice se compiló correctamente y está listo para usarse.
`INDEX_PROGRESS`	`N/A`	La tarea falló con errores porque se excedió el límite de concurrencia.
`INDEX_PROGRESS`	`100%`	La compilación finalizó correctamente.

Ejemplo

Compile un índice secundario llamado idx1 en la tabla test:

BUILD INDEX idx1 ON test;

Compruebe el resultado

Ejecute la siguiente instrucción para confirmar que el índice se compiló correctamente:

SHOW INDEX FROM test;

El índice está listo cuando INDEX_STATE es ACTIVE y INDEX_PROGRESS es 100%.