Use a secondary index in the console to accelerate data queries - Tablestore

La función de índice secundario permite consultar datos con base en la clave principal de una tabla de datos y las columnas de índice del índice secundario creado para dicha tabla. Esto acelera las consultas de datos. Al crear un índice secundario, puede establecer las columnas de índice o las columnas de atributos del índice secundario como las columnas predefinidas que especificó para la tabla donde desea crear el índice. Una vez creado el índice secundario, puede utilizarlo para consultar datos.

Requisitos previos

Se ha creado una tabla de datos con el parámetro Max Versions establecido en 1. El parámetro TTL de la tabla de datos cumple con una de las siguientes condiciones:

El parámetro TTL de la tabla de datos está establecido en -1, lo que significa que los datos de la tabla nunca caducan.
Si el tiempo de vida (TTL) de la tabla de datos no es -1, la tabla no admite actualizaciones. Esto significa que la opción Allow Updates está establecida en No.

Nota

El TTL del índice secundario es igual al TTL de la tabla de datos.

Paso 1: (Opcional) Agregar columnas predefinidas

Si crea un índice secundario para una tabla y esta no contiene columnas predefinidas, o si las columnas predefinidas existentes no satisfacen sus requisitos empresariales, puede agregar o quitar columnas predefinidas en la tabla.

Nota

También puede agregar columnas predefinidas al crear una tabla de datos. Para obtener más información, consulte Step 3: Create a data table.

Vaya a la página Manage Table.
1. Inicie sesión en la consola de Tablestore.
2. En la página Overview, haga clic en el nombre de la instancia.
3. En la pestaña Instance Details, dentro de la sección Tables, haga clic en el nombre de la tabla de datos.
En la pestaña Basic Information, dentro de la sección Pre-defined Column del módulo Advanced Features, haga clic en Add Pre-Defined Column.
En el cuadro de diálogo Add Pre-Defined Column, haga clic en Add Pre-Defined Column y, a continuación, introduzca un nombre y seleccione un tipo de datos para la columna predefinida.
- Convenciones de nomenclatura para columnas predefinidas: El nombre debe tener una longitud de 1 a 255 bytes y puede contener letras, dígitos y guiones bajos (_). Debe comenzar con una letra o un guion bajo (_).
- Puede seleccionar STRING, INTEGER, BINARY, FLOAT o BOOLEAN como tipo de datos. Si la columna predefinida se utiliza como columna de índice, seleccione STRING, INTEGER o BINARY.
Nota
Puede hacer clic en Add Pre-Defined Column para agregar varias columnas. Para eliminar una columna no deseada, haga clic en el icono situado junto a ella.

En el cuadro de diálogo Add predefined column, Table Name muestra exampletable y Existing predefined columns muestra cost. En el área predefined column, introduzca name como nombre de columna y seleccione STRING como tipo de datos.
Haga clic en OK.

Las columnas predefinidas que agregó aparecen en la lista de columnas predefinidas.

Si desea eliminar una columna predefinida de la lista, haga clic en el icono en la columna Remove Pre-Defined Column.

Paso 2: Crear un índice secundario

Puede crear un índice secundario y utilizarlo para acelerar las consultas de datos. Los índices secundarios se dividen en índices secundarios globales e índices secundarios locales. Cree el índice según sus necesidades empresariales.

Nota

Puede crear un índice secundario al mismo tiempo que crea una tabla de datos. Para obtener más información, consulte Step 3: Create a data table.

Vaya a la página Manage Table.
1. Inicie sesión en la consola de Tablestore.
2. En la página Overview, haga clic en el nombre de la instancia.
3. En la pestaña Instance Details, dentro de la sección Tables, haga clic en el nombre de la tabla de datos.
En la pestaña Indexes, haga clic en Create a secondary index.

En el cuadro de diálogo Create Index, configure el índice secundario.

La siguiente tabla describe los parámetros.

