Todos os produtos
Search
Central de documentação

Tablestore:Atualizar as configurações de uma tabela

Última atualização: Jul 03, 2026

Use o Tablestore SDK for Python para atualizar configurações da tabela, como tempo de vida (TTL), versão máxima e throughput reservado.

Pré-requisitos

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

Descrição do método

def update_table(self, table_name, table_options=None, reserved_throughput=None)

Parâmetros

  • table_name (obrigatório) str: nome da tabela de dados.

  • table_options (opcional) TableOptions: configurações da tabela. Inclui os seguintes parâmetros:

    Parâmetro

    Tipo

    Descrição

    time_to_live (opcional)

    int

    Tempo de vida (TTL) dos dados, em segundos. Padrão: -1.

    Defina como -1 para manter os dados indefinidamente. Qualquer outro valor deve ser de pelo menos 86400 (um dia). O sistema exclui automaticamente os dados que excederem o TTL.

    Para usar recursos de índice de pesquisa ou índice secundário, defina este parâmetro como -1 ou configure allow_update como False.

    max_version (opcional)

    int

    Número máximo de versões. Padrão: 1.

    • Para usar recursos de índice de pesquisa ou índice secundário, defina este parâmetro como 1.

    max_time_deviation (opcional)

    int

    Desvio máximo de versão, em segundos. Padrão: 86400 (um dia).

    • A diferença entre a hora atual do sistema e o timestamp dos dados gravados deve estar dentro deste desvio. Gravações fora desse intervalo falham.

    • O intervalo de versão válido para dados de coluna de atributo é [max(Data written time - Maximum version offset, Data written time - TTL), Data written time + Maximum version offset).

    allow_update (opcional)

    bool

    Indica se as atualizações de linha são permitidas. Padrão: True.

    • Defina como False para impedir atualizações de linha pelo método UpdateRow().

  • reserved_throughput (opcional) ReservedThroughput: throughput reservado de leitura e gravação, em unidade de capacidade (CU). Padrão: 0. Aplica-se apenas a instâncias de alto desempenho no modo CU.

Nota

Ao chamar update_table(), especifique pelo menos um dos parâmetros: table_options ou reserved_throughput.

Código de exemplo

O exemplo a seguir atualiza as configurações da tabela test_table.

# Set table configurations: TTL of 1 day, max 3 versions, max time deviation of 1 day, updates disabled
table_options = TableOptions(time_to_live=86400, max_version=3, max_time_deviation=86400, allow_update=False)

# Set reserved read and write throughput to 0 CUs
# Non-zero values are only supported for high-performance instances in CU mode
reserved_throughput = ReservedThroughput(CapacityUnit(0, 0))

try:
    client.update_table('test_table', table_options, reserved_throughput)
    print("Update table succeeded.")
except Exception as e:
    print("Update table failed. %s" % e)

Referências

Atualizar uma tabela de séries temporais