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 modificar várias colunas, execute a instrução ALTER TABLE múltiplas vezes.

• O comando ALTER TABLE altera 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, à tabela de mapeamento exampletable:

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

• Remover uma coluna de atributo de uma tabela de mapeamento

  O trecho de código a seguir ilustra a remoção da coluna colvalue, do tipo BIGINT, da tabela de mapeamento exampletable:

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

Perguntas frequentes

• 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 em consultas SQL?

Referências

• Após atualizar as colunas de atributo, use 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, execute a instrução SHOW TABLES. Para mais informações, consulte Listar os nomes das tabelas.