Perbarui konfigurasi tabel deret waktu - Tablestore SDK for Java - Tablestore

Gunakan Tablestore SDK for Java untuk memperbarui time-to-live (TTL) data dan metadata deret waktu serta menentukan apakah kolom atribut metadata dapat diperbarui.

Prasyarat

Instal Tablestore SDK for Java dan inisialisasi klien deret waktu.

Deskripsi

Panggil metode updateTimeseriesTable untuk memperbarui konfigurasi tabel deret waktu. Setiap permintaan hanya dapat memperbarui konfigurasi data deret waktu atau konfigurasi metadata—tidak keduanya sekaligus.

public UpdateTimeseriesTableResponse updateTimeseriesTable(UpdateTimeseriesTableRequest request)

Contoh berikut memperbarui TTL data deret waktu pada tabel example_timeseries_table menjadi tiga tahun.

TimeseriesClient timeseriesClient = client.asTimeseriesClient();

String tableName = "example_timeseries_table";
UpdateTimeseriesTableRequest request =
        new UpdateTimeseriesTableRequest(tableName);
request.setTimeseriesTableOptions(
        new TimeseriesTableOptions(86400 * 365 * 3));

timeseriesClient.updateTimeseriesTable(request);

Parameter

Objek UpdateTimeseriesTableRequest berisi parameter berikut.

Name	Type	Description
timeseriesTableName (required)	`String`	Nama tabel deret waktu yang konfigurasinya ingin Anda perbarui.
timeseriesTableOptions (optional)	`TimeseriesTableOptions`	Konfigurasi data deret waktu. Anda harus menentukan salah satu dari `timeseriesTableOptions` atau `timeseriesMetaOptions`, tetapi tidak keduanya.
timeseriesMetaOptions (optional)	`TimeseriesMetaOptions`	Konfigurasi metadata deret waktu. Anda harus menentukan salah satu dari `timeseriesTableOptions` atau `timeseriesMetaOptions`, tetapi tidak keduanya.

Konfigurasi data deret waktu

Parameter timeseriesTableOptions bertipe TimeseriesTableOptions dan mencakup pengaturan berikut.

Name

Type

Description

timeToLive (required)

int

TTL data deret waktu dalam detik. Tetapkan nilainya ke -1 atau bilangan bulat minimal 86.400. Nilai -1 berarti data tidak kedaluwarsa.

Tablestore secara otomatis menghapus data yang telah kedaluwarsa.

Jika TTL metadata bukan -1, nilai ini tidak boleh melebihi TTL metadata. Sebelum menetapkan nilai ini ke -1, tetapkan terlebih dahulu TTL metadata ke -1.

Konfigurasi metadata deret waktu

Parameter timeseriesMetaOptions bertipe TimeseriesMetaOptions. Tentukan setidaknya salah satu parameter berikut; parameter yang tidak disertakan akan mempertahankan nilai saat ini.

Name

Type

Description

metaTimeToLive (optional)

int

TTL metadata deret waktu dalam detik. Tetapkan nilainya ke -1 atau bilangan bulat minimal 604.800. Nilai -1 berarti metadata tidak kedaluwarsa.

Nilai ini tidak boleh lebih kecil daripada TTL data deret waktu. Jika TTL data adalah -1, nilai ini juga harus -1.

Jika Anda mengonfigurasi TTL terbatas, tetapkan allowUpdateAttributes ke false.

allowUpdateAttributes (optional)

boolean

Menentukan apakah kolom atribut metadata dapat diperbarui. Jika TTL metadata bukan -1, nilai ini harus false.

Contoh

Perbarui konfigurasi metadata deret waktu

Contoh berikut mengonfigurasi metadata deret waktu agar tidak pernah kedaluwarsa dan mengizinkan pembaruan pada kolom atribut metadata.

String tableName = "example_timeseries_table";
TimeseriesMetaOptions metaOptions = new TimeseriesMetaOptions();
metaOptions.setMetaTimeToLive(-1);
metaOptions.setAllowUpdateAttributes(true);

UpdateTimeseriesTableRequest request =
        new UpdateTimeseriesTableRequest(tableName);
request.setTimeseriesMetaOptions(metaOptions);

timeseriesClient.updateTimeseriesTable(request);