Tablestore:Actualizar columnas de atributos de una tabla de mapeo

Se inicializó una instancia de OTSClient. Para obtener más información, consulte Initialize an OTSClient instance.

Se creó una tabla de mapeo. Para obtener más información, consulte Create mapping tables.

La instrucción ALTER TABLE solo permite actualizar una columna de atributos en una tabla de mapeo creada mediante la instrucción CREATE TABLE. No es posible usar ALTER TABLE para modificar columnas de atributos en tablas de mapeo generadas automáticamente por la instrucción DESCRIBE.

Con la instrucción ALTER TABLE se agrega o elimina únicamente una columna de atributos por ejecución. Si necesita agregar o quitar varias columnas de atributos en una tabla de mapeo, ejecute la instrucción ALTER TABLE tantas veces como sea necesario.

La instrucción ALTER TABLE actualiza exclusivamente el esquema de la tabla de mapeo. El esquema de la tabla de Tablestore asociada a dicha tabla de mapeo no se modifica.

No utilice la instrucción ALTER TABLE para agregar ni eliminar las columnas de clave principal de una tabla de mapeo.

Tras ejecutar la instrucción ALTER TABLE, el motor SQL refresca la tabla de mapeo de forma asíncrona. Este proceso puede tardar hasta 30 segundos. Durante el periodo de refresco, es posible que la columna agregada no aparezca en operaciones diseñadas para devolver todas las columnas.

Agregar una columna de atributos a una tabla de mapeo

El siguiente código de ejemplo muestra cómo agregar la columna colvalue de tipo BIGINT a una tabla de mapeo llamada exampletable:

/// <summary>
/// Add the colvalue column of the BIGINT type to a mapping table named exampletable. 
/// </summary>
/// <param name="otsClient"></param>
public static void AlterTableAddColumn(OTSClient otsClient)
{
    SQLQueryRequest sqlQueryRequest = new SQLQueryRequest("alter table exampletable add column colvalue bigint");
    otsClient.SQLQuery(sqlQueryRequest);
}

Eliminar una columna de atributos de una tabla de mapeo

El siguiente código de ejemplo muestra cómo eliminar la columna colvalue de tipo BIGINT de una tabla de mapeo llamada exampletable:

/// <summary>
/// Remove the colvalue column of the BIGINT type from a mapping table named exampletable.  
/// </summary>
/// <param name="otsClient"></param>
public static void AlterTableDropColumn(OTSClient otsClient)
{
    SQLQueryRequest sqlQueryRequest = new SQLQueryRequest("alter table exampletable drop column colvalue");
    otsClient.SQLQuery(sqlQueryRequest);
}

Después de actualizar las columnas de atributos de una tabla de mapeo, ejecute la instrucción SELECT para consultar y analizar datos mediante dicha tabla. Para obtener más información, consulte Query data.

Para consultar la descripción de una tabla, ejecute la instrucción DESCRIBE. Para obtener más información, consulte Query information about tables.

Si ya no necesita una tabla de mapeo creada para una tabla o un índice de búsqueda, ejecute la instrucción DROP MAPPING TABLE para eliminarla. Para obtener más información, consulte Delete mapping tables.

Para consultar la información de índices de una tabla, ejecute la instrucción SHOW INDEX. Para obtener más información, consulte Query index information about tables.

Para obtener los nombres de las tablas de mapeo en la base de datos actual, ejecute la instrucción SHOW TABLES. Para obtener más información, consulte List the names of tables.