Tablestore:Atualizar colunas de atributo de uma tabela de mapeamento

Pré-requisitos

• Instância OTSClient inicializada. Para mais informações, consulte Inicializar uma instância OTSClient.

• Tabela de mapeamento criada. Para mais informações, consulte Criar tabelas de mapeamento.

Observações de uso

• A instrução ALTER TABLE atualiza colunas de atributo apenas em tabelas de mapeamento criadas com a instrução CREATE TABLE. Não é possível usar ALTER TABLE para modificar colunas de atributo em tabelas de mapeamento geradas automaticamente pela instrução DESCRIBE.

• Cada execução da instrução ALTER TABLE permite adicionar ou remover somente uma coluna de atributo. Para alterar múltiplas colunas, execute a instrução ALTER TABLE repetidamente.

• A instrução ALTER TABLE modifica exclusivamente o esquema da tabela de mapeamento, sem afetar o esquema da tabela do Tablestore associada.

• Não use a instrução ALTER TABLE para adicionar ou remover colunas de chave primária em uma tabela de mapeamento.

• Após a execução da instrução ALTER TABLE, o mecanismo SQL atualiza a tabela de mapeamento de forma assíncrona. Esse processo pode levar até 30 segundos. Durante esse período, operações que retornam todas as colunas podem não incluir a coluna recém-adicionada.

Parâmetros

Exemplos

• Adicionar uma coluna de atributo

  O exemplo abaixo adiciona uma coluna colvalue do tipo BIGINT à tabela de mapeamento chamada 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);
    }
  });

• Remover uma coluna de atributo

  Este exemplo remove a coluna colvalue da tabela de mapeamento denominada 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);
    }
  });

FAQ

• O que fazer se a mensagem de erro "Unsupported operation: Unsupported alter non-mapping table" for retornada ao atualizar as colunas de atributo de uma tabela de mapeamento?

• Como solucionar erros comuns de consultas SQL?

Próximos passos

• Execute a instrução SELECT para consultar e analisar dados por meio da tabela de mapeamento. Para mais informações, consulte Consultar dados.

• Use a instrução DESCRIBE para visualizar detalhes da tabela. Para mais informações, consulte Consultar informações sobre tabelas.

• Execute a instrução DROP MAPPING TABLE para excluir uma tabela de mapeamento associada a uma tabela ou índice de pesquisa. Para mais informações, consulte Excluir tabelas de mapeamento.

• Use a instrução SHOW INDEX para verificar informações de índice de uma tabela. Para mais informações, consulte Consultar informações de índice sobre tabelas.

• Execute a instrução SHOW TABLES para listar as tabelas de mapeamento no banco de dados atual. Para mais informações, consulte Listar os nomes das tabelas.