Perbarui konfigurasi tabel deret waktu menggunakan Python SDK - Tablestore

Panggil operasi UpdateTimeseriesTable untuk memperbarui konfigurasi tabel deret waktu atau metadata timeline, seperti pengaturan time-to-live (TTL).

Precautions

Fitur model deret waktu tersedia mulai Tablestore Python SDK versi 6.1.0. Pastikan Anda menggunakan versi SDK yang didukung.

Catatan
Untuk informasi selengkapnya mengenai riwayat rilis Python SDK, lihat Python SDK release history.
Anda tidak dapat mengubah konfigurasi tabel deret waktu (timeseries_table_options) dan konfigurasi metadata timeline (timeseries_meta_options) dalam satu panggilan yang sama. Hanya salah satu konfigurasi tersebut yang dapat dimodifikasi dalam satu panggilan.

Prasyarat

Initialize the Tablestore client.

Parameter

Parameter

Deskripsi

table_meta (Required)

Struktur tabel deret waktu. Parameter ini mencakup parameter berikut:

timeseries_table_name (Required): Nama tabel deret waktu.
timeseries_table_options (Opsional): Konfigurasi tabel deret waktu. Parameter ini mencakup parameter berikut:
- time_to_live (Required): Siklus hidup data dalam tabel deret waktu, yang menentukan kapan data kedaluwarsa. Satuan: detik.
  
  Siklus hidup minimum untuk data dalam tabel deret waktu adalah 86400 detik (1 hari). Anda juga dapat mengatur parameter ini ke -1, yang berarti data tidak pernah kedaluwarsa.
timeseries_meta_options (Opsional): Konfigurasi metadata timeline. Parameter ini mencakup parameter berikut:
- meta_time_to_live (Required): Siklus hidup metadata timeline, yang menentukan kapan timeline kedaluwarsa. Satuan: detik.
  
  Siklus hidup minimum untuk metadata timeline adalah 604800 detik (7 hari). Anda juga dapat mengatur parameter ini ke -1, yang berarti timeline tidak pernah kedaluwarsa.
  
  Penting
  Siklus hidup metadata timeline harus lebih besar dari atau sama dengan siklus hidup data tabel deret waktu.
- allow_update_attributes (Required): Menentukan apakah pembaruan atribut metadata timeline diizinkan. Nilai yang valid:
  Penting
  - Jika meta_time_to_live bukan -1, Anda harus mengatur allow_update_attributes ke False. Hal ini mencegah Anda memperbarui atribut metadata timeline.
  - Jika Anda mengatur allow_update_attributes ke True, Anda harus mengatur meta_time_to_live ke -1 (tidak pernah kedaluwarsa).
  - True: Mengizinkan operasi.
  - False: Tidak diizinkan.

Contoh

Contoh berikut menunjukkan cara memperbarui TTL tabel deret waktu.

try:
    # Siklus hidup data tabel deret waktu adalah 604800 detik (7 hari).
    tableOption = TimeseriesTableOptions(604800)
    tableMeta = TimeseriesTableMeta("<TIMESERIES_TABLE_NAME>", tableOption)

    # Panggil operasi untuk memperbarui tabel deret waktu.
    otsClient.update_timeseries_table(tableMeta)
    print("update timeseries table success.")
except Exception as e:
    # Jika terjadi exception, eksekusi gagal. Tangani exception tersebut.
    print("update timeseries table failed. %s" % e)