Tablestore:Update attribute columns of a mapping table

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 permite actualizar una columna de atributo únicamente en tablas de mapeo creadas con la instrucción CREATE TABLE. No es posible usar ALTER TABLE para modificar columnas de atributo en tablas de mapeo que se generaron automáticamente mediante la instrucción DESCRIBE.

• Con la instrucción ALTER TABLE solo se agrega o quita una columna de atributo por ejecución. Si necesita modificar varias columnas de atributo 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 asociada a dicha tabla de mapeo no se modifica.

• No es posible utilizar 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 atributo

  A continuación se muestra cómo agregar una columna colvalue de tipo BIGINT a una tabla de mapeo llamada exampletable:

  const params = {
    query: "alter table exampletable add column colvalue bigint",
  }
  
  client.sqlQuery(params, function (err, data) {
    if (err) {
      console.log('sqlQuery error:', err.toString());
    } else {
      console.log('sqlQuery success:', data);
    }
  });

• Quitar una columna de atributo

  El siguiente ejemplo elimina la columna colvalue de una tabla de mapeo llamada exampletable:

  const params = {
    query: "alter table exampletable drop column colvalue",
  }
  
  client.sqlQuery(params, function (err, data) {
    if (err) {
      console.log('sqlQuery error:', err.toString());
    } else {
      console.log('sqlQuery success:', data);
    }
  });

Preguntas frecuentes

• What do I do if the "Unsupported operation: Unsupported alter non-mapping table" error message is returned when I update the attribute columns of a mapping table?

• Troubleshoot common SQL query errors

Pasos siguientes

• Se admite la optimización de selección de índices y el pushdown de cómputo (Query optimization).

• Ejecute la instrucción SELECT para consultar y analizar datos mediante la tabla de mapeo. Para obtener más información, consulte Query data.

• Ejecute la instrucción DESCRIBE para consultar los detalles de la tabla. Para obtener más información, consulte Query information about tables.

• Ejecute la instrucción DROP MAPPING TABLE para eliminar una tabla de mapeo creada para una tabla o un índice de búsqueda. Para obtener más información, consulte Delete mapping tables.

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

• Ejecute la instrucción SHOW TABLES para listar las tablas de mapeo de la base de datos actual. Para obtener más información, consulte List the names of tables.