Todos os produtos
Search

Este produto

    Tablestore:UpdateTable

    Central de documentação

    Tablestore:UpdateTable

    Última atualização: Jul 03, 2026

    Chame a operação UpdateTable para modifique as informações de configuração definidas pelo parâmetro table_options e as configurações de Stream especificadas pelo parâmetro StreamSpecification de uma tabela de dados. Se a tabela de dados estiver em uma instância de alto desempenho no modo CU (antigo modo pay-as-you-go), também é possível modifique o throughput de leitura ou gravação reservado definido pelo parâmetro reserved_throughput. O novo throughput de leitura ou gravação reservado entra em vigor em até 1 minuto após uma atualização bem-sucedida.

    no modo CU (antigo modo pay-as-you-go)

    Sintaxe da solicitação

    message UpdateTableRequest {
    required string table_name = 1;
    optional ReservedThroughput reserved_throughput = 2;
    optional TableOptions table_options = 3;
    optional StreamSpecification stream_spec = 4;
}

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    table_name

    string

    Sim

    Nome da tabela de dados cujo throughput de leitura ou gravação reservado será modificado.

    reserved_throughput

    ReservedThroughput

    Não

    Novo throughput de leitura ou gravação reservado da tabela de dados. Esse valor entra em vigor em até 1 minuto após uma atualização bem-sucedida.

    Especifique um valor não nulo para o throughput de leitura ou gravação reservado usando o parâmetro capacity_unit. Caso contrário, a solicitação falhará e retornará um erro.

    table_options

    TableOptions

    Não

    Configurações de tempo de vida (TTL) e número máximo de versões.

    StreamSpecification

    StreamSpecification

    Não

    Informações de Stream da tabela de dados, incluindo se o recurso Stream está ativado e o período de validade dos logs.

    Sintaxe da resposta

    message UpdateTableResponse {
    required ReservedThroughputDetails reserved_throughput_details = 1;
    required TableOptions table_options = 2;
    optional StreamDetails stream_details = 3;
}

    Parâmetro

    Tipo

    Descrição

    capacity_unit_details

    ReservedThroughputDetails

    Configurações de throughput de leitura ou gravação reservado da tabela de dados após uma atualização bem-sucedida. Incluem o valor mais recente do throughput reservado, o horário da última atualização desse valor e a quantidade de reduções realizadas no dia atual.

    Nota

    • O intervalo mínimo para atualize o throughput de leitura ou gravação reservado de uma tabela de dados é de 2 minutos. Se você chamar a operação UpdateTable novamente dentro de 2 minutos após a chamada anterior, a operação falhará.

    • É possível aumentar ou diminuir o throughput de leitura ou gravação reservado de uma tabela de dados quantas vezes quiser durante um único dia (de 00:00:00 a 00:00:00 do dia seguinte, no horário UTC).

    table_options

    TableOptions

    Valor mais recente do parâmetro table_options após a atualização.

    stream_details

    StreamDetails

    Informações de Stream da tabela de dados, incluindo se o recurso Stream está ativado, o período de validade dos logs e a última vez em que o recurso Stream foi ativado.

    Usar SDKs do Tablestore

    Use os seguintes SDKs do Tablestore para atualize uma tabela de dados: