开发者社区 问答 正文

如何操作UpdateTable



行为:


更新指定表的预留读吞吐量或预留写吞吐量设置,新设定将于更新成功一分钟内生效。

请求结构:message UpdateTableRequest {
    required string table_name = 1;
    optional ReservedThroughput reserved_throughput = 2;
    optional TableOptions table_options = 3;
    optional StreamSpecification stream_spec = 4;
}





table_name:


  • 类型:string

  • 是否必要参数:是

  • 需要更改预留读写吞吐量设置的表的表名。


reserved_throughput:


  • 类型:ReservedThroughput

  • 是否必要参数: 是

  • 将要更改的表的预留读/写吞吐量设定,该设定将于一分钟后生效。

  • 可以只更改表的预留读吞吐量的设置或只更改表的预留写吞吐量的设置,也可以一并更改。

  • capacity_unit 中 read 和 write 应至少有一个非空,否则请求失败,返回错误。


table_options:


  • 类型:TableOptions

  • 是否必要参数:是

  • 主要设置TimeToLive和最大版本数。


StreamSpecification


  • 类型:StreamSpecification

  • 是否必要参数:否

  • 描述是否打开Stream等Stream相关的属性。


响应消息结构:message UpdateTableResponse {
    required ReservedThroughputDetails reserved_throughput_details = 1;
    required TableOptions table_options = 2;
}





capacity_unit_details:


  • 类型:ReservedThroughputDetails

  • 更新后,该表的预留读/写吞吐量设置信息除了包含当前的预留读/写吞吐量设置值之外,还包含了最近一次更新该表的预留读/写吞吐量设置的时间和当日已下调预留读/写吞吐量的次数。


注意事项:


  • 调整每个表预留读/写吞吐量的最小时间间隔为 2 分钟,如果本次 UpdateTable 操作距上次不到 2 分钟将被拒绝。

  • 每个自然日(UTC 时间 00:00:00 到第二天的 00:00:00)内每个表上调和下调预留读写吞吐量次数不限。


table_options:


  • 类型:TableOptions

  • 修改后,最新的table_options参数值。

展开
收起
云栖大讲堂 2017-10-25 14:13:06 2012 分享 版权
阿里云 AI 助理回答

根据您提供的信息,这是关于如何使用阿里云表格存储(Table Store,原OTS)的API来更新指定表的预留读/写吞吐量以及其他表属性的操作说明。下面是对这一操作的详细解释和步骤指导:

操作目的

该操作主要用于动态调整阿里云表格存储中某个表的性能配置,包括预留读吞吐量、预留写吞吐量、Time-To-Live(TTL)设置以及Stream功能的开关与配置。这些调整能够帮助用户更灵活地管理数据访问需求和成本。

请求结构解析

  1. table_name:必填参数,指定需要修改配置的表名。

  2. reserved_throughput:必填参数,用于设定或更新表的预留读/写吞吐量(以Capacity Unit为单位)。用户可以根据实际需求增加或减少预留吞吐量,但至少需要提供read或write中的一个值,且每次调整后至少需等待2分钟才能进行下一次调整。

  3. table_options:可选参数,用于设置表的其他选项,如Time-To-Live(TTL),即数据的有效存活时间,以及最大版本数等,帮助自动清理过期数据和控制数据版本数量。

  4. stream_specification:可选参数,用于控制表的Stream功能,包括是否开启Stream以及Stream的保留时间等,Stream可以用来记录表的数据变更历史,便于实现数据同步、备份或分析等功能。

响应消息结构

  • reserved_throughput_details:返回更新后的预留读/写吞吐量的具体细节,包括当前设置值及最近更新时间和下调次数。
  • table_options:返回更新后的table_options设置,确认是否成功应用了TTL或最大版本数的更改。

注意事项

  • 调整预留读/写吞吐量之间有最小2分钟的时间间隔限制。
  • 每个自然日内的吞吐量调整次数没有限制,既可上调也可下调,以满足不同时间段的业务需求变化。

实施步骤

  1. 准备请求参数:确定要修改的表名、新的预留读/写吞吐量值、是否调整TTL或Stream设置。
  2. 构造请求:使用阿里云表格存储API对应的SDK或直接构造HTTP请求,按照上述请求结构填充参数。
  3. 发送请求:通过阿里云表格存储服务端点发送更新请求。
  4. 处理响应:检查响应中的reserved_throughput_detailstable_options,确认修改是否生效。
  5. 监控与调整:根据业务实际消耗情况,适时调整预留吞吐量,避免资源浪费或不足,并注意遵守2分钟的调整间隔限制。

确保在执行此操作前,已熟悉阿里云表格存储的服务条款和费用模型,合理规划以优化成本与性能。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答
问答地址: