Python SDK更新時序表配置 - Tablestore

通過調用UpdateTimeseriesTable介面，您可以更新時序表或時間軸中繼資料的配置資訊，例如資料生命週期（Time To Live，簡稱TTL）配置。

注意事項

Table StorePython SDK從6.1.0版本開始支援時序模型功能，請確保已擷取正確的Python SDK版本。
說明
關於Python SDK歷史迭代版本的詳細資料，請參見Python SDK歷史迭代版本。
不支援同時變更時序表的配置資訊（timeseries_table_options）和時間軸中繼資料的配置資訊（timeseries_meta_options），單次調用只支援變更其中一項。

前提條件

初始化Tablestore Client。

參數說明

參數

說明

table_meta（必選）

時序表的結構資訊。包含以下內容：

timeseries_table_name（必選）：時序表名稱。
timeseries_table_options（可選）：時序表的配置資訊。包括以下內容：
- time_to_live（必選）：時序表資料的生命週期，即時序表資料的到期時間，單位為秒。
  時序表資料的生命週期最低為86400秒（1天），也可以設定為-1（永不到期）。
timeseries_meta_options（可選）：時間軸中繼資料的配置資訊。包括以下內容：
- meta_time_to_live（必選）：時間軸中繼資料生命週期，即時間軸的到期時間，單位為秒。
  時間軸中繼資料生命週期最低為604800秒（7天）或者-1（永不到期）。
  重要
  時間軸中繼資料生命週期的取值必須大於或等於時序表的資料生命週期。
- allow_update_attributes（必選）：是否允許更新時間軸中繼資料屬性。取值範圍如下：
  重要
  - 如果meta_time_to_live為非-1的值，則必須將allow_update_attributes設定為False，即不允許更新時間軸中繼資料屬性。
  - 如果您要將allow_update_attributes配置為True，則您必須保證meta_time_to_live的值為-1（永久）。
  - True：允許。
  - False：不允許。

樣本

以下樣本用於更新指定時序表的TTL。

try:
    # 時序表資料的生命週期604800秒（7天）。
    tableOption = TimeseriesTableOptions(604800)
    tableMeta = TimeseriesTableMeta("<TIMESERIES_TABLE_NAME>", tableOption)

    # 調用介面更新時序表。
    otsClient.update_timeseries_table(tableMeta)
    print("update timeseries table success.")
except Exception as e:
    # 如果拋出異常，則說明執行失敗，處理異常。
    print("update timeseries table failed. %s" % e)