文档

更新表

更新时间:

使用更新表(UpdateTable)接口更新指定表的最大版本数等设置。对于高性能实例下的表,您还可以更新指定表的预留读吞吐量或预留写吞吐量。

接口

"""
说明:更新表属性,目前只支持修改预留读写吞吐量。
``table_name``是对应的表名。
``table_options``是``tablestore.metadata.TableOptions``类的示例,它包含time_to_live,max_version和max_time_deviation三个参数。
``reserved_throughput``是``ots2.metadata.ReservedThroughput``类的实例,表示预留读写吞吐量。

返回:针对该表的预留读写吞吐量的最近上调时间、最近下调时间和当天下调次数。

``update_table_response``表示更新的结果,是ots2.metadata.UpdateTableResponse类的实例。
"""
def update_table(self, table_name, table_options, reserved_throughput):

参数

更多信息,请参见创建数据表

示例

更新容量型实例下的表配置

以下示例用于更新表的最大版本数为5。

# 创建TableOptions,数据保留31536000秒,超过后自动删除;最大5个版本;写入时指定的版本值和当前标准时间相差不能超过1天。
table_options = TableOptions(31536000, 5, 86400)

try:
    # 调用接口更新表的预留读写吞吐量。
    ots_client.update_table('SampleTable', table_options, None)
    # 如果没有抛出异常,则说明执行成功。
    print("update table succeeded")
except Exception:
    # 如果抛出异常,则说明执行失败,处理异常。
    print("update table failed")

详细代码请参见UpdateTable@GitHub

更新高性能实例下的表配置

以下示例用于更新表的最大版本数为5以及预留读写吞吐量为0。

# 设定新的预留读吞吐量为0,写吞吐量为0。
reserved_throughput = ReservedThroughput(CapacityUnit(0, 0))

# 创建TableOptions,数据保留31536000秒,超过后自动删除;最大5个版本;写入时指定的版本值和当前标准时间相差不能超过1天。
table_options = TableOptions(31536000, 5, 86400)

try:
    # 调用接口更新表的预留读写吞吐量。
    ots_client.update_table('SampleTable', table_options, reserved_throughput)
    # 如果没有抛出异常,则说明执行成功。
    print("update table succeeded")
except Exception:
    # 如果抛出异常,则说明执行失败,处理异常。
    print("update table failed")
  • 本页导读 (1)