Atualizar a configuração de uma tabela de séries temporais usando o SDK do Python - Tablestore: Central de Documentação do Alibaba Cloud

Use a operação UpdateTimeseriesTable para atualizar a configuração de uma tabela de séries temporais ou os metadados da linha do tempo, como o tempo de vida (TTL).

Precauções

O recurso de modelo de séries temporais está disponível no Tablestore Python SDK 6.1.0 ou posterior. Use uma versão compatível do SDK do Python.

Nota
Para mais informações sobre o histórico de versões do SDK do Python, consulte Python SDK release history.
Não é possível alterar simultaneamente a configuração da tabela de séries temporais (timeseries_table_options) e a dos metadados da linha do tempo (timeseries_meta_options). Modifique apenas uma dessas configurações por chamada.

Pré-requisitos

Initialize the Tablestore client.

Parâmetros

Parâmetro

Descrição

table_meta (Obrigatório)

Estrutura da tabela de séries temporais. Inclui os seguintes parâmetros:

timeseries_table_name (Obrigatório): nome da tabela de séries temporais.
timeseries_table_options (opcional): configuração da tabela de séries temporais. Inclui o seguinte parâmetro:
- time_to_live (Obrigatório): ciclo de vida dos dados na tabela de séries temporais. Define quando os dados expiram. Unidade: segundos.
  
  O ciclo de vida mínimo é de 86400 segundos (1 dia). Defina este parâmetro como -1 para que os dados nunca expirem.
timeseries_meta_options (opcional): configuração dos metadados da linha do tempo. Inclui os seguintes parâmetros:
- meta_time_to_live (Obrigatório): ciclo de vida dos metadados da linha do tempo. Define quando a linha do tempo expira. Unidade: segundos.
  
  O ciclo de vida mínimo é de 604800 segundos (7 dias). Defina este parâmetro como -1 para que a linha do tempo nunca expire.
  
  Importante
  O ciclo de vida dos metadados da linha do tempo deve ser maior ou igual ao ciclo de vida dos dados da tabela de séries temporais.
- allow_update_attributes (Obrigatório): indica se as atualizações nos atributos dos metadados da linha do tempo são permitidas. Valores válidos:
  Importante
  - Se meta_time_to_live não for -1, defina allow_update_attributes como False. Isso impede a atualização dos atributos dos metadados da linha do tempo.
  - Se definir allow_update_attributes como True, configure meta_time_to_live como -1 (nunca expira).
  - True: permite a operação.
  - False: não permitido.

Exemplo

O exemplo a seguir mostra como atualizar o TTL de uma tabela de séries temporais.

try:
    # The data lifecycle of the time series table is 604800 seconds (7 days).
    tableOption = TimeseriesTableOptions(604800)
    tableMeta = TimeseriesTableMeta("<TIMESERIES_TABLE_NAME>", tableOption)

    # Call the operation to update the time series table.
    otsClient.update_timeseries_table(tableMeta)
    print("update timeseries table success.")
except Exception as e:
    # If an exception is thrown, the execution failed. Handle the exception.
    print("update timeseries table failed. %s" % e)