Mulai cepat: Mengekspor data dari aplikasi IoT Central

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

Dalam panduan singkat 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 pada telemetri.

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

Prasyarat

• Sebuah akun Azure dengan langganan aktif. Buat akun secara gratis.
• Selesaikan panduan memulai cepat pertama, Panduan Memulai Cepat - Gunakan ponsel cerdas Anda sebagai perangkat untuk mengirim telemetri ke aplikasi IoT Central. Mulai cepat kedua, Mulai Cepat: Mengonfigurasi aturan dan tindakan untuk perangkat Anda di Azure IoT Central, bersifat opsional.
• Anda memerlukan awalan URL aplikasi IoT Central yang Anda pilih pada quickstart pertama, Panduan Cepat - Menggunakan ponsel cerdas Anda sebagai perangkat untuk mengirim telemetri ke aplikasi IoT Central.

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai menggunakan 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 az login. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Mengautentikasi ke Azure menggunakan Azure CLI.

  • Saat diminta, instal ekstensi Azure CLI saat pertama kali digunakan. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan dan mengelola ekstensi dengan Azure CLI.

  • Jalankan az version untuk menemukan versi dan pustaka dependen yang terinstal. Untuk meng-upgrade ke versi terbaru, jalankan az upgrade.

Menginstal layanan Azure

Sebelum dapat mengekspor data dari aplikasi IoT Central, Anda memerlukan kluster dan database Azure Data Explorer. Dalam quickstart 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 dari skrip. Anda akan menggunakan nilai ini di panduan cepat nanti.

Mengonfigurasi ekspor data

Untuk mengonfigurasi tujuan ekspor data dari IoT Central:

1. Navigasi 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 akselerasi.
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
   Sensor/Akselerasi/X	Exists	N/A

   Pastikan bahwa opsi untuk mengekspor data diaktifkan jika semua kondisi benar.

5. Tambahkan Azure Data Explorer sebagai tujuan.

6. Tambahkan transformasi data ke tujuan. Tambahkan kueri berikut di 2. Bangun 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": "00001111-aaaa-2222-bbbb-3333cccc4444",
     "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 hingga 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 tempelkan 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 menyelesaikan panduan memulai cepat atau tutorial IoT Central lebih lanjut, Anda dapat menghapus aplikasi Microsoft 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 ditagih secara tidak perlu, hapus grup sumber daya IoTCentralExportData-rg dari portal Microsoft Azure atau jalankan perintah berikut di Azure Cloud Shell:

az group delete --name IoTCentralExportData-rg

Langkah selanjutnya

Dalam pengantar cepat ini, Anda mempelajari cara mengekspor data secara konstan dari IoT Central ke layanan Azure lainnya.

Sekarang setelah Anda tahu sekarang untuk mengekspor data Anda, langkah selanjutnya yang disarankan adalah:

Buat dan sambungkan aplikasi klien ke aplikasi Azure IoT Central Anda.