更新表配置

本文介绍如何通过 Python SDK 更新表的配置信息。

前提条件

初始化Tablestore Client

方法说明

def update_table(self, table_name, table_options=None, reserved_throughput=None)

参数说明

  • table_name(必选)str:数据表名称。

  • table_options(可选)TableOptions:表配置信息,包含以下参数。

    名称

    类型

    说明

    time_to_live(可选)

    int

    数据生命周期,单位为秒,默认值为-1。

    设置为-1时表示数据永不过期,否则取值最低为86400(1天),超出生命周期的数据将会被自动清除。

    如果要使用多元索引或二级索引功能,必须将数据生命周期设置为-1,或者将AllowUpdate参数设置为False。

    max_version(可选)

    int

    最大版本数,默认值为1。

    • 如果要使用多元索引或二级索引,最大版本数必须设置为1。

    max_time_deviation(可选)

    int

    有效版本偏差,单位为秒,默认值为86400(1天)。

    • 写入数据的时间戳与系统当前时间的差值必须在有效版本偏差范围内,否则写入数据将会失败。

    • 属性列数据的有效版本范围为[max(数据写入时间-有效版本偏差, 数据写入时间-数据生命周期), 数据写入时间+有效版本偏差)

    allow_update(可选)

    bool

    是否允许更新,默认值为True。

    • 设置为False时,无法通过UpdateRow()方法更新数据。

  • reserved_throughput(可选)ReservedThroughput预留读写吞吐量,单位为CU,默认值为0,仅CU模式的高性能型实例可以设置且有效。

说明

调用update_table()方法时,必须设置table_optionsreserved_throughput中的至少一项。

示例代码

以下示例代码用于修改test_table表的配置信息。

# 构造数据表的配置信息
table_options = TableOptions(time_to_live=86400, max_version=3, max_time_deviation=86400, allow_update=False)

# 设置预留读为0CU,预留写为0CU(仅CU模式高性能实例支持设置数据表的预留读写吞吐量为非零值)
reserved_throughput = ReservedThroughput(CapacityUnit(0,0))

try:
    # 发起请求
    client.update_table('test_table', table_options, reserved_throughput)
    print("Update table succeeded.")
except Exception as e:
    print("Update table failed. %s" % e)

相关文档

更新时序表配置