Konfigurasi node sumber untuk mendefinisikan sumber data untuk parsing data - IoT Platform

Topik ini menjelaskan langkah-langkah untuk mengonfigurasi node sumber di ruang kerja penguraian data, yang berfungsi sebagai sumber data untuk tugas penguraian selanjutnya.

Prasyarat

Pastikan Anda telah membuat tugas penguraian data. Untuk detail lebih lanjut, lihat Buat tugas penguraian data.

Informasi latar belakang

Untuk gambaran umum fitur penguraian data, lihat Catatan Penggunaan.
Untuk panduan menavigasi ruang kerja penguraian data, lihat Instruksi Ruang Kerja Penguraian Data.

Prosedur

Akses konsol penguraian data.
Di dalam ruang kerja, klik sekali pada Source Node default di kanvas.

Di panel konfigurasi di sebelah kanan, atur Basic Information sesuai dengan Data Source Type yang digunakan.

Untuk tipe IoT Instance Topic, konfigurasikan parameter berikut untuk memproses data dari perangkat menggunakan topik komunikasi bahasa spesifikasi atau kustom.

Nama Parameter	Deskripsi	Referensi
Instance Terkait	Menampilkan semua instance di bawah akun Alibaba Cloud saat ini dalam daftar drop-down.	Ikhtisar
Produk Terkait	Daftar drop-down menunjukkan semua nama produk di bawah instance yang dipilih.	Buat produk
Perangkat Terkait	Pilih dari perangkat di bawah produk yang dipilih, hanya opsi All Devices yang tersedia.	Buat perangkat
Tipe Topik	Opsi: System Topic, topik kustom, topik komunikasi Bahasa Spesifikasi Hal. Lihat "Tabel Deskripsi Tipe Topik" di bawah untuk instruksi terperinci.	Topik
Nama Topik	Data komunikasi topik ini adalah sumber untuk tugas penguraian. Untuk topik kustom produk gateway cloud: Masukkan nama topik secara manual di bidang Topic Name, misalnya, `/${productKey}/${deviceName}/user/update`. Untuk skenario lain: Pilih topik untuk analisis dari daftar Topic Name.	Kategori topik

Lihat Tabel Deskripsi Topic Type:

Perangkat	Topik Sistem	Topik Kustom	Topik Bahasa Spesifikasi Hal
Perangkat Gateway Cloud: MQTT	Tidak didukung.	Didukung. Untuk detail lebih lanjut, lihat Tambahkan kategori topik kustom.	Menyokong tipe properti dan kejadian. Untuk detail lebih lanjut, lihat Perangkat mengirimkan data properti ke IoT Platform.
Perangkat Gateway Cloud: NB-IoT	Tidak didukung.
Perangkat Gateway Cloud: JT/T 808	Menyokong topik data laporan perangkat: `$JT808/${manufacturer}/${deviceModel}/${deviceId}/up`. Untuk detail lebih lanjut, lihat Pengiriman data perangkat.	Tidak didukung.
Perangkat Gateway Cloud: GB/T 32960	Menyokong topik data laporan perangkat: `$GB23960/${VIN}/up`. Untuk detail lebih lanjut, lihat Pengiriman data perangkat.	Tidak didukung.
Perangkat Non-Gateway Cloud	Menyokong topik publikasi bayangan perangkat: `/shadow/update/${YourProductKey}/${YourDeviceName}`. Untuk detail lebih lanjut, lihat Penerusan data bayangan perangkat.	Didukung. Untuk instruksi terperinci, silakan lihat Tambahkan kategori topik kustom.

Untuk tipe API Data Source, pilih sumber data API tertentu untuk memproses data eksternal yang diimpor melalui API.
Untuk informasi lebih lanjut, lihat Konfigurasi sumber data API.

Klik Next, pilih Topic Format, dan atur format penguraian.

JSON, ProtoBuf, Base64(to_JSON)

Berdasarkan format Topik yang dipilih, konfigurasikan data sampel.

Catatan

Jika data telah dilaporkan dalam 7 hari terakhir, klik Tarik data online untuk mengisi data sampel secara otomatis.

Format Topik	Konfigurasi sampel
JSON	Masukkan data sampel langsung di bidang Sample Data, pastikan ukuran konten tidak melebihi 16 KB.
ProtoBuf	Klik Unggah file .desc untuk mengunggah file `.desc` yang diperlukan untuk mengurai data format ProtoBuf. Lihat Lampiran: Menghasilkan file .desc untuk metode pembuatan file .desc. Setelah memilih tipe pesan, klik Unggah file data biner untuk memasukkan data sampel.
Base64(to_JSON)	Klik Unggah file data Base64 untuk mengunggah data sampel.