Parámetro	Descripción
Index Type	Tipo de índice. Este valor siempre es Secondary Index.
Instance Name	Nombre de la instancia. No es posible modificar el valor de este parámetro.
Table Name	Nombre de la tabla de datos para la cual desea crear el índice secundario. No es posible modificar el valor de este parámetro.
Index Name	Nombre del índice secundario que desea crear. Importante El nombre no puede coincidir con el de tablas de datos ni tablas de series temporales existentes.
Index Type	Tipo de índice secundario. Valores válidos: Global Secondary Index: Tablestore sincroniza automáticamente los datos de las columnas indexadas y las columnas de clave principal de la tabla de datos hacia las columnas de la tabla de índices que desea crear, en modo asíncrono. La primera columna de clave principal de la tabla de índices puede ser una columna de clave principal o una columna predefinida de la tabla de datos. Local Secondary Index: Tablestore sincroniza automáticamente los datos de las columnas indexadas y las columnas de clave principal de la tabla de datos hacia las columnas de la tabla de índices que desea crear, en modo síncrono. Después de escribir datos en la tabla de datos, puede consultarlos inmediatamente en la tabla de índices. La primera columna de clave principal de la tabla de índices debe ser idéntica a la primera columna de clave principal de la tabla de datos.
Existing Data	Especifica si se incluyen los datos existentes de la tabla de datos en el índice secundario. Valores válidos: Include Existing Data Exclude Existing Data

Seleccione las columnas de clave principal en el orden deseado y haga clic en Add Primary Key Column por cada columna.

Solo las columnas predefinidas con tipos de datos STRING, INTEGER y BINARY pueden usarse como columnas de clave principal.
Seleccione las columnas predefinidas que utilizará como columnas de atributos y, a continuación, haga clic en Add Pre-defined Column.

Haga clic en OK.

El índice secundario creado aparece en la lista de índices.

Paso 3: Consultar datos

Para consultar los datos necesarios en las tablas de índices, puede usar consultas de fila única o consultas de rango.

Realizar una consulta de rango

Vaya a la página Manage Table.
1. Inicie sesión en la consola de Tablestore.
2. En la página Overview, haga clic en el nombre de la instancia.
3. En la pestaña Instance Details, dentro de la sección Tables, haga clic en el nombre de la tabla de datos.
En la pestaña Indexes, localice la tabla de índices objetivo y haga clic en Query en la columna Actions.
En el cuadro de diálogo Search, configure las condiciones de consulta.
1. Establezca Mode en Range Search.
2. De forma predeterminada, se devuelven todas las columnas. Para devolver solo columnas de atributos específicas, desactive Get All Columns e introduzca los nombres de las columnas separados por comas (,).
3. Configure los parámetros Start Primary Key Column y End Primary Key Column.
  Importante
  
  Si establece el parámetro Modes en Range Search, el rango definido por los valores inicial y final en la columna de clave principal derecha solo surte efecto cuando los valores inicial y final son iguales dentro de cada columna de clave principal izquierda. Si los valores inicial y final difieren en una columna de clave principal izquierda, el rango especificado por los valores inicial y final en la columna de clave principal derecha no tendrá efecto.
  
  El intervalo admitido para las consultas de rango es abierto por la izquierda y cerrado por la derecha.
4. Conserve el valor predeterminado del parámetro Max Versions.
5. Defina la dirección de ordenamiento de los resultados de consulta como Forward Search o Backward Search.
Haga clic en OK.

Los datos que cumplen con las condiciones de consulta se muestran en la lista de datos.

Realizar una consulta de fila única

Vaya a la página Manage Table.
1. Inicie sesión en la consola de Tablestore.
2. En la página Overview, haga clic en el nombre de la instancia.
3. En la pestaña Instance Details, dentro de la sección Tables, haga clic en el nombre de la tabla de datos.
En la pestaña Indexes, localice la tabla de índices objetivo y haga clic en Query en la columna Actions.
En el cuadro de diálogo Search, configure las condiciones de consulta.

En el cuadro de diálogo, introduzca los valores de clave principal de ejemplo: lily para name, a100001 para useid y a100001000001 para orderid.
1. Establezca Mode en Get Row.
2. De forma predeterminada, se devuelven todas las columnas. Para devolver solo columnas de atributos específicas, desactive Get All Columns e introduzca los nombres de las columnas separados por comas (,).
3. Introduzca el Primary Key Value de la fila objetivo.
  
  La integridad y precisión del valor de la clave principal afectan directamente los resultados de la consulta.
4. Conserve el valor predeterminado del parámetro Max Versions.
Haga clic en OK.

Si la fila que desea consultar existe en la tabla de índices, Tablestore devuelve los datos de dicha fila. Si la fila no se encuentra en la tabla de índices, no se devuelve ningún dato.

Preguntas frecuentes

Referencias

Puede utilizar índices secundarios mediante los SDK de Tablestore o la CLI de Tablestore. Para obtener más información, consulte Use global secondary index by using Tablestore SDK y Secondary index.
Si desea consultar datos de manera más eficiente y flexible, utilice la función de índice de búsqueda. Esta función ofrece múltiples métodos de consulta, incluidos consulta booleana, búsqueda de texto completo, consulta de prefijos y consulta difusa. Para obtener más información, consulte Overview.