調用 UpdateTable 更新指定表 - Tablestore

您可以調用 UpdateTable 介面修改表的配置資訊 table_options 和 Stream 配置 StreamSpecification。如果表處於高效能型執行個體中，您還可以為資料表配置預留讀/寫輸送量 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	Table Store中的 Stream 流的配置資訊，記錄了表的 Stream 功能是否開啟、日誌到期時間長度、上次 Stream 開啟時間等。

使用 SDK

您可以使用如下語言的 SDK 更新資料表。