全部产品
Search
文档中心

Tablestore:Operasi pada tabel deret waktu

更新时间:Jul 02, 2025

Bagian ini menjelaskan cara menggunakan CLI Tablestore untuk melakukan berbagai operasi pada tabel deret waktu. Sebagai contoh, Anda dapat membuat, menggunakan, memperbarui, dan menghapus tabel deret waktu. Selain itu, Anda juga dapat melihat informasi terkait tabel deret waktu serta menampilkan nama-nama tabel tersebut.

Catatan

Untuk informasi lebih lanjut tentang model TimeSeries, lihat Ikhtisar.

Buat tabel deret waktu

Buat tabel deret waktu dengan nilai time to live (TTL) yang ditentukan.

Sintaksis perintah

create -m mode -t tableName --ttl timeToLive

Tabel berikut menjelaskan parameter yang dapat dikonfigurasi untuk membuat tabel deret waktu.

Parameter

Diperlukan

Contoh

Deskripsi

-m, --model

Ya

timeseries

Jenis tabel yang ingin Anda buat. Nilai default: widecolumn. Nilai valid:

  • widecolumn: tabel data.

  • timeseries: tabel deret waktu.

-t, --table

Ya

mytable

Nama tabel deret waktu.

--ttl

Tidak

864000

TTL dari data dalam tabel deret waktu. Unit: detik. Nilai default adalah -1, yang menentukan bahwa data tidak pernah kedaluwarsa.

Jika sistem mendeteksi bahwa selisih antara waktu saat ini dan kolom waktu yang diteruskan ke tabel melebihi nilai TTL yang ditentukan, sistem secara otomatis akan menghapus data yang kedaluwarsa.

Penting

Dalam tabel deret waktu, sistem menentukan waktu pembuatan data berdasarkan kolom waktu yang diteruskan ke tabel, bukan berdasarkan waktu ketika data ditulis ke tabel.

Nilai parameter ini harus -1, atau lebih besar dari atau sama dengan 86400 (1 hari). Nilai -1 menentukan bahwa data tidak pernah kedaluwarsa.

Contoh

Buat tabel deret waktu bernama mytable di mana data tidak pernah kedaluwarsa.

create -m timeseries -t mytable --ttl -1

Gunakan tabel deret waktu

Pilih tabel tempat Anda ingin melakukan operasi tabel atau operasi data.

Sintaksis perintah

use --ts -t tableName

Tabel berikut menjelaskan parameter yang harus dikonfigurasi untuk menggunakan tabel deret waktu.

Parameter

Diperlukan

Contoh

Deskripsi

--ts

Ya

N/A

Menentukan bahwa tabel yang ingin Anda gunakan adalah tabel deret waktu.

-t, --table

Ya

mytable

Nama tabel deret waktu.

Contoh

Gunakan tabel deret waktu bernama mytable.

use --ts -t mytable

Perbarui tabel deret waktu

Ubah konfigurasi TTL tabel deret waktu.

Sintaksis perintah

alter --ttl timeToLive --ts

Tabel berikut menjelaskan parameter yang harus dikonfigurasi untuk memperbarui tabel deret waktu.

Parameter

Diperlukan

Contoh

Deskripsi

--ts

Ya

N/A

Menentukan bahwa tabel yang ingin Anda ubah konfigurasi TTL-nya adalah tabel deret waktu.

--ttl

Ya

864000

TTL dari data dalam tabel deret waktu. Unit: detik. Nilai default adalah -1, yang menentukan bahwa data tidak pernah kedaluwarsa.

Jika sistem mendeteksi bahwa selisih antara waktu saat ini dan kolom waktu yang diteruskan ke tabel melebihi nilai TTL yang ditentukan, sistem secara otomatis akan menghapus data yang kedaluwarsa.

Penting

Dalam tabel deret waktu, sistem menentukan waktu pembuatan data berdasarkan kolom waktu yang diteruskan ke tabel, bukan berdasarkan waktu ketika data ditulis ke tabel.

Nilai parameter ini harus -1, atau lebih besar dari atau sama dengan 86400 (1 hari). Nilai -1 menentukan bahwa data tidak pernah kedaluwarsa.

Contoh

Atur nilai TTL tabel saat ini menjadi 86.400 detik.

alter --ttl 86400 --ts

Kueri informasi tentang tabel deret waktu

Kueri informasi terkait tabel deret waktu.

Sintaksis perintah

desc --ts -t tableName

Tabel berikut menjelaskan parameter yang dapat dikonfigurasikan untuk menanyakan informasi tentang tabel deret waktu.

Parameter

Diperlukan

Contoh

Deskripsi

--ts

Tidak

N/A

Menentukan bahwa tabel yang ingin Anda tanyakan informasinya adalah tabel deret waktu.

-t,--table

Tidak

mytable

Nama tabel deret waktu. Parameter ini opsional.

-f,--print_format

Tidak

json

Format keluaran informasi tentang tabel. Nilai default: json. Nilai valid: json dan table.

-o, --output

Tidak

/tmp/describe_table_meta.json

Path file JSON lokal tempat informasi tentang tabel deret waktu disimpan.

Contoh

Kueri informasi tentang tabel saat ini.

desc

Kueri informasi tentang tabel deret waktu bernama mytable.

desc --ts -t mytable

Hapus tabel deret waktu

Hapus tabel deret waktu yang tidak lagi diperlukan.

Sintaksis perintah

drop -t tableName --ts -y

Tabel berikut menjelaskan parameter yang harus dikonfigurasikan untuk menghapus tabel deret waktu.

Parameter

Diperlukan

Contoh

Deskripsi

-t, --table

Ya

mytable

Nama tabel deret waktu.

-y, --yes

Ya

N/A

Menentukan bahwa informasi konfirmasi ditampilkan. Parameter ini diperlukan.

--ts

Ya

N/A

Menentukan bahwa tabel yang ingin Anda hapus adalah tabel deret waktu.

Contoh

Hapus tabel deret waktu bernama mytable.

drop -t mytable --ts -y

Daftar nama tabel

Daftarkan nama semua tabel, tabel data, atau tabel deret waktu dalam suatu instance.

Sintaksis perintah

list

Parameter

Parameter

Diperlukan

Contoh

Deskripsi

-a, --all

Tidak

N/A

Mendaftarkan nama semua tabel.

-d, --detail

Tidak

N/A

Mendaftarkan detail tabel.

-w, --wc

Tidak

N/A

Mendaftarkan nama semua tabel data.

-t, --ts

Tidak

N/A

Mendaftarkan nama semua tabel deret waktu.

Contoh

  • Daftarkan nama semua tabel dengan jenis yang sama seperti tabel saat ini.

    list
  • Daftarkan nama semua tabel.

    list -a
  • Daftarkan nama semua tabel data.

    list -w
  • Daftarkan nama semua tabel deret waktu.

    list -t