赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 表格存储
  4. 开发参考
  5. API参考(数据管理)
  6. API概览
  7. 数据表操作
  8. UpdateTable

UpdateTable

  • 数据表操作
  • 发布于 2025-04-22
  • 0 次阅读
文档编辑
文档编辑

您可以调用 UpdateTable 接口修改表的配置信息 table_options 和 Stream 配置 StreamSpecification。如果表处于CU 模式(原按量模式)的高性能型实例中,您还可以为数据表配置预留读/写吞吐量 reserved_throughput,新设定将于更新成功后的一分钟内生效。

请求消息结构

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;
    optional StreamDetails stream_details = 3;
}

名称

类型

描述

capacity_unit_details

ReservedThroughputDetails

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

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

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

table_options

TableOptions

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

stream_details

StreamDetails

表格存储中的 Stream 流的配置信息,记录了表的 Stream 功能是否开启、日志过期时长、上次 Stream 开启时间等。

使用 SDK

您可以使用如下语言的 SDK 更新数据表。

  • Java SDK:更新表

  • Go SDK:更新表

  • Python SDK:更新表

  • Node.js SDK:更新表

  • .NET SDK:更新表

  • PHP SDK:更新表

相关文章

CreateTable 2025-04-22 14:34

调用CreateTable接口根据给定的表结构信息创建相应的数据表。 注意事项

ListTable 2025-04-22 14:34

调用ListTable接口获取当前实例下已创建的所有表的表名。 注意事项 如果一个表刚刚创建成功,该表名会出现在ListTableRespon

DescribeTable 2025-04-22 14:34

调用DescribeTable接口查询指定表的结构信息以及预留读吞吐量和预留写吞吐量设置信息。 请求消息结构

UpdateTable 2025-04-22 14:34

您可以调用 UpdateTable 接口修改表的配置信息 table_options 和 Stream 配置 StreamSpecification。如果表处于CU 模式(原按量模式)的高性能型实例中,您还可以为数据表配置预留读/写吞吐量

DeleteTable 2025-04-22 14:34

调用DeleteTable接口删除本实例下指定的表。 请求消息结构

ComputeSplitPointsBySize 2025-04-22 14:34

调用ComputeSplitPointsBySize接口将全表的数据在逻辑上划分成接近指定大小的若干分片,返回这些分片之间的分割点以及分片所在机器的提示。一般用于计算引擎规划并发度等执行计划。 请求消息结构

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号