Perbarui konfigurasi tabel deret waktu menggunakan Tablestore SDK untuk Python - Tablestore

Dengan memanggil operasi UpdateTimeseriesTable, Anda dapat memperbarui konfigurasi tabel deret waktu atau metadata deret waktu, seperti time to live (TTL).

Catatan penggunaan

Model TimeSeries didukung oleh Tablestore SDK untuk Python versi V6.1.0 dan yang lebih baru. Pastikan Anda telah menginstal versi yang sesuai dari Tablestore SDK untuk Python.
Catatan
Untuk informasi lebih lanjut, lihat Riwayat Versi Tablestore SDK untuk Python.
Anda tidak dapat mengubah konfigurasi tabel deret waktu (timeseries_table_options) dan metadata deret waktu (timeseries_meta_options) secara bersamaan. Hanya satu dari keduanya yang dapat diperbarui dalam satu panggilan.

Prasyarat

Klien Tablestore harus diinisialisasi terlebih dahulu. Untuk detail lebih lanjut, lihat Inisialisasi Klien Tablestore.

Parameter

Parameter

Deskripsi

table_meta (Wajib)

Informasi skema tabel deret waktu. Informasi skema terdiri dari item-item berikut:

timeseries_table_name (wajib): nama tabel deret waktu.
timeseries_table_options (opsional): informasi konfigurasi tabel deret waktu, yang terdiri dari item-item berikut:
- time_to_live (wajib): periode retensi data dalam tabel deret waktu. Satuan: detik.
  Periode retensi minimum data dalam tabel deret waktu adalah 86.400 detik (satu hari). Anda juga dapat menyetel time_to_live ke -1, yang menentukan bahwa data dalam tabel deret waktu tidak pernah kedaluwarsa.
timeseries_meta_options (opsional): informasi konfigurasi metadata deret waktu, yang terdiri dari item-item berikut:
- meta_time_to_live (wajib): periode retensi metadata deret waktu. Satuan: detik.
  Periode retensi minimum metadata deret waktu adalah 604.800 detik (tujuh hari). Anda juga dapat menyetel meta_time_to_live ke -1, yang menentukan bahwa metadata deret waktu tidak pernah kedaluwarsa.
  Penting
  Nilai TTL metadata deret waktu harus lebih besar dari atau sama dengan nilai TTL data dalam tabel deret waktu.
- allow_update_attributes (wajib): menentukan apakah diperbolehkan memperbarui atribut metadata deret waktu. Nilai yang valid:
  Penting
  - Jika meta_time_to_live disetel ke nilai selain -1, Anda harus menyetel allow_update_attributes ke False, yang berarti pembaruan atribut metadata deret waktu tidak diperbolehkan.
  - Jika Anda ingin menyetel allow_update_attributes ke True, pastikan nilai meta_time_to_live adalah -1.
  - True: mengizinkan pembaruan atribut metadata deret waktu.
  - False: tidak mengizinkan pembaruan atribut metadata deret waktu.

Contoh

Berikut adalah contoh kode untuk memperbarui TTL tabel deret waktu:

try:
    # Setel TTL data dalam tabel deret waktu menjadi 604.800 detik (tujuh hari).
    tableOption = TimeseriesTableOptions(604800)
    tableMeta = TimeseriesTableMeta("", tableOption)

    # Panggil operasi untuk memperbarui tabel deret waktu.
    otsClient.update_timeseries_table(tableMeta)
    print("pembaruan tabel deret waktu berhasil.")
except Exception as e:
    # Jika terjadi pengecualian, pembaruan gagal. Tangani pengecualian.
    print("pembaruan tabel deret waktu gagal. %s" % e)