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

Ao chamar a operação UpdateTimeseriesTable, é possível atualizar as informações de configuração de uma tabela de séries temporais ou dos metadados de séries temporais, como a configuração de tempo de vida (TTL).

Observações de uso

O modelo TimeSeries é compatível com o Tablestore SDK for Python V6.1.0 e versões posteriores. Certifique-se de ter obtido a versão correta do Tablestore SDK for Python.

Nota
Para mais informações, consulte Histórico de versões do SDK para Python.
Não é possível alterar simultaneamente as informações de configuração da tabela de séries temporais (timeseries_table_options) e os metadados de séries temporais (timeseries_meta_options). Em uma única chamada, altere apenas um desses itens.

Pré-requisitos

Um cliente Tablestore deve estar inicializado. Para mais informações, consulte Inicializar um cliente Tablestore.

Parâmetros

Parâmetro

Descrição

table_meta (Obrigatório)

Informações de esquema da tabela de séries temporais. O esquema inclui os seguintes itens:

timeseries_table_name (obrigatório): nome da tabela de séries temporais.
timeseries_table_options (opcional): informações de configuração da tabela de séries temporais, compostas pelos seguintes itens:
- time_to_live (obrigatório): período de retenção dos dados na tabela de séries temporais. Unidade: segundos.
  O período mínimo de retenção de dados em uma tabela de séries temporais é de 86.400 segundos (um dia). Também é possível definir time_to_live como -1, o que indica que os dados da tabela nunca expiram.
timeseries_meta_options (opcional): informações de configuração dos metadados de séries temporais, compostas pelos seguintes itens:
- meta_time_to_live (obrigatório): período de retenção dos metadados de séries temporais. Unidade: segundos.
  O período mínimo de retenção dos metadados de séries temporais é de 604.800 segundos (sete dias). Também é possível definir meta_time_to_live como -1, o que indica que os metadados nunca expiram.
  Importante
  O valor de TTL dos metadados de séries temporais deve ser maior ou igual ao valor de TTL dos dados na tabela de séries temporais.
- allow_update_attributes (obrigatório): especifica se as atualizações de atributos dos metadados de séries temporais são permitidas. Valores válidos:
  Importante
  - Se meta_time_to_live estiver definido com um valor diferente de -1, defina allow_update_attributes como False, o que impede atualizações nos atributos dos metadados de séries temporais.
  - Para definir allow_update_attributes como True, garanta que o valor de meta_time_to_live seja -1.
  - True: permite atualizações nos atributos dos metadados de séries temporais.
  - False: não permite atualizações nos atributos dos metadados de séries temporais.

Exemplo

O código de exemplo a seguir demonstra como atualizar o TTL de uma tabela de séries temporais:

try:
    # Set the TTL of data in the time series table to 604,800 seconds (seven days).
    tableOption = TimeseriesTableOptions(604800)
    tableMeta = TimeseriesTableMeta("", 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 update fails. Handle the exception.
    print("update timeseries table failed. %s" % e)