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.

• O comando ALTER TABLE modifica exclusivamente o esquema da tabela de mapeamento. O esquema da tabela do Tablestore associada permanece inalterado.

• Não utilize 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 a uma tabela de mapeamento

  O exemplo abaixo adiciona uma coluna colvalue do tipo BIGINT à tabela de mapeamento chamada exampletable:

  def alter_table_add_column(client):
      query = 'alter table exampletable add column colvalue bigint'
      client.exe_sql_query(query)
  

• Remover uma coluna de atributo de uma tabela de mapeamento

  O exemplo a seguir remove a coluna colvalue da tabela de mapeamento denominada exampletable:

  def alter_table_drop_column(client):
      query = 'alter table exampletable drop column colvalue'
      client.exe_sql_query(query)
  

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?

Referências

• Após atualizar as colunas de atributo, use a instrução SELECT para consultar e analisar dados. Para mais informações, consulte Consultar dados.

• Para visualizar a descrição de uma tabela, use a instrução DESCRIBE. Para mais informações, consulte Consultar informações sobre tabelas.

• Para excluir uma tabela de mapeamento desnecessária, execute a instrução DROP MAPPING TABLE. Para mais informações, consulte Excluir tabelas de mapeamento.

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

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