Python SDK更新时序表配置_表格存储(Tablestore)-阿里云帮助中心

通过调用UpdateTimeseriesTable接口，您可以更新时序表或时间线元数据的配置信息，例如数据生命周期（Time To Live，简称TTL）配置。

注意事项

表格存储Python 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)