Perbarui konfigurasi tabel - Tablestore SDK for Python - Tablestore

Gunakan Tablestore SDK for Python untuk memperbarui konfigurasi TTL, versi, mode pembaruan, dan throughput yang dipesan pada suatu tabel.

Prasyarat

Instal Tablestore SDK for Python dan inisialisasi klien.

Deskripsi fungsi

Panggil metode update_table untuk memperbarui konfigurasi tabel. Anda harus menentukan setidaknya salah satu dari parameter table_options atau reserved_throughput.

def update_table(
    self,
    table_name,
    table_options=None,
    reserved_throughput=None,
)

Contoh berikut mengubah TTL pada tabel example_table menjadi tujuh hari dan menonaktifkan pembaruan melalui metode update_row.

table_options = TableOptions(
    time_to_live=604800,
    max_version=1,
    max_time_deviation=86400,
    allow_update=False,
)

client.update_table(
    "example_table",
    table_options=table_options,
)

Parameter

Metode update_table mencakup parameter berikut.

Name	Type	Description
table_name (required)	`str`	Nama tabel.
table_options (optional)	`TableOptions`	Konfigurasi tabel yang akan diperbarui. Anda harus menentukan setidaknya salah satu dari parameter ini dan `reserved_throughput`.
reserved_throughput (optional)	`ReservedThroughput`	Throughput yang dipesan untuk diperbarui. Anda harus menentukan setidaknya salah satu dari parameter ini dan `table_options`.

Konfigurasi tabel

Parameter table_options bertipe TableOptions dan mencakup parameter berikut.

Name	Type	Description
time_to_live (optional)	`int`	TTL data dalam satuan detik. Nilai `-1` menunjukkan bahwa data tidak pernah kedaluwarsa. Jika Anda menentukan nilai lain, nilai minimum adalah `86400`, yaitu satu hari. Data yang kedaluwarsa akan dihapus secara otomatis. Untuk menggunakan search index atau secondary index, atur parameter ini ke `-1` atau atur `allow_update` ke `False`.
max_version (optional)	`int`	Jumlah maksimum versi yang disimpan untuk setiap kolom atribut. Untuk menggunakan search index atau secondary index, atur parameter ini ke `1`.
max_time_deviation (optional)	`int`	Deviasi versi maksimum dalam satuan detik. Selisih antara timestamp data yang ditulis dan waktu sistem saat ini harus berada dalam rentang deviasi versi maksimum. Rentang versi yang valid adalah `[max(waktu penulisan data - deviasi versi maksimum, waktu penulisan data - TTL), waktu penulisan data + deviasi versi maksimum)`.
allow_update (optional)	`bool`	Menentukan apakah data dapat diperbarui dengan memanggil `update_row`. Jika Anda mengatur parameter ini ke `False`, data tidak dapat diperbarui dengan memanggil `update_row`.

Reserved throughput

Parameter reserved_throughput bertipe ReservedThroughput dan mencakup parameter berikut.

Name	Type	Description
capacity_unit (required)	`CapacityUnit`	Reserved throughput dalam satuan CU. Hanya instans kinerja tinggi dalam Mode CU yang mendukung nilai bukan nol.

Respons

UpdateTableResponse berisi informasi bisnis berikut.

Field	Type	Description
table_options	`TableOptions`	Konfigurasi tabel yang telah diperbarui.
reserved_throughput_details	`ReservedThroughputDetails`	Throughput yang dipesan saat ini serta waktu terakhir peningkatan dan penurunan.

Contoh

Perbarui reserved throughput

Contoh berikut mengatur reserved throughput pada tabel example_table menjadi 0 CU.

reserved_throughput = ReservedThroughput(
    CapacityUnit(read=0, write=0)
)

client.update_table(
    "example_table",
    reserved_throughput=reserved_throughput,
)