All Products
Search
Document Center

Tablestore:TableOptions

Last Updated:Apr 04, 2026

Tipe data TableOptions menentukan konfigurasi opsional untuk tabel, mencakup time to live (TTL) 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;
    optional bool update_full_row = 7;
}

Parameter

Tipe

Wajib

Deskripsi

time_to_live

int32

Tidak

Periode penyimpanan data dalam tabel. Periode ini merupakan periode validitas data. Jika periode retensi data melebihi TTL, data tersebut kedaluwarsa. Tablestore secara otomatis menghapus data yang kedaluwarsa.

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

max_versions

int32

Tidak

Jumlah maksimum versi yang dapat disimpan untuk data dalam kolom atribut tabel data. Jika jumlah versi data dalam suatu kolom atribut melebihi nilai MaxVersion, sistem akan menghapus data versi yang lebih lama.

deviation_cell_version_in_sec

int64

Tidak

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

Rentang waktu valid untuk kolom atribut adalah [max{waktu tulis - offset versi maksimum, waktu tulis - time to live (TTL)}, waktu tulis + offset versi maksimum).

allow_update

bool

Tidak

Menentukan apakah penulisan data diizinkan melalui operasi UpdateRow. Nilai default-nya adalah true, yang berarti penulisan data diizinkan menggunakan UpdateRow.

Jika aplikasi Anda tidak memperbarui data dan Anda ingin menggunakan fitur time to live (TTL) pada indeks pencarian, atur parameter ini ke false.

update_full_row

bool

Tidak

Mengontrol apakah operasi UpdateRow memperbarui seluruh baris atau hanya kolom yang ditentukan. Nilai default-nya adalah false, artinya hanya kolom yang ditentukan yang diperbarui.

Jika aplikasi Anda memerlukan pembaruan data dan Anda menggunakan fitur time to live (TTL) pada indeks pencarian atau fitur global table, atur parameter ini ke true. Dalam hal ini, pertahankan parameter allow_update pada nilai default-nya yaitu true.