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 a atualização, 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 código de exemplo abaixo demonstra como adicionar a coluna colvalue, do tipo BIGINT, a uma tabela de mapeamento chamada 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);
  }

• Remover uma coluna de atributo de uma tabela de mapeamento

  O exemplo a seguir ilustra a remoção da coluna colvalue, do tipo BIGINT, de uma tabela de mapeamento denominada 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);
  }

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, utilize a instrução SELECT para consultar e analisar dados por meio da tabela de mapeamento. Para mais informações, consulte Consultar dados.

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

• Caso não precise mais de uma tabela de mapeamento associada a uma tabela ou índice de pesquisa, use a instrução DROP MAPPING TABLE para excluí-la. Para mais informações, consulte Excluir tabelas de mapeamento.

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

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