Snabbstart: Exportera data från ett IoT Central-program

I den här snabbstarten konfigurerar du ditt IoT Central-program för att exportera data i Azure Data Explorer. Med Azure Data Explorer kan du lagra, fråga och bearbeta telemetrin från enheter som IoT Plug och Play smartphone-appen.

I den här snabbstarten kommer du att göra följande:

Använd funktionen för dataexport i IoT Central till telemetrin från smartphone-appen till en Azure Data Explorer-databas.
Använd Azure Data Explorer för att köra frågor på telemetrin.

Att slutföra den här snabbstarten medför en liten kostnad i ditt Azure-konto för Azure Data Explorer-instansen. De två första enheterna i IoT Central-programmet är kostnadsfria.

Förutsättningar

Ett Azure-konto med en aktiv prenumeration. Skapa ett konto kostnadsfritt.
Slutför den första snabbstarten, Snabbstart – Använd din smartphone som en enhet för att skicka telemetri till ett IoT Central-program. Den andra snabbstarten, Snabbstart: Konfigurera regler och åtgärder för din enhet i Azure IoT Central är valfri.
Du behöver URL-prefixet för IoT Central-applikationen URL prefix som du valde i den första Quickstart-guiden – Använd din smartphone som en enhet för att skicka telemetri till en IoT Central-applikation.

Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Kom igång med Azure Cloud Shell.
Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör på Windows eller macOS, överväg att köra Azure CLI i en Docker-container. För mer information, se Hur man kör Azure CLI i en Docker-container.
- Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. För att avsluta autentiseringsprocessen, följ stegen som visas i din terminal. Andra inloggningsalternativ finns i Autentisera till Azure med Azure CLI.
- När du blir uppmanad, installera Azure CLI-tillägget vid första användning. Mer information om tillägg finns i Använda och hantera tillägg med Azure CLI.
- Kör az version för att ta reda på versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Installera Azure-tjänster

Innan du kan exportera data från ditt IoT Central-program behöver du ett Azure Data Explorer-kluster och en databas. I den här snabbstarten kör du ett bash-skript i Azure Cloud Shell för att skapa och konfigurera dem.

Skriptet slutför följande steg:

Uppmanar dig att logga in på din Azure-prenumeration så att den kan generera en ägartoken för att autentisera REST API-anropen.
Skapar ett Azure Data Explorer-kluster och en databas.
Skapar en hanterad identitet för ditt IoT Central-program.
Konfigurerar den hanterade identiteten med behörighet att komma åt Azure Data Explorer-databasen.
Lägger till en tabell i databasen för att lagra inkommande telemetri från IoT Central.

Kör följande kommandon för att ladda ned skriptet till din Azure Cloud Shell-miljö:

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

Använd följande kommando för att köra skriptet:

Ersätt CLUSTER_NAME med ett unikt namn för ditt Azure Data Explorer-kluster. Klusternamnet får bara innehålla små bokstäver och siffror. Klusternamnets längd måste vara mellan 4 och 22 tecken.
Ersätt CENTRAL_URL_PREFIX med URL-prefixet som du valde i den första snabbstarten för ditt IoT Central-program.
När du uppmanas att göra det följer du anvisningarna för att logga in på ditt konto. Skriptet måste logga in eftersom det genererar en ägartoken för att autentisera ett REST API-anrop.

./createADX.sh CLUSTER_NAME CENTRAL_URL_PREFIX

Viktigt!

Det här skriptet kan ta 20 till 30 minuter att köra.

Anteckna azure datautforskarens URL-utdata via skriptet. Du använder det här värdet senare i snabbstarten.

Konfigurera dataexport

Så här konfigurerar du dataexportmålet från IoT Central:

Gå till sidan Dataexport i ditt IoT Central-program.
Välj fliken Mål och sedan Lägg till ett mål.
Ange Azure Data Explorer som målnamn. Välj Azure Data Explorer som måltyp.
I Kluster-URL anger du url:en för Azure Data Explorer som du antecknade tidigare.
I Databasnamn anger du phonedata.
I Tabellnamn anger du acceleration.
I Auktorisering väljer du Systemtilldelad hanterad identitet.
Välj Spara.

Så här konfigurerar du dataexporten:

På sidan Dataexport väljer du fliken Exporter och sedan Lägg till en export.
Ange Phone accelerometer som exportnamn.
Välj Telemetri som den typ av data som ska exporteras.
Använd informationen i följande tabell för att lägga till två filter:

Namn Operator Värde

Enhetsmall Motsvarar IoT Plug and Play-mobil

Sensorer/Acceleration/X Exists N/A

Kontrollera att alternativet för att exportera data om alla villkor är sanna har angetts.
Lägg till Azure Data Explorer som mål.

Namn	Operator	Värde
Enhetsmall	Motsvarar	IoT Plug and Play-mobil
Sensorer/Acceleration/X	Exists	N/A

Lägg till en dataomvandling till målet. Lägg till följande fråga i 2. Skapa frågefält för transformering på sidan Datatransformering:

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
}

Om du vill se hur omvandlingen fungerar och experimentera med frågan klistrar du in följande exempeltelemetrimeddelande i 1. Lägg till indatameddelandet:

{
  "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": {}
}

Spara omvandlingen. Spara sedan definitionen av dataexport.

Vänta tills exportstatusen visar Felfri:

Fråga exporterade data

Så här frågar du den exporterade telemetrin:

Använd URL:en som skriptet du körde tidigare genererade för att navigera till din Azure Data Explorer-miljö.
Expandera klusternoden och välj databasen phonedata . Frågefönstrets omfång ändras till Scope:yourclustername.eastus/phonedata.
I Azure Data Explorer öppnar du en ny flik och klistrar in följande Kusto-fråga och väljer sedan Kör för att rita accelerometertelemetrin:

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

Du kan behöva vänta i flera minuter för att samla in tillräckligt med data. Om du vill se hur telemetrivärdena ändras kan du prova att hålla telefonen i olika orienteringar:

Rensa resurser

Om du inte planerar att slutföra ytterligare snabbstarter eller självstudier för IoT Central kan du ta bort ditt IoT Central-program:

I ditt IoT Central-program går du till Programhantering>.
Välj Ta bort och bekräfta sedan åtgärden.

Om du vill ta bort Azure Data Explorer-instansen från din prenumeration och undvika att debiteras i onödan tar du bort resursgruppen IoTCentralExportData-rg från Azure-portalen eller kör följande kommando i Azure Cloud Shell:

az group delete --name IoTCentralExportData-rg

Nästa steg

I den här snabbstarten lärde du dig att kontinuerligt exportera data från IoT Central till en annan Azure-tjänst.

Nu när du vet att du ska exportera dina data är nästa steg att:

Skapa och ansluta ett klientprogram till ditt Azure IoT Central-program.

Feedback

Var den här sidan till hjälp?

Last updated on 2025-09-29