All Products
Search
Document Center

Tablestore:Perbarui konfigurasi tabel

Last Updated:Apr 30, 2026

Gunakan Tablestore SDK untuk Python guna memperbarui konfigurasi tabel, seperti time to live (TTL), jumlah maksimum versi, dan throughput yang dipesan.

Prasyarat

Sebelum memulai, pastikan Anda telah:

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

    Time to live (TTL) data, dalam detik. Nilai default: -1.

    Atur ke -1 untuk menyimpan data tanpa batas waktu. Nilai lainnya harus minimal 86400 (satu hari). Data yang melebihi TTL akan dihapus secara otomatis.

    Untuk menggunakan fitur search index atau secondary index, atur parameter ini ke -1 atau atur allow_update ke False.

    max_version (opsional)

    int

    Jumlah versi maksimum. Nilai default: 1.

    • Untuk menggunakan fitur search index atau secondary index, atur parameter ini ke 1.

    max_time_deviation (opsional)

    int

    Offset versi maksimum, dalam detik. Nilai default: 86400 (satu hari).

    • Selisih antara waktu sistem saat ini dan timestamp data yang ditulis harus berada dalam rentang offset ini. Penulisan yang melebihi rentang ini akan gagal.

    • Rentang versi yang valid untuk data kolom atribut adalah [max(Waktu penulisan data - Offset versi maksimum, Waktu penulisan data - TTL), Waktu penulisan data + Offset versi maksimum).

    allow_update (opsional)

    bool

    Menentukan apakah pembaruan baris diizinkan. Nilai default: True.

    • Atur ke False untuk mencegah pembaruan baris melalui metode UpdateRow().

  • reserved_throughput (opsional) ReservedThroughput: throughput baca dan tulis yang dipesan, dalam capacity unit (CU). Nilai default: 0. Hanya berlaku untuk instans kinerja tinggi dalam Mode CU.

Catatan

Setidaknya salah satu dari table_options atau reserved_throughput harus ditentukan saat memanggil update_table().

Kode contoh

Contoh berikut memperbarui konfigurasi test_table.

# Atur konfigurasi tabel: TTL 1 hari, maksimal 3 versi, deviasi waktu maksimum 1 hari, pembaruan dinonaktifkan
table_options = TableOptions(time_to_live=86400, max_version=3, max_time_deviation=86400, allow_update=False)

# Atur throughput baca dan tulis yang dipesan menjadi 0 CU
# Nilai bukan nol hanya didukung untuk instans kinerja tinggi dalam Mode CU
reserved_throughput = ReservedThroughput(CapacityUnit(0, 0))

try:
    client.update_table('test_table', table_options, reserved_throughput)
    print("Update table succeeded.")
except Exception as e:
    print("Update table failed. %s" % e)

Referensi

Update a time series table