Perbarui TTL indeks pencarian – Tablestore SDK untuk Python - Tablestore

Gunakan Tablestore SDK untuk Python untuk memperbarui TTL indeks pencarian.

Prasyarat

Instal Tablestore SDK untuk Python dan inisialisasi klien.
Tabel tidak mengizinkan operasi UpdateRow. Artinya, allow_update diatur ke False. Untuk informasi selengkapnya, lihat Perbarui konfigurasi tabel.

Deskripsi

Panggil metode update_search_index untuk memperbarui TTL indeks pencarian.

def update_search_index(
    self,
    table_name,
    index_name,
    index_meta,
)

Penting

Perhatikan hal-hal berikut saat mengonfigurasi TTL:

Metode update_search_index pada Tablestore SDK untuk Python hanya dapat memperbarui TTL. Metode ini tidak dapat mengubah bidang indeks, pengaturan indeks, atau pengaturan presorting.
TTL tabel dan TTL indeks pencarian bersifat independen, tetapi TTL indeks pencarian tidak boleh melebihi TTL tabel. Untuk menaikkan TTL indeks pencarian melebihi TTL tabel saat ini, naikkan terlebih dahulu TTL tabel tersebut. Sebaliknya, untuk menurunkan TTL tabel di bawah TTL indeks pencarian saat ini, turunkan terlebih dahulu TTL indeks pencarian tersebut.
Tablestore menghapus data indeks pencarian yang kedaluwarsa sekali sehari. Data yang kedaluwarsa mungkin masih dapat diquery hingga siklus penghapusan berikutnya. Setelah Anda memperpendek TTL, Tablestore akan menghapus data historis yang kedaluwarsa dalam siklus penghapusan berikutnya.

Contoh berikut memperbarui TTL example_index untuk example_table menjadi tujuh hari dan melakukan query terhadap nilai yang diperbarui.

index_meta = SearchIndexMeta(
    fields=None,
    time_to_live=7 * 24 * 60 * 60,
)
client.update_search_index(
    "example_table",
    "example_index",
    index_meta,
)

updated_meta, _ = client.describe_search_index(
    "example_table",
    "example_index",
)
print(updated_meta.time_to_live)

Parameter

Metode update_search_index mencakup parameter berikut.

Nama	Tipe	Deskripsi
table_name (wajib)	`str`	Nama tabel.
index_name (wajib)	`str`	Nama indeks pencarian.
index_meta (wajib)	`SearchIndexMeta`	Konfigurasi indeks pencarian yang akan diperbarui.

Konfigurasi indeks pencarian

index_meta adalah objek SearchIndexMeta yang berisi parameter berikut untuk pembaruan TTL.

Nama	Tipe	Deskripsi
fields (wajib)	`List[FieldSchema]`	Atur parameter ini ke `None`. Permintaan pembaruan tidak mengubah bidang indeks.
time_to_live (opsional)	`int`	TTL data indeks dalam detik. Nilai default: `-1`. Atur nilainya ke `-1` atau nilai int32 positif. Nilai `-1` menunjukkan bahwa data tidak kedaluwarsa. Nilai maksimum int32 setara dengan sekitar 68 tahun.

Contoh

Nonaktifkan TTL

Atur time_to_live ke -1 agar data dalam indeks pencarian tidak kedaluwarsa.

index_meta = SearchIndexMeta(fields=None, time_to_live=-1)
client.update_search_index(
    "example_table",
    "example_index",
    index_meta,
)