Sdílet prostřednictvím


Rychlý start: Export dat z aplikace IoT Central

V tomto rychlém startu nakonfigurujete aplikaci IoT Central tak, aby exportuje data v Azure Data Exploreru. Azure Data Explorer umožňuje ukládat, dotazovat a zpracovávat telemetrická data ze zařízení, jako je aplikace smartphonu IoT Plug and Play .

V tomto rychlém průvodci vám:

  • Pomocí funkce exportu dat v IoT Central k exportu telemetrie z aplikace pro chytré telefony do databáze Azure Data Explorer.
  • Pomocí Azure Data Exploreru můžete spouštět dotazy na telemetrii.

Dokončením tohoto rychlého spuštění vznikají na vašem účtu Azure malé náklady za instanci Azure Data Exploreru. První dvě zařízení ve vaší aplikaci IoT Central jsou zdarma.

Požadavky

Instalace služeb Azure

Než budete moct exportovat data z aplikace IoT Central, potřebujete cluster a databázi Azure Data Exploreru. V tomto rychlém startu spustíte skript Bash v Azure Cloud Shellu , abyste je vytvořili a nakonfigurovali.

Skript provede následující kroky:

  • Vyzve vás k přihlášení k předplatnému Azure, aby mohl vygenerovat nosný token pro ověření volání rozhraní REST API.
  • Vytvoří cluster a databázi Azure Data Exploreru.
  • Vytvoří spravovanou identitu pro vaši aplikaci IoT Central.
  • Nakonfiguruje spravovanou identitu s oprávněním pro přístup k databázi Azure Data Exploreru.
  • Přidá do databáze tabulku pro ukládání příchozí telemetrie z IoT Central.

Spuštěním následujících příkazů stáhněte skript do prostředí Azure Cloud Shellu:

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

Ke spuštění skriptu použijte následující příkaz:

  • Nahraďte CLUSTER_NAME jedinečným názvem clusteru Azure Data Exploreru. Název clusteru může obsahovat jenom malá písmena a číslice. Délka názvu clusteru musí být 4 až 22 znaků.
  • Nahraďte CENTRAL_URL_PREFIX předponou adresy URL, kterou jste zvolili v prvním rychlém startu pro vaši aplikaci IoT Central.
  • Po zobrazení výzvy se přihlaste ke svému účtu podle pokynů. Skript se musí přihlásit, protože vygeneruje nosný token pro ověření volání rozhraní REST API.
./createADX.sh CLUSTER_NAME CENTRAL_URL_PREFIX

Důležité

Spuštění tohoto skriptu může trvat 20 až 30 minut.

Poznamenejte si výstup adresy URL Azure Data Exploreru pomocí skriptu. Tuto hodnotu použijete později v rychlém startu.

Konfigurace exportu dat

Konfigurace cíle exportu dat ze služby IoT Central:

  1. V aplikaci IoT Central přejděte na stránku exportu dat .
  2. Vyberte kartu Cíle a pak přidejte cíl.
  3. Jako název cíle zadejte Azure Data Explorer . Jako cílový typ vyberte Azure Data Explorer .
  4. Do adresy URL clusteru zadejte adresu URL Azure Data Exploreru , kterou jste si předtím poznamenali.
  5. Do pole Název databáze zadejte telefonní data.
  6. Do pole Název tabulky zadejte akceleraci.
  7. V autorizaci vyberte spravovanou identitu přiřazenou systémem.
  8. Vyberte Uložit.

Chcete-li nakonfigurovat export dat:

  1. Na stránce Export dat vyberte kartu Export a pak přidejte export.

  2. Jako název exportu zadejte akcelerometr pro telefon .

  3. Jako typ dat, která chcete exportovat, vyberte telemetrii .

  4. Pomocí informací v následující tabulce přidejte dva filtry:

    Název Operator Hodnota
    Šablona zařízení Rovná se Mobilní zařízení IoT Plug and Play
    Senzory/zrychlení/X Exists N/A

    Ujistěte se, že je nastavená možnost exportu dat, pokud jsou splněny všechny podmínky.

  5. Přidejte Azure Data Explorer jako cíl.

  6. Přidejte datovou transformaci na cílové místo. V poli 2. Vytvoření transformačního dotazu na stránce Transformace dat přidejte následující dotaz:

    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
    }
    

    Snímek obrazovky znázorňující dotaz transformace dat pro export

    Pokud chcete zjistit, jak transformace funguje a experimentuje s dotazem, vložte následující ukázkovou zprávu telemetrie do 1. Přidejte svoji vstupní zprávu:

    {
      "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. Uložte transformaci. Pak uložte definici exportu dat.

Počkejte, až se stav exportu zobrazí jako v pořádku:

Snímek obrazovky znázorňující spuštěný export dat se stavem v pořádku

Dotazování na exportovaná data

Dotazování na exportovanou telemetrii:

  1. Pomocí výstupu adresy URL Azure Data Exploreru pomocí skriptu, který jste spustili dříve, přejděte do prostředí Azure Data Exploreru.

  2. Rozbalte uzel clusteru a vyberte databázi phonedata . Rozsah okna dotazu se změní na Scope:yourclustername.eastus/phonedata.

  3. V Azure Data Exploreru otevřete novou kartu a vložte následující dotaz Kusto, pak výběrem Spustit vykreslete telemetrii akcelerometru.

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

Možná budete muset několik minut počkat, než shromáždíte dostatek dat. Pokud chcete zobrazit změnu hodnot telemetrie, zkuste telefon držet v různých orientacích:

Snímek obrazovky s výsledky dotazu pro telemetrii akcelerometru

Vyčistěte zdroje

Pokud nemáte v úmyslu dokončit žádné další rychlé starty nebo kurzy IoT Central, můžete aplikaci IoT Central odstranit:

  1. V aplikaci IoT Central přejděte do správy aplikací>.
  2. Vyberte Odstranit a potvrďte akci.

Pokud chcete odebrat instanci Azure Data Exploreru z vašeho předplatného a zbytečně se vyhnout účtování, odstraňte skupinu prostředků IoTCentralExportData-rg z webu Azure Portal nebo spusťte v Azure Cloud Shellu následující příkaz:

az group delete --name IoTCentralExportData-rg

Další krok

V tomto rychlém startu jste zjistili, jak průběžně exportovat data z IoT Central do jiné služby Azure.

Teď, když už víte, že chcete exportovat data, je navrhovaný další krok: