Avvio rapido: Esportare dati da un'applicazione IoT Central
Introduzione all'esportazione dei dati IoT Central per integrare l'applicazione IoT Central con un altro servizio cloud, ad esempio Azure Esplora dati. Azure Esplora dati consente di archiviare, eseguire query ed elaborare i dati di telemetria dai dispositivi, ad esempio l'app per smartphone Plug and Play IoT.
In questo argomento di avvio rapido:
- Usare la funzionalità di esportazione dei dati in IoT Central per i dati di telemetria dall'app smartphone a un database di Azure Esplora dati.
- Usare Azure Esplora dati per eseguire query sui dati di telemetria.
Il completamento di questa guida introduttiva comporta un costo ridotto nell'account Azure per l'istanza di Azure Esplora dati. I primi due dispositivi nell'applicazione IoT Central sono gratuiti.
Prerequisiti
- Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
- Completare la prima guida introduttiva Creare un'applicazione Azure IoT Central. La seconda guida introduttiva, Configurare regole e azioni per il dispositivo è facoltativa.
- È necessario il prefisso URL dell'applicazione IoT Central scelto nella prima guida introduttiva Creare un'applicazione Azure IoT Central.
Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido per Bash in Azure Cloud Shell.
Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.
Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere con l'interfaccia della riga di comando di Azure.
Quando viene richiesto, installare l'estensione dell'interfaccia della riga di comando di Azure per la prima volta. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.
Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.
Installare i servizi di Azure
Prima di poter esportare dati dall'applicazione IoT Central, è necessario un cluster e un database di Azure Esplora dati. In questa guida introduttiva viene eseguito uno script bash nell'Cloud Shell di Azure per crearli e configurarli.
Lo script completa i passaggi seguenti:
- Richiede l'accesso alla sottoscrizione di Azure in modo che possa generare un token di connessione per autenticare le chiamate API REST.
- Crea un cluster e un database di Azure Esplora dati.
- Crea un'identità gestita per l'applicazione IoT Central.
- Configura l'identità gestita con l'autorizzazione per accedere al database di Esplora dati di Azure.
- Aggiunge una tabella al database per archiviare i dati di telemetria in ingresso da IoT Central.
Eseguire i comandi seguenti per scaricare lo script nell'ambiente di Cloud Shell di Azure:
wget https://raw.githubusercontent.com/Azure-Samples/iot-central-docs-samples/main/quickstart-cde/createADX.sh
chmod u+x createADX.sh
Usare questo comando per eseguire lo script:
- Sostituire
CLUSTER_NAME
con un nome univoco per il cluster di Esplora dati di Azure. Il nome del cluster può contenere solo lettere minuscole e numeri. La lunghezza del nome del cluster deve essere compresa tra 4 e 22 caratteri. - Sostituire
CENTRAL_URL_PREFIX
con il prefisso URL scelto nella prima guida introduttiva per l'applicazione IoT Central. - Quando richiesto, seguire le istruzioni per accedere all'account. È necessario che lo script esegua l'accesso perché genera un token di connessione per autenticare una chiamata API REST.
./createADX.sh CLUSTER_NAME CENTRAL_URL_PREFIX
Importante
Questo script può richiedere da 20 a 30 minuti per l'esecuzione.
Prendere nota dell'output dell'URL di Azure Esplora dati dallo script. Il valore verrà usato più avanti in questa guida introduttiva.
Configurare l'esportazione dati
Per configurare la destinazione di esportazione dei dati da IoT Central:
- Passare alla pagina Esportazione dati nell'applicazione IoT Central.
- Selezionare la scheda Destinazioni e quindi Aggiungere una destinazione.
- Immettere Azure Esplora dati come nome di destinazione. Selezionare Azure Esplora dati come tipo di destinazione.
- In URL del cluster immettere l'URL di Azure Esplora dati annotato in precedenza.
- In Nome database immettere phonedata.
- In Nome tabella immettere accelerazione.
- In Autorizzazione selezionare Identità gestita assegnata dal sistema.
- Selezionare Salva.
Per configurare l'esportazione dei dati:
Nella pagina Esportazione dati selezionare la scheda Esportazioni e quindi Aggiungere un'esportazione.
Immettere accelerometro telefono come nome di esportazione.
Selezionare Telemetria come tipo di dati da esportare.
Usare le informazioni nella tabella seguente per aggiungere due filtri:
Nome Operatore Valore Modello di dispositivo Uguale a Plug and Play IoT mobile Sensori/Accelerazione/X Exists N/D Assicurarsi che l'opzione per esportare i dati se tutte le condizioni sono impostate.
Aggiungere Esplora dati di Azure come destinazione.
Aggiungere una trasformazione dati alla destinazione. Aggiungere la query seguente nella 2. Compilare il campo query di trasformazione nella pagina Trasformazione dati:
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 }
Per verificare il funzionamento della trasformazione e l'esperimento con la query, incollare il messaggio di telemetria di esempio seguente in 1. Aggiungere il messaggio di input:
{ "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": {} }
Salvare la trasformazione. Salvare quindi la definizione di esportazione dei dati.
Attendere fino a quando lo stato di esportazione mostra Integro:
Eseguire query sui dati esportati
Per eseguire query sui dati di telemetria esportati:
Usare l'output dell'URL di Azure Esplora dati dallo script eseguito in precedenza per passare all'ambiente di Esplora dati di Azure.
Espandere il nodo del cluster e selezionare il database phonedata . L'ambito della finestra di query viene modificato in
Scope:yourclustername.eastus/phonedata
.In Azure Esplora dati aprire una nuova scheda e incollare la query Kusto seguente e quindi selezionare Esegui per tracciare i dati di telemetria dell'accelerometro:
['acceleration']
| project EnqueuedTime, Device, X, Y, Z
| render timechart
Potrebbe essere necessario attendere alcuni minuti per raccogliere dati sufficienti. Provare a tenere il telefono in diversi orientamenti per visualizzare i valori di telemetria cambiano:
Pulire le risorse
Se non si prevede di completare ulteriori guide introduttive o esercitazioni di IoT Central, è possibile eliminare l'applicazione IoT Central:
- Nell'applicazione IoT Central passare a Gestione applicazioni>.
- Selezionare Elimina e quindi confermare l'azione.
Per rimuovere l'istanza di Azure Esplora dati dalla sottoscrizione ed evitare di essere fatturata inutilmente, eliminare il gruppo di risorse IoTCentralExportData-rg dal portale di Azure o eseguire il comando seguente nel Cloud Shell di Azure:
az group delete --name IoTCentralExportData-rg
Passaggi successivi
In questa guida introduttiva si è appreso come esportare continuamente i dati da IoT Central a un altro servizio di Azure.
Ora che si è certi di esportare i dati, il passaggio successivo consigliato consiste nel: