Anda dapat memanggil operasi CreateTimeseriesTable untuk membuat tabel deret waktu. Saat membuat tabel deret waktu, Anda dapat menentukan masa hidup (TTL) data, konfigurasi metadata deret waktu, pengenal deret waktu kustom, serta bidang data kustom sebagai kolom kunci utama. Anda juga dapat membuat indeks Lastpoint dan penyimpanan analitik. Penyimpanan analitik digunakan untuk menganalisis data deret waktu secara cepat, sedangkan indeks Lastpoint digunakan untuk mengambil data titik terbaru dalam tabel deret waktu.
Prasyarat
Sebuah instance untuk model TimeSeries telah dibuat. Untuk informasi lebih lanjut, lihat Buat instance untuk model TimeSeries.
PentingUntuk menggunakan fitur penyimpanan analitik atau indeks Lastpoint, Anda harus membuat instance untuk model TimeSeries di wilayah yang mendukung fitur tersebut.
Klien telah diinisialisasi. Untuk informasi lebih lanjut, lihat Inisialisasi klien Tablestore.
Catatan Penggunaan
Nama tabel deret waktu yang Anda buat tidak boleh sama dengan nama tabel data yang sudah ada.
CatatanAnda dapat memanggil operasi ListTimeseriesTable untuk menanyakan nama-nama tabel deret waktu dalam sebuah instance. Untuk informasi lebih lanjut, lihat Menanyakan nama-nama tabel deret waktu.
Anda hanya dapat membuat satu penyimpanan analitik untuk setiap tabel deret waktu.
Jumlah total indeks Lastpoint dan penyimpanan analitik yang Anda buat untuk tabel deret waktu tidak boleh melebihi 10.
Anda dapat menentukan hingga empat bidang data sebagai kolom kunci utama tabel deret waktu.
Anda dapat menentukan hingga enam bidang sebagai pengenal deret waktu kustom dari tabel deret waktu.
Operasi
public class CreateTimeseriesTableRequest implements Request {
/**Informasi skema tabel deret waktu.*/
private TimeseriesTableMeta timeseriesTableMeta;
/**Informasi penyimpanan analitik.*/
private List<TimeseriesAnalyticalStore> analyticalStores = new ArrayList<TimeseriesAnalyticalStore>();
/**Apakah fitur penyimpanan analitik diaktifkan.*/
private boolean enableAnalyticalStore = true;
}Parameter
Parameter | Deskripsi |
TimeseriesTableMeta | Konfigurasi tabel deret waktu.
|
enableAnalyticalStore | Menentukan apakah akan membuat penyimpanan analitik default. Nilai default: true, yang menentukan bahwa penyimpanan analitik default dibuat. Setelah Anda membuat penyimpanan analitik, Anda dapat menggunakan penyimpanan analitik untuk menyimpan data deret waktu dengan biaya rendah dan menanyakan serta menganalisis data deret waktu. Untuk informasi lebih lanjut, lihat Penyimpanan analitik untuk deret waktu. Jika Anda tidak ingin membuat penyimpanan analitik, atur parameter ini ke false. |
analyticalStores | Konfigurasi penyimpanan analitik, yang terdiri dari item-item berikut:
|
Contoh
Buat tabel deret waktu tanpa penyimpanan analitik
Kode sampel berikut menunjukkan cara membuat tabel deret waktu bernama test_timeseries_table di mana data tidak pernah kedaluwarsa:
private static void createTimeseriesTable(TimeseriesClient client) {
String tableName = "test_timeseries_table";
TimeseriesTableMeta timeseriesTableMeta = new TimeseriesTableMeta(tableName);
int timeToLive = -1;
timeseriesTableMeta.setTimeseriesTableOptions(new TimeseriesTableOptions(timeToLive));
CreateTimeseriesTableRequest request = new CreateTimeseriesTableRequest(timeseriesTableMeta);
// Tentukan bahwa penyimpanan analitik default tidak dibuat.
request.setEnableAnalyticalStore(false);
client.createTimeseriesTable(request);
}Buat tabel deret waktu dan penyimpanan analitik
Saat membuat tabel deret waktu, Anda dapat membuat penyimpanan analitik default atau penyimpanan analitik kustom.
Buat tabel deret waktu dan penyimpanan analitik default
Kode sampel berikut menunjukkan cara membuat tabel deret waktu bernama test_timeseries_table di mana data tidak pernah kedaluwarsa dan penyimpanan analitik default pada saat yang sama. Dalam contoh ini, nama penyimpanan analitik default adalah default_analytical_store dan data dalam penyimpanan analitik default tidak pernah kedaluwarsa.
private static void createTimeseriesTable(TimeseriesClient client) {
String tableName = "test_timeseries_table";
TimeseriesTableMeta timeseriesTableMeta = new TimeseriesTableMeta(tableName);
int timeToLive = -1;
timeseriesTableMeta.setTimeseriesTableOptions(new TimeseriesTableOptions(timeToLive));
CreateTimeseriesTableRequest request = new CreateTimeseriesTableRequest(timeseriesTableMeta);
client.createTimeseriesTable(request);
}Buat tabel deret waktu dan penyimpanan analitik kustom
Kode sampel berikut menunjukkan cara membuat tabel deret waktu bernama test_timeseries_table di mana data tidak pernah kedaluwarsa dan penyimpanan analitik kustom pada saat yang sama. Dalam contoh ini, nama penyimpanan analitik kustom adalah test_analytical_store dan data dalam penyimpanan analitik kustom tidak pernah kedaluwarsa.
private static void createTimeseriesTable(TimeseriesClient client) {
// Tentukan nama dan TTL tabel deret waktu.
String tableName = "test_timeseries_table";
TimeseriesTableMeta timeseriesTableMeta = new TimeseriesTableMeta(tableName);
int timeToLive = -1;
timeseriesTableMeta.setTimeseriesTableOptions(new TimeseriesTableOptions(timeToLive));
CreateTimeseriesTableRequest request = new CreateTimeseriesTableRequest(timeseriesTableMeta);
// Tentukan konfigurasi penyimpanan analitik kustom.
List<TimeseriesAnalyticalStore> analyticalStores = new ArrayList<TimeseriesAnalyticalStore>();
analyticalStores.add(new TimeseriesAnalyticalStore("test_analytical_store"));
request.setAnalyticalStores(analyticalStores);
client.createTimeseriesTable(request);
}Tentukan pengenal deret waktu kustom dan bidang data kustom sebagai kolom kunci utama tabel deret waktu
Tablestore SDK for Java V5.17.1 atau yang lebih baru memungkinkan Anda menentukan pengenal deret waktu kustom dan bidang data kustom sebagai kolom kunci utama tabel deret waktu. Pastikan Anda menggunakan versi Tablestore SDK for Java yang benar. Untuk informasi lebih lanjut, lihat Riwayat versi Tablestore SDK for Java.
Kode sampel berikut menunjukkan cara membuat tabel deret waktu di mana pengenal deret waktu terdiri dari pk1 dan pk2 dan bidang data field1 (Integer), field2 (String), dan field3 (Binary) ditentukan sebagai kolom kunci utama:
private static void createTimeseriesTable(TimeseriesClient client) {
String tableName = "test_timeseries_table";
TimeseriesTableMeta timeseriesTableMeta = new TimeseriesTableMeta(tableName);
timeseriesTableMeta.addTimeseriesKey("pk1");
timeseriesTableMeta.addTimeseriesKey("pk2");
timeseriesTableMeta.addFieldPrimaryKey("field1", PrimaryKeyType.INTEGER);
timeseriesTableMeta.addFieldPrimaryKey("field2", PrimaryKeyType.STRING);
timeseriesTableMeta.addFieldPrimaryKey("field3", PrimaryKeyType.BINARY);
int timeToLive = -1;
timeseriesTableMeta.setTimeseriesTableOptions(new TimeseriesTableOptions(timeToLive));
CreateTimeseriesTableRequest request = new CreateTimeseriesTableRequest(timeseriesTableMeta);
client.createTimeseriesTable(request);
}Buat tabel deret waktu dan indeks Lastpoint
Tablestore SDK for Java V5.17.1 atau yang lebih baru mendukung fitur indeks Lastpoint. Pastikan Anda menggunakan versi Tablestore SDK for Java yang benar. Untuk informasi lebih lanjut, lihat Riwayat versi Tablestore SDK for Java.
Kode sampel berikut menunjukkan cara membuat tabel deret waktu dan indeks Lastpoint bernama index1 untuk tabel deret waktu pada saat yang sama:
private static void createTimeseriesTable(TimeseriesClient client) {
String tableName = "test_timeseries_table";
TimeseriesTableMeta timeseriesTableMeta = new TimeseriesTableMeta(tableName);
int timeToLive = -1;
timeseriesTableMeta.setTimeseriesTableOptions(new TimeseriesTableOptions(timeToLive));
CreateTimeseriesTableRequest request = new CreateTimeseriesTableRequest(timeseriesTableMeta);
request.addLastpointIndex(new CreateTimeseriesTableRequest.LastpointIndex("index1"));
client.createTimeseriesTable(request);
}Referensi
Setelah membuat tabel deret waktu, Anda dapat menulis data deret waktu ke tabel dan membaca data deret waktu dari tabel. Untuk informasi lebih lanjut, lihat Tulis data deret waktu dan Tanyakan data deret waktu.
Untuk menyimpan data deret waktu dengan biaya rendah dan menanyakan serta menganalisis data deret waktu secara cepat, Anda dapat membuat penyimpanan analitik untuk tabel deret waktu. Untuk informasi lebih lanjut, lihat Buat penyimpanan analitik.
Untuk informasi tentang cara memodifikasi TTL data dalam tabel deret waktu, lihat Modifikasi konfigurasi tabel deret waktu.
Untuk informasi tentang cara menanyakan nama semua tabel deret waktu dalam sebuah instance, lihat Tanyakan nama tabel deret waktu.
Untuk informasi tentang cara menanyakan informasi tentang tabel deret waktu, lihat Tanyakan informasi tabel deret waktu.
Untuk informasi tentang cara menghapus tabel deret waktu yang tidak lagi Anda butuhkan, lihat Hapus tabel deret waktu.
Untuk mencadangkan data deret waktu di Tablestore secara hemat biaya atau mengekspor data deret waktu sebagai file ke perangkat lokal, Anda dapat menggunakan layanan Integrasi Data dari DataWorks untuk menyinkronkan data deret waktu dari Tablestore ke Object Storage Service (OSS) untuk penyimpanan atau unduhan. Untuk informasi lebih lanjut, lihat Sinkronkan data dari Tablestore ke OSS.
Untuk informasi tentang cara menghubungkan Tablestore ke Grafana untuk memvisualisasikan data deret waktu, lihat Hubungkan Tablestore ke Grafana.
Jika Anda menggunakan Realtime Compute for Apache Flink untuk menghitung dan menganalisis data, Anda dapat menggunakan tabel deret waktu Tablestore untuk menyimpan hasilnya. Untuk informasi lebih lanjut, lihat Tutorial (Model TimeSeries).