Anda dapat mengonfigurasi aturan penerusan data untuk meneruskan data yang telah diproses ke Time Series Database (TSDB) guna penyimpanan. Topik ini menjelaskan proses penerusan data. Dalam contoh ini, topik komunikasi Thing Specification Language (TSL) digunakan sebagai topik sumber.
Prasyarat
Sebuah instance IoT Platform yang datanya dapat diteruskan ke TSDB harus dibuat di wilayah yang mendukung penerusan data ke TSDB. Untuk informasi lebih lanjut, lihat Wilayah.
Sumber data bernama DataSource harus dibuat dan topik komunikasi TSL ditambahkan ke sumber data. Untuk informasi lebih lanjut, lihat Buat Sumber Data.
- Sebuah instance TSDB yang berada dalam virtual private cloud (VPC) harus dibuat di wilayah Jepang (Tokyo). Untuk informasi lebih lanjut, lihat Dokumentasi TSDB.
Informasi Latar Belakang
Setelah mengonfigurasi tujuan data, konfigurasi berikut akan diselesaikan secara otomatis. Kemudian, Anda dapat meneruskan data perangkat ke instance TSDB menggunakan mesin aturan IoT Platform.
- IoT Platform menggunakan dua alamat IP dari vSwitch tempat instance TSDB berada. Blok CIDR IPv4 dari vSwitch ditambahkan ke daftar putih instance TSDB.
- Sebuah kelompok keamanan terkelola dibuat di VPC tempat instance TSDB berada. Nama default kelompok keamanan dimulai dengan sg-nsm-.
Dalam contoh ini, data berikut ditulis ke TSDB:
- timestamp: Gunakan fungsi
timestamp()untuk mendapatkan waktu ketika perangkat mengirimkan data. - tag: Gunakan fungsi
deviceName()untuk mendapatkan DeviceName. Tag{"deviceName":deviceName()}ditulis ke database. - metric: Gunakan ekspresi JSONPath untuk mendapatkan nilai properti Temperature dan Humidity yang dikirim oleh perangkat.
Batasan
- Data hanya dapat diteruskan dalam satu wilayah. Sebagai contoh, Anda hanya dapat meneruskan data dari instance IoT Platform yang ditempatkan di wilayah Jepang (Tokyo) ke instance TSDB yang ditempatkan di wilayah Jepang (Tokyo).
- Anda hanya dapat meneruskan data ke instance TSDB yang ditempatkan dalam VPC.
- Anda hanya dapat meneruskan data dalam format JSON.
- Dalam pesan yang diteruskan, semua bidang ditulis ke TSDB sebagai metric, kecuali bidang yang dikonfigurasikan sebagai timestamp dan nilai tag. Tipe data parameter metric mendukung numerik dan string. Jika Anda menggunakan tipe data lainnya, data mungkin gagal ditulis ke database.
Catatan Penggunaan
Anda juga dapat menggunakan fitur penerusan data versi baru atau sebelumnya untuk meneruskan data ke TSDB. Untuk informasi lebih lanjut tentang cara menggunakan fitur penerusan data versi sebelumnya, lihat Meneruskan Data ke TSDB.
Buat Tujuan Data
- Masuk ke Konsol IoT Platform.
Di halaman Overview, klik All environment. Di tab Semua Lingkungan, temukan instance yang ingin Anda kelola dan klik ID instance atau nama instance.
- Di panel navigasi kiri, pilih .
Di pojok kanan atas halaman Data Forwarding, klik Go to New Version untuk beralih ke versi baru.
CatatanJika Anda telah melakukan langkah ini, halaman Data Forwarding versi baru akan muncul setelah Anda memilih Penerusan Pesan > Penerusan Data.
Klik Data Destination. Di tab Tujuan Data, klik Create Data Destination.
Di kotak dialog Create Data Destination, masukkan nama tujuan data. Dalam contoh ini, DataPurpose digunakan. Konfigurasikan parameter dan klik OK.
Parameter
Deskripsi
Operasi
Pilih Store Data to TSDB.
Wilayah
Tentukan wilayah tempat instance IoT Platform Anda berada.
Instance TSDB
Tentukan instance TSDB yang telah Anda buat dalam VPC.
Tipe Data Metric
Tentukan tipe data parameter metric. Nilai valid: Numeric Type dan String.
Anda dapat mengklik ikon
untuk bantuan. Peran
Berikan IoT Platform izin untuk menulis data ke TSDB.
Konfigurasikan dan Mulai Parser
Buat parser bernama DataParser. Untuk informasi lebih lanjut, lihat Buat Parser.
Di halaman Parser Details, asosiasikan parser dengan sumber data yang telah dibuat.
Di langkah Data Source wizard, klik Associate Data Source.
Di kotak dialog yang muncul, pilih DataSource dari daftar drop-down Data Source, lalu klik OK.
Di halaman Parser Details, asosiasikan parser dengan tujuan data yang telah dibuat.
Klik Data Destination di wizard. Di bagian Data Destination, klik Associate Data Destination.
Di kotak dialog yang muncul, pilih DataPurpose dari daftar drop-down Data Destination, lalu klik OK.
Di bagian Tujuan Data, lihat dan simpan data destination ID. Dalam contoh ini, ID adalah 1000.
Saat menulis skrip parser, Anda harus menggunakan data destination ID.
Di halaman parser details, klik Parser Script.
Di editor kode, masukkan skrip. Untuk informasi lebih lanjut tentang cara memodifikasi skrip, lihat Sintaks Skrip.
Untuk informasi lebih lanjut tentang parameter fungsi, lihat Fungsi.
// Gunakan fungsi payload() untuk mendapatkan data yang dikirimkan oleh perangkat dan ubah data menjadi format JSON. var data = payload("json"); // Filter nilai suhu dan kelembaban yang dikirimkan. var h = data.items.Humidity.value; var t = data.items.Temperature.value; // Teruskan data TSL yang dikirimkan. writeTsdb(1000,timestamp(),"temperature", t , {"deviceName":deviceName()}); writeTsdb(1000,timestamp(),"humidity", h , {"deviceName":deviceName()});Klik Debugging. Di kotak dialog yang muncul, pilih produk dan perangkat, tentukan topik, lalu masukkan data payload untuk memeriksa apakah skrip berjalan sesuai harapan.
Gambar berikut menunjukkan parameter.

Hasil berikut menunjukkan bahwa skrip berjalan sesuai harapan.

Klik Publish.
Pergi ke tab Parser halaman Data Forwarding. Temukan parser DataParser dan klik Start di kolom Aksi untuk memulai parser.