All Products
Search
Document Center

Tablestore:TTL data serial waktu

Last Updated:Jul 02, 2025

Untuk menghapus data historis dalam tabel serial waktu secara otomatis, Anda dapat mengonfigurasi time to live (TTL) guna mengelola data tersebut. Hal ini membantu menghemat ruang penyimpanan dan mengurangi biaya. Setelah mengonfigurasi TTL untuk data serial waktu, Anda dapat memodifikasinya untuk memperpanjang periode retensi data.

Catatan Penggunaan

  • Data yang telah dihapus tidak dapat dipulihkan. Lanjutkan dengan hati-hati.

    Jika perlu mencadangkan data historis sebelum mengonfigurasi TTL untuk penghapusan otomatis, Anda dapat menggunakan layanan Data Integration dari DataWorks untuk mengekspor data serial waktu ke Object Storage Service (OSS). Untuk informasi lebih lanjut, lihat Ikhtisar.

  • Sebelum memodifikasi TTL, Anda dapat memanggil operasi DescribeTimeseriesTable untuk melihat TTL data serial waktu.

TTL

Dalam model TimeSeries, data terdiri dari metadata serial waktu dan data tabel serial waktu. Metadata disimpan dalam tabel metadata serial waktu, sedangkan data tabel disimpan dalam tabel data serial waktu. Tablestore memungkinkan Anda mengelola metadata dan data tabel serial waktu dengan mengonfigurasi TTL untuk keduanya.

TTL data dalam tabel serial waktu

Sebagai atribut tabel data serial waktu, TTL menunjukkan periode retensi data dalam tabel tersebut. Nilai TTL ditentukan dalam detik. Jika data disimpan melebihi nilai TTL yang ditentukan, Tablestore akan menghapusnya secara asinkron.

Sebagai contoh, jika Anda mengatur TTL untuk data menjadi 86.400 (1 hari), pada 00:00:00 UTC+8 tanggal 21 Juli 2016, data yang ditulis sebelum 00:00:00 UTC+8 tanggal 20 Juli 2016 akan kedaluwarsa. Tablestore akan menghapus data kedaluwarsa secara asinkron.

Jika Anda tidak menentukan nilai TTL saat membuat tabel serial waktu, nilai default -1 akan digunakan, yang berarti data tidak pernah kedaluwarsa. Anda juga dapat menentukan nilai TTL kustom. Setelah tabel dibuat, Anda dapat memanggil operasi UpdateTimeseriesTable untuk memodifikasi TTL.

Jika data disimpan melebihi nilai TTL, data tersebut menjadi tidak valid dan tidak dapat diakses meskipun belum dihapus oleh Tablestore.

  • Saat menurunkan nilai TTL, beberapa data mungkin memiliki periode retensi yang melebihi nilai baru. Tablestore akan menghapus data kedaluwarsa secara asinkron.

  • Saat menaikkan nilai TTL, Anda dapat mengakses data dalam tabel serial waktu selama Tablestore belum menghapusnya dan data disimpan dalam periode yang sesuai dengan nilai TTL baru.

TTL metadata serial waktu

Sebagai atribut tabel metadata serial waktu, TTL menunjukkan periode retensi metadata. Nilai TTL ditentukan dalam detik. Jika metadata disimpan melebihi nilai TTL yang ditentukan, Tablestore akan menghapusnya secara asinkron. Namun, data dalam tabel serial waktu tidak akan dihapus.

Penting

Jika metadata kedaluwarsa tetapi data serial waktu tidak, Anda dapat memanggil operasi GetTimeseriesData untuk mengakses data dalam tabel serial waktu dengan menentukan pengenal serial waktu.

Jika Anda tidak menentukan nilai TTL saat membuat tabel serial waktu, nilai default -1 akan digunakan, yang berarti metadata tidak pernah kedaluwarsa. Anda juga dapat menentukan nilai TTL kustom. Setelah tabel dibuat, Anda dapat memanggil operasi UpdateTimeseriesTable untuk memodifikasi TTL.

Penting

Atribut metadata serial waktu disimpan dalam kolom _attributes. Anda dapat memperbarui atribut tersebut jika TTL diatur ke -1. Nilai -1 menunjukkan bahwa metadata tidak pernah kedaluwarsa.

Jika ingin mengubah TTL metadata serial waktu dari -1 menjadi nilai yang lebih besar atau sama dengan 604.800 (7 hari), pastikan Anda tidak perlu memperbarui atribut metadata. Selain itu, atur Whether to Update Attributes of Time Series Metadata ke No.

Jika Anda mengatur Whether to Update Attributes of Time Series Metadata ke Yes, Anda harus mengatur TTL of Time Series Metadata ke -1.

Jika metadata disimpan melebihi nilai TTL, metadata menjadi tidak valid dan tidak dapat diakses meskipun belum dihapus oleh Tablestore.

  • Saat menurunkan nilai TTL, beberapa metadata mungkin memiliki periode retensi yang melebihi nilai baru. Tablestore akan menghapus metadata kedaluwarsa secara asinkron.

  • Saat menaikkan nilai TTL, Anda dapat mengakses metadata serial waktu selama Tablestore belum menghapusnya dan metadata disimpan dalam periode yang sesuai dengan nilai TTL baru.

Metode

Saat membuat tabel serial waktu, Anda dapat mengonfigurasi TTL untuk data dalam tabel. Anda juga dapat memodifikasi TTL setelah tabel dibuat. Topik ini memberikan contoh cara memodifikasi TTL setelah pembuatan tabel menggunakan konsol Tablestore, CLI, atau SDK.

Catatan
  • Untuk informasi lebih lanjut tentang cara mengonfigurasi TTL saat membuat tabel, lihat Operasi pada Tabel Serial Waktu.

  • Fitur yang didukung bervariasi tergantung pada metode yang digunakan untuk memodifikasi TTL.

Gunakan konsol Tablestore

Anda dapat menggunakan konsol Tablestore untuk memodifikasi TTL metadata serial waktu atau data dalam tabel serial waktu.

Modifikasi TTL data dalam tabel serial waktu

  1. Buka halaman Instance Management.

    1. Masuk ke Konsol Tablestore.

    2. Di bilah navigasi atas, pilih grup sumber daya dan wilayah.

    3. Di halaman Overview, klik nama instans yang ingin dikelola atau pilih Manage Instance di kolom Actions.

  2. Di bagian bawah tab Instance Details, klik tab Time Series Tables.

  3. Pada tab Time Series Tables, klik nama tabel deret waktu yang ingin dikelola.

  4. Pada tab Basic Information, di bagian Description, klik ikon image.png di sebelah Data Lifecycle.

  5. Di kotak dialog yang muncul, modifikasi nilai TTL.

    Nilai TTL adalah periode retensi data dalam tabel serial waktu. Unit: detik. Nilai harus -1 atau lebih besar atau sama dengan 86.400. Nilai -1 menunjukkan bahwa data tidak pernah kedaluwarsa. Nilai 86.400 menunjukkan 1 hari.

  6. Klik Yes.

Modifikasi TTL metadata serial waktu

  1. Buka halaman Instance Management.

    1. Masuk ke Konsol Tablestore.

    2. Di bilah navigasi atas, pilih grup sumber daya dan wilayah.

    3. Di halaman Overview, klik nama instans yang ingin dikelola atau pilih Manage Instance di kolom Actions.

  2. Di bagian bawah tab Instance Details, klik tab Time Series Tables.

  3. Di tab Time Series Tables, klik nama tabel serial waktu yang ingin dikelola.

  4. Di bagian Description pada tab Basic Information, klik ikon image.png di sebelah Data Lifecycle.

  5. Di kotak dialog yang muncul, modifikasi nilai TTL.

    Nilai TTL adalah periode retensi metadata serial waktu dalam tabel metadata serial waktu. Unit: detik. Nilai harus -1 atau lebih besar atau sama dengan 604.800. Nilai -1 menunjukkan bahwa metadata tidak pernah kedaluwarsa. Nilai 604.800 menunjukkan 7 hari.

  6. Klik Yes.

Gunakan CLI Tablestore

Anda dapat menggunakan CLI Tablestore untuk memodifikasi TTL data dalam tabel serial waktu.

Jalankan perintah alter untuk memperbarui konfigurasi tabel. Untuk informasi lebih lanjut, lihat Perbarui Tabel Serial Waktu.

Berikut adalah kode sampel untuk mengubah TTL data dalam tabel serial waktu menjadi 86.400 (1 hari):

alter --ttl 86400 --ts

Gunakan SDK Tablestore

Anda dapat menggunakan SDK Tablestore untuk memodifikasi TTL metadata serial waktu atau data dalam tabel serial waktu.

Modifikasi TTL data dalam tabel serial waktu

Berikut adalah kode sampel untuk mengubah TTL data dalam tabel serial waktu menjadi tiga tahun.

private static void updateTimeseriesTable(TimeseriesClient client) {
    // Tentukan nama tabel serial waktu. 
    String tableName = "<TIMESERIES_TABLE>";
    UpdateTimeseriesTableRequest updateTimeseriesTableRequest = new UpdateTimeseriesTableRequest(tableName);
    // Ubah TTL menjadi tiga tahun. 
    updateTimeseriesTableRequest.setTimeseriesTableOptions(new TimeseriesTableOptions(86400 * 365 * 3)); 
    client.updateTimeseriesTable(updateTimeseriesTableRequest);

    DescribeTimeseriesTableResponse describeTimeseriesTableResponse = client.describeTimeseriesTable(new DescribeTimeseriesTableRequest(tableName));
    TimeseriesTableMeta tableMeta = describeTimeseriesTableResponse.getTimeseriesTableMeta();
    // Lihat TTL yang dimodifikasi. 
    System.out.println(tableMeta.getTimeseriesTableOptions().getTimeToLive()); 
}

Modifikasi TTL metadata serial waktu

Berikut adalah kode sampel untuk mengubah nilai TTL metadata serial waktu menjadi 94.608.000 (3 tahun):

private static void updateTimeseriesMetaTableTTL(TimeseriesClient client) {
    // Tentukan nama tabel serial waktu. 
    String tableName = "<TIMESERIES_TABLE>";
    UpdateTimeseriesTableRequest updateTimeseriesTableRequest = new UpdateTimeseriesTableRequest(tableName);
    // Ubah nilai TTL menjadi 94608000 (3 tahun). 
    TimeseriesMetaOptions options = new TimeseriesMetaOptions();
    options.setMetaTimeToLive(86400 * 365 * 3);
    updateTimeseriesTableRequest.setTimeseriesMetaOptions(options);
    client.updateTimeseriesTable(updateTimeseriesTableRequest);
}

FAQ

Bagaimana cara menghapus data serial waktu?

Referensi

Penyimpanan analitik adalah mesin penyimpanan berbiaya rendah yang dirancang untuk data serial waktu. Anda dapat menggunakan penyimpanan analitik untuk menyimpan data serial waktu dengan biaya rendah serta menanyakan dan menganalisisnya secara efisien. Untuk informasi lebih lanjut, lihat Penyimpanan Analitik Serial Waktu.