Atualizar configurações de tabela - Tablestore SDK for Python - Tablestore: Central de Documentação do Alibaba Cloud

Pré-requisitos

Instale o Tablestore SDK for Python e inicialize um cliente.

Descrição da função

Chame o método update_table para atualizar as configurações da tabela. Especifique pelo menos um dos parâmetros: table_options ou reserved_throughput.

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

O exemplo a seguir altera o TTL da example_table para sete dias e desabilita atualizações pelo método update_row.

table_options = TableOptions(
    time_to_live=604800,
    max_version=1,
    max_time_deviation=86400,
    allow_update=False,
)

client.update_table(
    "example_table",
    table_options=table_options,
)

Parâmetros

O método update_table inclui os seguintes parâmetros.

Nome	Tipo	Descrição
table_name (obrigatório)	`str`	Nome da tabela.
table_options (opcional)	`TableOptions`	Configurações da tabela a serem atualizadas. Especifique pelo menos este parâmetro ou `reserved_throughput`.
reserved_throughput (opcional)	`ReservedThroughput`	Throughput reservado a ser atualizado. Defina pelo menos este parâmetro ou `table_options`.

Configurações de tabela

O parâmetro table_options é do tipo TableOptions e contém os seguintes campos.

Nome	Tipo	Descrição
time_to_live (opcional)	`int`	TTL dos dados em segundos. O valor `-1` indica que os dados nunca expiram. Para outros valores, o mínimo é `86400` (um dia). O sistema exclui automaticamente os dados expirados. Para usar um índice de pesquisa ou 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 retidas para cada coluna de atributo. Defina como `1` caso utilize índices de pesquisa ou secundários.
max_time_deviation (opcional)	`int`	Desvio máximo de versão em segundos. A diferença entre o timestamp dos dados a serem gravados e a hora atual do sistema deve estar dentro desse limite. O intervalo válido de versão é `[max(data write time - maximum version deviation, data write time - TTL), data write time + maximum version deviation)`.
allow_update (opcional)	`bool`	Indica se é possível atualizar dados ao chamar o método `update_row`. Se definido como `False`, o sistema bloqueia atualizações de dados via `update_row`.

Throughput reservado

O parâmetro reserved_throughput possui o tipo ReservedThroughput e inclui o seguinte campo.

Nome	Tipo	Descrição
capacity_unit (obrigatório)	`CapacityUnit`	reserved throughput em CUs. Apenas instâncias de alto desempenho no modo CU aceitam valores diferentes de zero.

Resposta

UpdateTableResponse retorna as seguintes informações comerciais.

Campo	Tipo	Descrição
table_options	`TableOptions`	Configurações atualizadas da tabela.
reserved_throughput_details	`ReservedThroughputDetails`	Throughput reservado atual, além dos horários do último aumento e da última redução.

Exemplos

Atualizar throughput reservado

O exemplo abaixo define o throughput reservado da example_table como 0 CUs.

reserved_throughput = ReservedThroughput(
    CapacityUnit(read=0, write=0)
)

client.update_table(
    "example_table",
    reserved_throughput=reserved_throughput,
)