Mulai Cepat: Mengekspor data dari aplikasi IoT Central

Dalam mulai cepat ini, Anda mengonfigurasi aplikasi IoT Central untuk mengekspor data Azure Data Explorer. Azure Data Explorer memungkinkan Anda menyimpan, mengkueri, dan memproses telemetri dari perangkat seperti aplikasi smartphone IoT Plug and Play.

Dalam mulai cepat ini, Anda akan:

• Gunakan fitur ekspor data di IoT Central ke telemetri dari aplikasi smartphone ke database Azure Data Explorer.
• Gunakan Azure Data Explorer untuk menjalankan kueri di telemetri.

Menyelesaikan mulai cepat ini dikenakan biaya kecil di akun Azure Anda untuk instans Azure Data Explorer. Dua perangkat pertama di aplikasi IoT Central Anda gratis.

Prasyarat

• Akun Azure dengan langganan aktif. Buat akun secara gratis.
• Selesaikan mulai cepat pertama Buat aplikasi Azure IoT Central. Mulai cepat kedua, Mengonfigurasi aturan dan tindakan untuk perangkat Anda, bersifat opsional.
• Anda memerlukan awalan URL aplikasi IoT Central yang Anda pilih di mulai cepat pertama Membuat aplikasi Azure IoT Central.

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.

  

• Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.

  • Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.

  • Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.

  • Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.

Menginstal layanan Azure

Sebelum dapat mengekspor data dari aplikasi IoT Central, Anda memerlukan kluster dan database Azure Data Explorer. Dalam mulai cepat ini, Anda menjalankan skrip bash di Azure Cloud Shell untuk membuat dan mengonfigurasinya.

Skrip menyelesaikan langkah-langkah berikut:

• Meminta Anda untuk masuk ke langganan Azure Anda sehingga dapat menghasilkan token pembawa untuk mengautentikasi panggilan REST API.
• Membuat kluster dan database Azure Data Explorer.
• Membuat identitas terkelola untuk aplikasi IoT Central Anda.
• Mengonfigurasi identitas terkelola dengan izin untuk mengakses database Azure Data Explorer.
• Menambahkan tabel ke database untuk menyimpan telemetri masuk dari IoT Central.

Jalankan perintah berikut untuk mengunduh skrip ke lingkungan Azure Cloud Shell Anda:

wget https://raw.githubusercontent.com/Azure-Samples/iot-central-docs-samples/main/quickstart-cde/createADX.sh
chmod u+x createADX.sh

Gunakan perintah berikut untuk menjalankan skrip:

• Ganti CLUSTER_NAME dengan nama unik untuk kluster Azure Data Explorer Anda. Nama kluster hanya dapat berisi huruf kecil dan angka. Panjang nama kluster harus antara 4 dan 22 karakter.
• Ganti CENTRAL_URL_PREFIX dengan awalan URL yang Anda pilih di mulai cepat pertama untuk aplikasi IoT Central Anda.
• Saat diminta, ikuti instruksi untuk masuk ke akun Anda. Skrip perlu masuk karena menghasilkan token pembawa untuk mengautentikasi panggilan REST API.

./createADX.sh CLUSTER_NAME CENTRAL_URL_PREFIX

Penting

Skrip ini dapat memakan waktu 20 hingga 30 menit untuk dijalankan.

Catat output URL Azure Data Explorer oleh skrip. Anda menggunakan nilai ini nanti di mulai cepat.

Mengonfigurasi ekspor data

Untuk mengonfigurasi tujuan ekspor data dari IoT Central:

1. Arahkan ke halaman Ekspor data di aplikasi IoT Central Anda.
2. Pilih tab Tujuan lalu Tambahkan tujuan.
3. Masukkan Azure Data Explorer sebagai nama tujuan. Pilih Azure Data Explorer sebagai jenis tujuan.
4. Di URL Kluster, masukkan URL Azure Data Explorer yang Anda catat sebelumnya.
5. Di Nama database, masukkan phonedata.
6. Di Nama tabel, masukkan acceleration.
7. Di Otorisasi, pilih Identitas terkelola yang ditetapkan sistem.
8. Pilih Simpan.

Untuk mengonfigurasi ekspor data:

1. Pada halaman Ekspor data, pilih tab Ekspor, lalu Tambahkan ekspor.

2. Masukkan Akselerometer telepon sebagai nama ekspor.

3. Pilih Telemetri sebagai jenis data yang akan diekspor.

4. Gunakan informasi dalam tabel berikut untuk menambahkan dua filter:

   Nama	Operator	Nilai
   Templat perangkat	Sama dengan	IoT Plug and Play mobile
   Sensors/Acceleration/X	Ada	T/A

   Pastikan opsi untuk mengekspor data jika semua kondisi benar telah ditetapkan.

5. Tambahkan Azure Data Explorer sebagai tujuan.

6. Tambahkan transformasi data ke tujuan. Tambahkan kueri berikut di bidang 2. Membangun kueri transformasi pada Halaman transformasi data:

   import "iotc" as iotc;
   {
       Device: .device.id,
       EnqueuedTime: .enqueuedTime,
       X: .telemetry | iotc::find(.name == "accelerometer").value.x,
       Y: .telemetry | iotc::find(.name == "accelerometer").value.y,
       Z: .telemetry | iotc::find(.name == "accelerometer").value.z
   }
   

   

   Untuk melihat cara kerja transformasi dan bereksperimen dengan kueri, tempelkan contoh pesan telemetri berikut ke dalam 1. Tambahkan pesan input Anda:

   {
     "messageProperties": {},
     "device": {
       "id": "8hltz8xa7n",
       "properties": {
         "reported": []
       },
       "approved": true,
       "types": [],
       "name": "8hltz8xa7n",
       "simulated": false,
       "provisioned": true,
       "modules": [],
       "templateId": "urn:modelDefinition:vlcd3zvzdm:y425jkkpqzeu",
       "templateName": "IoT Plug and Play mobile",
       "organizations": [],
       "cloudProperties": [],
       "blocked": false
     },
     "component": "sensors",
     "applicationId": "40a97c91-50cc-44f0-9f63-71386613facc",
     "messageSource": "telemetry",
     "telemetry": [
       {
         "id": "dtmi:azureiot:PhoneSensors:__accelerometer;1",
         "name": "accelerometer",
         "value": {
           "x": 0.09960123896598816,
           "y": 0.09541380405426025,
           "z": 9.907781600952148
         }
       }
     ],
     "enqueuedTime": "2021-11-12T10:01:30.588Z",
     "enrichments": {}
   }
   

7. Simpan transformasi. Kemudian simpan definisi ekspor data.

Tunggu sampai status ekspor menunjukkan Sehat:

Kueri data yang diekspor

Untuk mengkueri telemetri yang diekspor:

1. Gunakan output URL Azure Data Explorer dengan skrip yang Anda jalankan sebelumnya untuk menavigasi ke lingkungan Azure Data Explorer Anda.

2. Perluas node kluster dan pilih database phonedata. Cakupan jendela kueri berubah menjadi Scope:yourclustername.eastus/phonedata.

3. Di Azure Data Explorer, buka tab baru dan tempel di kueri Kusto berikut lalu pilih Jalankan untuk memplot telemetri akselerometer:

['acceleration'] 
    | project EnqueuedTime, Device, X, Y, Z
    | render timechart 

Anda mungkin perlu menunggu beberapa menit untuk mengumpulkan data yang cukup. Untuk melihat perubahan nilai telemetri, coba tahan ponsel Anda dalam orientasi yang berbeda:

Membersihkan sumber daya

Jika Anda tidak berencana untuk menyelesaikan mulai cepat atau tutorial IoT Central lebih lanjut, Anda dapat menghapus aplikasi IoT Central Anda:

1. Di aplikasi IoT Central Anda, navigasikan ke Manajemen Aplikasi>.
2. Pilih Hapus lalu konfirmasi tindakan Anda.

Untuk menghapus instans Azure Data Explorer dari langganan Anda dan menghindari tagihan yang tidak perlu, hapus grup sumber daya IoTCentralExportData-rg dari portal Azure atau jalankan perintah berikut di Azure Cloud Shell:

az group delete --name IoTCentralExportData-rg

Langkah selanjutnya

Dalam mulai cepat ini, Anda mempelajari cara mengekspor data dari IoT Central ke layanan Azure lainnya secara terus-menerus.

Sekarang setelah Anda mengetahui cara mengekspor data, langkah selanjutnya yang disarankan adalah:

Membuat dan menyambungkan perangkat.