Condividi tramite

Guida introduttiva: Esportare dati da un'applicazione IoT Central

In questa guida introduttiva si configura l'applicazione IoT Central per esportare i dati verso Azure Data Explorer. Azure Data Explorer consente di archiviare, eseguire query ed elaborare i dati di telemetria dai dispositivi, come l'applicazione per smartphone IoT Plug and Play.

Questa guida introduttiva spiega come:

  • Usare la funzionalità di esportazione dei dati in IoT Central per esportare i dati di telemetria dall'app smartphone a un database di Azure Data Explorer.
  • Usare Azure Data Explorer per eseguire query sulla telemetria.

Il completamento di questo avvio rapido comporta un piccolo costo nell'account Azure per l'istanza di Esplora dati di Azure. I primi due dispositivi nell'applicazione IoT Central sono gratuiti.

Prerequisiti

Installare i servizi di Azure

Prima di poter esportare i dati dall'applicazione IoT Central, è necessario un cluster e un database di Esplora dati di Azure. In questa guida introduttiva si esegue uno script bash in Azure Cloud Shell per crearli e configurarli.

Lo script completa i passaggi seguenti:

  • Richiede di accedere 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 Data Explorer.
  • Crea un'identità gestita per l'applicazione IoT Central.
  • Configura l'identità gestita con le autorizzazioni per accedere al database di Azure Data Explorer.
  • 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 Azure Cloud Shell:

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 nel primo avvio rapido della tua applicazione IoT Central.
  • Quando richiesto, seguire le istruzioni per accedere al proprio 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

L'esecuzione di questo script può richiedere da 20 a 30 minuti.

Prendere nota dell'output dell'URL di Esplora dati di Azure dallo script. Il valore verrà usato più avanti in questa guida introduttiva.

Configurare l'esportazione dei dati

Per configurare la destinazione di esportazione dei dati da IoT Central:

  1. Passare alla pagina Esportazione dati nell'applicazione IoT Central.
  2. Selezionare la scheda Destinazioni e quindi Aggiungere una destinazione.
  3. Immettere Esplora dati di Azure come nome di destinazione. Selezionare Esplora dati di Azure come tipo di destinazione.
  4. In URL del cluster, immettere l'URL di Azure Data Explorer annotato in precedenza.
  5. In Nome database immettere phonedata.
  6. In nome della tabella immettere accelerazione.
  7. In Autorizzazione selezionare Identità gestita assegnata dal sistema.
  8. Seleziona Salva.

Per configurare l'esportazione dei dati:

  1. Nella pagina Esportazione dati selezionare la scheda Esportazioni e quindi Aggiungere un'esportazione.

  2. Immettere accelerometro del telefono come nome di esportazione.

  3. Selezionare Telemetry (Telemetria) come tipo di dati da esportare.

  4. Usare le informazioni nella tabella seguente per aggiungere due filtri:

    Nome Operator Value
    Modello di dispositivo Uguale a Bridge Plug and Play IoT per dispositivi mobili
    Sensori/Accelerazione/X Exists N/A

    Assicurarsi che l'opzione per esportare i dati se tutte le condizioni sono vere è impostata.

  5. Aggiungere Esplora dati di Azure come destinazione.

  6. Aggiungere una trasformazione dei dati alla destinazione. Aggiungere la query seguente in 2. Campo Crea 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
}

    Screenshot che mostra la query di trasformazione dei dati per l'esportazione.

    Per informazioni sul funzionamento della trasformazione e sull'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": "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. Salvare la trasformazione. Salvare quindi la definizione di esportazione dei dati.

Attendere che lo stato dell'esportazione mostri Integro:

Screenshot che mostra un'esportazione dei dati attiva con stato integro.

Eseguire query sui dati esportati

Per eseguire query sui dati di telemetria esportati:

  1. Utilizzare l'URL di Esplora dati di Azure prodotto dallo script eseguito in precedenza per accedere all'ambiente di Esplora dati di Azure.

  2. Espandere il nodo del cluster e selezionare il database phonedata . L'ambito della finestra di query viene modificato in Scope:yourclustername.eastus/phonedata.

  3. In Esplora dati di Azure 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. Per visualizzare la modifica dei valori di telemetria, provare a tenere il telefono in diversi orientamenti:

Screenshot dei risultati della query per i dati di telemetria dell'accelerometro.

Pulire le risorse

Se non si prevede di completare altre guide introduttive o esercitazioni di IoT Central, è possibile eliminare l'applicazione IoT Central:

  1. Nell'applicazione IoT Central passare a Gestione applicazioni>.
  2. Selezionare Elimina e quindi confermare l'azione.

Per rimuovere l'istanza di Esplora dati di Azure dalla sottoscrizione ed evitare la fatturazione inutilmente, eliminare il gruppo di risorse IoTCentralExportData-rg dal portale di Azure oppure eseguire il comando seguente in Azure Cloud Shell:

az group delete --name IoTCentralExportData-rg

Passo successivo

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:

Creare e connettere un'applicazione client all'applicazione Azure IoT Central.

  • Last updated on