Setelah data sampel dikonfigurasi, klik Validasi penguraian:
- Jika penguraian berhasil, struktur data akan ditampilkan di Parsing Preview.
- Jika penguraian gagal, revisi data sampel sesuai saran dan validasi ulang.
Pilih opsi Pass-through.
- Tidak (default).
- Ya: Memilih opsi ini berarti hanya data yang diuraikan yang akan melewati Topik, dan penyimpanan data kustom serta analisis SQL offline tidak akan didukung.
Klik Save.
Struktur bidang yang diuraikan, termasuk nama dan tipe data, akan terdaftar di bawah Data Structure di bawah kanvas.
Catatan
Jika Pass-through disetel ke Yes, semua node setelah Source Node akan dihapus, dan Target Node akan ditambahkan dan terhubung secara otomatis. Dalam hal ini, tidak ada node lain yang dapat dimasukkan antara Source Node dan Target Node.

Data mentah

Pilih Pass-through.
- Tidak (default).
- Ya: Saat dipilih, hanya data yang diuraikan yang akan ditransmisikan melalui Topik. Penyimpanan data kustom dan analisis SQL offline tidak akan didukung.
Klik Save.
Sebuah node Custom akan dibuat secara otomatis dan terhubung ke Source Node di kanvas.
Tidak ada node yang dapat dimasukkan antara Source Node dan node Custom. Semua node yang sebelumnya terhubung setelah Source Node akan dialihkan ke node Custom.
Catatan
Jika Pass-through disetel ke Yes, semua node setelah Source Node akan dihapus, dan sebuah Target Node akan ditambahkan dan terhubung secara otomatis setelah node Custom. Dalam hal ini, tidak ada node yang dapat ditempatkan antara node Custom dan Target Node.

Atur skrip node Custom untuk memproses data mentah.

Klik pada node Custom di kanvas.

Di panel skrip kustom, pilih bahasa skrip dan masukkan skrip Anda di bawah Edit skrip.

Bahasa Skrip yang Didukung	Fungsi yang Harus Didefinisikan	Contoh Kode
JavaScript (ECMAScript 5)	executeScript()	Contoh skrip JavaScript
Python 2.7	execute_script()	Contoh skrip Python
PHP 7.2	executeScript()	Contoh skrip PHP

Di tab Analog Input, masukkan data yang dilaporkan oleh perangkat simulasi.
Klik Execute.
Setelah eksekusi berhasil, data yang diproses akan ditampilkan di tab Execution Result. Untuk melihat log eksekusi skrip, klik tab Execution Log.

Untuk menyelesaikan konfigurasi node sumber, klik sekali Save yang terletak di pojok kanan atas Workbench Analisis Data.

Apa yang harus dilakukan selanjutnya

Setelah konfigurasi node sumber selesai, lanjutkan untuk menyiapkan node pemrosesan tambahan untuk penguraian data atau konfigurasikan node target untuk menyelesaikan konfigurasi tugas penguraian.

Lampiran: Menghasilkan File .desc

Penting

Sebelum mengonfigurasi data sampel dalam format ProtoBuf, penting untuk mengunggah file .desc yang sesuai untuk penguraian data.
Pemahaman dasar tentang Protocol Buffers diperlukan untuk menggunakan fitur ini.

Mulailah dengan mengunduh dan menginstal Protocol Buffers.

Jalankan perintah berikut untuk menghasilkan file .desc:

protoc -I=/filepath1/ --descriptor_set_out=/filepath2/proto.desc /filepath3/proto.proto

Penjelasan parameter perintah:

Parameter	Deskripsi
`-I`	Singkatan dari `--proto_path` yang menunjukkan jalur direktori yang harus dicari untuk dependensi file `import` selama kompilasi file `.proto`. Ganti `/filepath1/` dengan direktori tempat dependensi berada. Jika tidak ada dependensi, atur ke direktori lokal apa pun.
`--descriptor_set_out`	Parameter ini menentukan direktori keluaran untuk file `.desc` yang dihasilkan. Ubah `/filepath2/proto.desc` menjadi jalur keluaran yang diinginkan, termasuk nama file.
`/filepath3/proto.proto`	Tunjukkan nama dan jalur file sumber `.proto`. Untuk menghasilkan file `.desc` dari beberapa file, masukkan beberapa jalur dan nama file, dipisahkan dengan koma (,). Ubah ini menjadi jalur yang mencakup nama file sumber `proto`.

Untuk pengguna pertama kali DataService Studio, langkah awal meliputi menginisialisasi sumber data, membuat skrip, dan mengonfigurasi sumber data. Setelah selesai, Anda dapat secara efisien melakukan operasi analisis data dan manajemen data.