Topik ini menjelaskan cara memperbarui konfigurasi tabel menggunakan Tablestore SDK untuk Python.
Deskripsi metode
def update_table(self, table_name, table_options=None, reserved_throughput=None)
Parameter
table_name (wajib) str: Nama tabel data.
table_options (opsional) TableOptions: Konfigurasi tabel, mencakup parameter berikut.
Parameter | Tipe | Deskripsi |
time_to_live (opsional) | int | Waktu hidup (TTL) data, dalam detik. Nilai default adalah -1. Jika Anda mengatur parameter ini ke -1, data tidak akan pernah kedaluwarsa. Jika tidak, nilai minimumnya adalah 86400 (satu hari). Data yang periode retensinya melebihi TTL akan dihapus secara otomatis. Jika Anda ingin menggunakan fitur indeks pencarian atau indeks sekunder, Anda harus mengatur parameter ini ke -1 atau mengatur parameter AllowUpdate ke False. |
max_version (opsional) | int | Jumlah maksimum versi. Nilai default adalah 1. |
max_time_deviation (opsional) | int | Offset versi maksimum, dalam detik. Nilai default adalah 86400 (satu hari). Selisih antara waktu sistem saat ini dan timestamp data yang ditulis harus berada dalam rentang offset versi maksimum. Jika tidak, penulisan data akan gagal. Rentang versi valid untuk data kolom atribut adalah [max(Waktu data ditulis - Offset versi maksimum, Waktu data ditulis - TTL), Waktu data ditulis + Offset versi maksimum).
|
allow_update (opsional) | bool | Menentukan apakah pembaruan diizinkan. Nilai default adalah True. |
reserved_throughput (opsional) ReservedThroughput: Throughput baca dan tulis yang dicadangkan, dalam unit kapasitas (CU). Nilai default adalah 0. Parameter ini hanya dapat ditentukan dan berlaku untuk instance performa tinggi dalam mode CU.
Catatan Saat memanggil metode update_table(), Anda harus menentukan setidaknya salah satu parameter table_options atau reserved_throughput.
Kode contoh
Berikut adalah contoh kode untuk memodifikasi konfigurasi tabel test_table.
# Buat konfigurasi tabel.
table_options = TableOptions(time_to_live=86400, max_version=3, max_time_deviation=86400, allow_update=False)
# Tetapkan throughput baca yang dicadangkan ke 0 CU dan throughput tulis yang dicadangkan ke 0 CU (hanya instance performa tinggi dalam mode CU yang mengizinkan Anda menentukan nilai non-nol untuk throughput baca dan tulis yang dicadangkan).
reserved_throughput = ReservedThroughput(CapacityUnit(0,0))
try:
# Ajukan permintaan.
client.update_table('test_table', table_options, reserved_throughput)
print("Pembaruan tabel berhasil.")
except Exception as e:
print("Pembaruan tabel gagal. %s" % e)