全部产品
Search
文档中心

表格存储:查询时序表描述信息

更新时间:Apr 03, 2025

通过调用DescribeTimeseriesTable接口,您可以查询时序表的描述信息,例如数据生命周期(Time To Live,简称TTL)、时序表状态和时间线元数据配置等。

注意事项

表格存储Python SDK从6.1.0版本开始支持时序模型功能,请确保已获取正确的Python SDK版本。

说明

关于Python SDK历史迭代版本的详细信息,请参见Python SDK历史迭代版本

前提条件

初始化Tablestore Client

参数说明

参数

说明

timeseries_table_name

时序表名称。

示例

以下示例用于查询指定时序表的描述信息。

try:
    # 调用接口查询时序表描述信息。
    describe_response = ots_client.describe_timeseries_table('<TIMESERIES_TABLE_NAME>')
    table_meta = describe_response.table_meta

    # 打印时序表信息。
    # 时序表名称
    print('TimeseriesTableName: %s.' % table_meta.timeseries_table_name)
    # 时序表状态
    print('TimeseriesTableStatus: %s.' % table_meta.status)
    # 时序表的TTL配置
    print('TimeseriesTableTTL: %s.' % table_meta.timeseries_table_options.time_to_live)
    # 时间线元数据TTL配置
    print('TimeseriesMetaTTL: %s.' % table_meta.timeseries_meta_options.meta_time_to_live)
    # 时间线元数据属性列是否允许更新
    print('AllowUpdateTimeseriesMetaAttributes: %s.' % table_meta.timeseries_meta_options.allow_update_attributes)
except Exception as e:
    # 如果抛出异常,则说明执行失败,处理异常。
    print("describe timeseries table failed. %s" % e)