全部产品
Search
文档中心

Tablestore:TableOptions

更新时间:Jun 24, 2025

Menentukan konfigurasi opsional tabel, termasuk waktu hidup (TTL) data dan jumlah maksimum versi.

Struktur data

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;
}

Parameter

Tipe

Diperlukan

Deskripsi

time_to_live

int32

Tidak

Jangka waktu penyimpanan data dalam tabel. Jangka waktu ini adalah periode validitas data. Jika masa retensi data melebihi TTL, data kedaluwarsa. Tablestore secara otomatis menghapus data yang kedaluwarsa.

Nilai parameter ini harus lebih besar dari atau sama dengan 86400. Nilai 86400 menentukan 1 hari. Anda juga dapat mengatur parameter ini ke -1, yang menentukan bahwa data tidak pernah kedaluwarsa.

max_versions

int32

Tidak

Jumlah maksimum versi yang dapat disimpan untuk data di kolom atribut tabel data. Jika jumlah versi data di kolom atribut melebihi nilai MaxVersion, sistem akan menghapus data versi sebelumnya.

deviation_cell_version_in_sec

int64

Tidak

Offset maksimum antara timestamp data yang ditulis dan waktu sistem saat ini. Perbedaan antara nomor versi dan waktu penulisan data harus kurang dari atau sama dengan offset versi maksimum. Jika tidak, terjadi kesalahan saat data ditulis.

Rentang versi valid data di kolom atribut dihitung menggunakan rumus berikut: Rentang versi valid = [max{Waktu penulisan data - Offset Versi Maks, Waktu penulisan data - Nilai TTL}, Waktu penulisan data + Offset Versi Maks).

allow_update

bool

Tidak

Menentukan apakah operasi UpdateRow diperbolehkan untuk menulis data. Nilai default adalah true, yang menentukan bahwa penulisan data diperbolehkan menggunakan UpdateRow.

Jika Anda ingin menggunakan fitur TTL indeks pencarian, Anda harus mengatur parameter ini ke false.