IoT Platform:Teruskan data ke TSDB

Batasan

• Data hanya dapat diteruskan dalam wilayah yang sama. Misalnya, data dari instans IoT Platform di wilayah Jepang (Tokyo) hanya dapat diteruskan ke instans TSDB di wilayah Jepang (Tokyo).
• Data hanya dapat diteruskan ke instans TSDB yang berada di virtual private cloud (VPC).
• Hanya data dalam format JSON yang dapat diteruskan.
• Dalam pesan yang diteruskan, semua bidang ditulis ke Time Series Database sebagai metric, kecuali bidang yang dikonfigurasi sebagai timestamp dan nilai tag. Tipe data metric mendukung nilai numerik dan string. Tipe data lain menyebabkan operasi penulisan gagal.

Catatan penggunaan

Anda juga dapat menggunakan fitur penerusan data versi baru atau versi sebelumnya untuk meneruskan data ke TSDB. Untuk informasi selengkapnya, lihat Teruskan data ke TSDB.

Buat tujuan data

1. Masuk ke Konsol IoT Platform.

2. Pada halaman Overview, temukan instans yang ingin Anda kelola lalu klik ID instans atau nama instans tersebut.

3. Di panel navigasi sebelah kiri, pilih Message Forwarding > Data Forwarding.

4. Pada halaman Data Forwarding, klik Go to New Version di pojok kanan atas.

   Catatan

   Jika Anda sebelumnya telah melakukan operasi ini, Anda akan diarahkan secara otomatis ke halaman Data Forwarding versi baru.

5. Klik tab Data destination, lalu klik Create data destination.

6. Pada dialog Create Data Destination, masukkan nama tujuan data. Dalam contoh ini, digunakan DataPurpose. Konfigurasikan parameter dan klik OK.

   Parameter	Deskripsi
   Operation	Pilih Store Data to TSDB.
   Region	Wilayah instans IoT Platform Anda.
   TSDB Instance	Instans TSDB yang telah Anda buat di VPC.
   metric Data Type	Tipe data parameter metric. Nilai yang valid: Numeric Type dan String. Anda dapat mengklik ikon untuk bantuan.
   Role	Otorisasi IoT Platform untuk menulis data ke TSDB.

Konfigurasikan dan mulai parser

1. Buat parser, misalnya DataParser. Untuk informasi selengkapnya, lihat Langkah 1: Buat parser.

2. Pada halaman Resolver Details, asosiasikan sumber data.

   1. Di wizard konfigurasi, di bawah Data Source, klik Associate Data Source.

   2. Di dialog yang muncul, pilih DataSource dari daftar drop-down Data Source lalu klik OK.

3. Pada halaman Resolver Details, Anda dapat mengasosiasikan tujuan data.

   1. Di wizard konfigurasi, klik Data Destination. Lalu, di pojok kanan atas daftar Data Destination, klik Associate Data Destination.

   2. Di dialog yang muncul, dari daftar drop-down Data Destination, pilih DataPurpose lalu klik OK.

   3. Di daftar tujuan data, temukan Data Destination ID dan catat nilainya. Misalnya, 1000.

      Anda akan memerlukan Data Destination ID ini dalam skrip parsing.

4. Pada halaman parser details, klik tab Parser Script.

5. Di editor kode, masukkan skrip. Untuk informasi selengkapnya tentang cara memodifikasi skrip, lihat Sintaksis skrip.

   Untuk informasi selengkapnya tentang parameter fungsi, lihat Daftar fungsi.

   // Gunakan fungsi payload() untuk mendapatkan data yang dikirimkan oleh perangkat dan mengonversi data tersebut menjadi Data berformat JSON. 
   var data = payload("json");
   // Filter nilai suhu dan kelembapan 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()});

6. Klik Debugging. Di dialog yang muncul, pilih produk dan perangkat, tentukan topik, lalu masukkan data muatan untuk memeriksa apakah skrip berjalan sesuai harapan.

   Tentukan parameter berikut:

   • Topic: /${productKey}/${deviceName}/thing/event/property/post

   • Payload data: Struktur JSON yang berisi productKey, gmtCreate, deviceName, dan objek items, di mana items berisi Temperature (value: 70).

   Hasil berikut menunjukkan bahwa skrip berjalan sesuai harapan.

   action:
     transmit to tsdb[destinationId=1000]

7. Klik Publish.

8. Kembali ke tab Resolver pada halaman Data Forwarding lalu klik Start untuk resolver DataParser.