IoT Platform：Penerusan data ke TSDB

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 data deret waktu, kecuali untuk bidang yang dikonfigurasikan sebagai timestamp dan nilai tag. Tipe data parameter data deret waktu mendukung numerik dan string. Jika Anda menggunakan tipe data lainnya, data mungkin gagal ditulis ke database.

Catatan penggunaan

Anda dapat menggunakan versi baru atau lama fitur penerusan data untuk meneruskan data ke Lindorm. Untuk informasi lebih lanjut tentang cara menggunakan versi baru fitur penerusan data, lihat Gunakan Versi Baru Fitur Penerusan Data untuk Meneruskan Data ke Lindorm.

Prosedur

1. Masuk ke Konsol IoT Platform.

2. Di halaman Overview, klik All environment. Pada tab Semua lingkungan, temukan instance yang ingin Anda kelola dan klik ID instance atau nama instance.

3. Di panel navigasi kiri, pilih Message Forwarding > Data Forwarding.
4. Klik View di samping aturan yang ingin Anda kelola. Halaman Data Forwarding Rule muncul.
   Penting Jika versi baru halaman Penerusan Data ditampilkan, klik Back to Previous Version di pojok kanan atas, lalu klik View di kolom Aksi aturan yang ingin Anda kelola.
5. Di bagian Forward Data, klik Add Operation.
6. Di kotak dialog Add Operation, pilih Store Data to TSDB dari daftar drop-down Operasi. Ikuti petunjuk di halaman untuk mengatur parameter lainnya dan klik OK.

   Parameter	Deskripsi
   Operasi	Pilih Store Data to TSDB.
   Wilayah	Wilayah tempat instance IoT Platform Anda ditempatkan: Jepang (Tokyo)
   Instance TSDB	Tentukan instance TSDB di VPC yang telah Anda buat sebagai tujuan ke mana data diteruskan.
   Tipe Data Metric	Tentukan tipe data parameter metric. Nilai valid: Numeric Type dan String. Klik ikon untuk mendapatkan informasi lebih lanjut.
   timestamp	Timestamp. Konfigurasi berikut didukung: Gunakan ekspresi karakter escape ${}. Sebagai contoh, atur parameter menjadi ${time}. Ini menentukan bahwa nilai parameter sesuai dengan nilai bidang time dalam pesan di topik sumber data. Gunakan fungsi mesin aturan timestamp(). Ini menentukan bahwa nilai parameter diatur ke timestamp server mesin aturan. Masukkan nilai. Nilai input harus berupa timestamp UNIX. Sebagai contoh, Anda dapat memasukkan 1404955893000.
   Nama Tag	Tentukan nama tag yang digunakan untuk mengidentifikasi data. Nama tag dapat berisi huruf, angka, dan karakter khusus berikut: :,.'/-_()[]
   Nilai Tag	Tentukan nilai tag. Konfigurasi berikut didukung: Gunakan ekspresi karakter escape ${}. Sebagai contoh, jika struktur pesan dalam topik sumber data berisi properti lokasi dengan kunci city, Anda dapat mengatur nilai tag menjadi ${city}. Ini menentukan bahwa nilai parameter sesuai dengan nilai bidang city dalam pesan. Kami sarankan Anda menggunakan konfigurasi ini. Gunakan fungsi yang ditentukan dalam mesin aturan, seperti deviceName(). Ini menentukan bahwa nilai tag adalah nama perangkat. Untuk informasi lebih lanjut tentang fungsi yang didukung, lihat Fungsi. Masukkan konstanta. Sebagai contoh, Anda dapat memasukkan konstanta beijing. Nilai tersebut dapat berisi huruf, angka, dan karakter khusus berikut: :,.'/-_()[] Catatan Anda dapat menambahkan maksimal delapan nama tag dan delapan nilai tag. Pastikan TSDB dapat memperoleh nama tag dan nilai tag yang dikonfigurasikan. Jika TSDB tidak dapat memperoleh nama atau nilai tag, data tidak dapat ditulis ke database.
   Peran	Berikan IoT Platform izin untuk menulis data ke TSDB.

7. Buka halaman Data Forwarding, temukan aturan yang Anda kelola, lalu klik Start di kolom Aksi aturan tersebut.

Contoh penerusan data

Blok kode berikut memberikan contoh pernyataan SQL dalam aturan penerusan data:

SELECT time,city,power,distance FROM "/alprodu****/myDevice/user/update";

Berikut ini menunjukkan bagaimana mesin aturan memproses data dan menulis data ke TSDB berdasarkan pernyataan SQL.

1. Contoh pernyataan SQL menunjukkan bahwa mesin aturan menyaring bidang time, city, power, dan distance dari pesan-pesan dalam topik /alprodu****/myDevice/user/update dan menggunakan isi bidang yang disaring sebagai isi pesan untuk diteruskan.

   Berikut ini adalah contoh isi pesan yang diteruskan setelah data diproses berdasarkan pernyataan SQL sebelumnya:

   {
   "time": 1513677897,
   "city": "beijing",
   "distance": 8545,
   "power": 93.0
   }

2. Mesin aturan menulis dua baris data ke TSDB berdasarkan operasi penerusan data yang dikonfigurasi.

   Dalam contoh ini, data berikut ditulis ke TSDB:

   • Data: timestamp:1513677897, [metric:power value:93.0]
     tag: cityName=beijing

   • Data: timestamp:1513677897, [metric:distance value:8545]
     tag: cityName=beijing

   Berikut ini menjelaskan bagaimana data ditulis ke TSDB:

   Dalam pesan yang diteruskan sebelumnya, kecuali untuk bidang time yang dikonfigurasikan sebagai timestamp dan bidang city yang dikonfigurasikan sebagai nilai tag, bidang lainnya (power dan distance) ditulis ke TSDB sebagai data deret waktu.