全部產品
Search
文件中心

Tablestore:TableOptions

更新時間:Apr 04, 2026

TableOptions資料類型定義,表示表的可選配置,包括TimeToLive、最大版本數等。

資料結構

message TableOptions {
    optional int32 time_to_live = 1; 
    optional int32 max_versions = 2; 
    optional int64 deviation_cell_version_in_sec = 5; 
    optional bool allow_update = 6;
    optional bool update_full_row = 7;
}

名稱

類型

是否必選

描述

time_to_live

int32

資料生命週期,即資料的到期時間。當資料的儲存時間超過設定的資料生命週期時,系統會自動清理超過資料生命週期的資料。

資料生命週期至少為86400秒(一天)或-1(資料永不到期)。

max_versions

int32

最大版本數,即屬性列能夠保留資料的最大版本個數。當屬性列資料的版本個數超過設定的最大版本數時,系統會自動刪除較早版本的資料。

deviation_cell_version_in_sec

int64

有效版本偏差,即寫入資料的時間戳記與系統目前時間的偏差允許最大值。只有當寫入資料所有列的版本號碼與寫入時時間的差值在資料有效版本偏差範圍內,資料才能成功寫入。

屬性列的有效版本範圍為[max{資料寫入時間-有效版本偏差,資料寫入時間-資料生命週期},資料寫入時間+有效版本偏差)

allow_update

bool

是否允許通過UpdateRow更新寫入資料。預設值為true,表示允許通過UpdateRow更新寫入資料。

如果您的業務中不需要更新資料,並且希望使用多元索引的資料生命週期功能,請將此參數設定為 false。

update_full_row

bool

使用UpdateRow介面更新資料時是否更新整行資料。預設值為false,表示使用UpdateRow介面時只更新指定列。

如果您的業務需要使用多元索引的資料生命週期或全域表功能並且涉及資料更新,請將此參數設定為true,同時保持allowUpdate參數為預設值。