Tablestore:Actualizar las columnas de atributos de una tabla de mapeo

Requisitos previos

• 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.

Notas de uso

• La instrucción ALTER TABLE actualiza una columna de atributos únicamente en tablas de mapeo creadas con la instrucción CREATE TABLE. No es posible usar ALTER TABLE para actualizar una columna de atributos en una tabla de mapeo que se generó automáticamente mediante la instrucción DESCRIBE.

• Con la instrucción ALTER TABLE solo se agrega o quita 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 las veces que sea necesario.

• La instrucción ALTER TABLE actualiza exclusivamente el esquema de la tabla de mapeo. El esquema de la tabla de Tablestore sobre la cual se creó dicha tabla de mapeo no se modifica.

• No utilice la instrucción ALTER TABLE para agregar o quitar las columnas de clave principal de una tabla de mapeo.

• Después de ejecutar la instrucción ALTER TABLE, el motor SQL actualiza la tabla de mapeo de forma asíncrona. Este proceso tarda hasta 30 segundos en completarse. Durante ese periodo, es posible que la columna agregada no aparezca en las operaciones diseñadas para devolver todas las columnas.

Parámetros

Ejemplos

• Agregar una columna de atributos a una tabla de mapeo

  A continuación se muestra un ejemplo de código para agregar la columna colvalue, de tipo BIGINT, a una tabla de mapeo llamada exampletable:

  $request = array(
      'query' => 'alter table exampletable add column colvalue bigint',
  );
  $response = $otsClient->sqlQuery($request);
  print json_encode($response, JSON_PRETTY_PRINT);

• Quitar una columna de atributos de una tabla de mapeo

  A continuación se muestra un ejemplo de código para quitar la columna colvalue, de tipo BIGINT, de una tabla de mapeo llamada exampletable:

  $request = array(
      'query' => 'alter table exampletable drop column colvalue',
  );
  $response = $otsClient->sqlQuery($request);
  print json_encode($response, JSON_PRETTY_PRINT);

Preguntas frecuentes

• Troubleshoot common SQL query errors

Referencias

• Cree un índice secundario o de búsqueda para acelerar las consultas y los cálculos de datos SQL. Para obtener más información, consulte Index selection policy y Computing pushdown.

• Una vez actualizadas las columnas de atributos de la 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.

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

• Cuando una tabla de mapeo creada para una tabla o un índice de búsqueda deje de ser necesaria, elimínela con la instrucción DROP MAPPING TABLE. 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.

• Si desea consultar 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.