Todos os produtos
Search

Este produto

    Tablestore:Atualizar colunas de atributo de uma tabela de mapeamento

    Central de documentação

    Tablestore:Atualizar colunas de atributo de uma tabela de mapeamento

    Última atualização: Jun 30, 2026

    Execute a instrução ALTER TABLE para adicionar ou remover uma coluna de atributo em uma tabela de mapeamento existente.

    Nota

    Para mais informações, consulte Atualizar colunas de atributo de tabelas de mapeamento.

    Pré-requisitos

    Antes de começar, verifique se você tem:

    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 adiciona ou remove somente uma coluna de atributo. Para alterar múltiplas colunas, execute o comando repetidamente.

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

    • 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 a atualização, operações que retornam todas as colunas podem não incluir a nova coluna adicionada.

    Parâmetros

    Parâmetro

    Descrição

    query

    A instrução SQL. Configure este parâmetro conforme o recurso desejado.

    Exemplos

    Os exemplos abaixo usam SQLQueryRequest para enviar uma instrução ALTER TABLE por meio de client.SQLQuery. O ID da solicitação na resposta confirma o sucesso da operação.

    • Adicionar uma coluna de atributo

      O código de exemplo a seguir adiciona uma coluna colvalue do tipo BIGINT à tabela de mapeamento chamada exampletable:

      func alterTableAddColumn(client *tablestore.TableStoreClient) {
    // Create an SQL request.
    request := &tablestore.SQLQueryRequest{Query: "alter table exampletable add column colvalue bigint"}

    // Obtain the response to the SQL request.
    res, err := client.SQLQuery(request)
    if err != nil {
        fmt.Println(err.Error())
    } else {
        fmt.Println(res.ResponseInfo.RequestId)
    }
}

    • Remover uma coluna de atributo

      O código de exemplo a seguir remove a coluna colvalue da tabela de mapeamento chamada exampletable:

      func alterTableDropColumn(client *tablestore.TableStoreClient) {
    // Create an SQL request.
    request := &tablestore.SQLQueryRequest{Query: "alter table exampletable drop column colvalue"}

    // Obtain the response to the SQL request.
    res, err := client.SQLQuery(request)
    if err != nil {
        fmt.Println(err.Error())
    } else {
        fmt.Println(res.ResponseInfo.RequestId)
    }
}
    Nota

    Para atualizar colunas de atributo, remova as colunas desnecessárias e adicione novas colunas conforme suas necessidades.

    FAQ

    Referências