Rövid útmutató: Adatok exportálása IoT Central-alkalmazásból

Ebben a rövid útmutatóban konfigurálja az IoT Central-alkalmazást az Azure Data Explorer adatok exportálására. Az Azure Data Explorer lehetővé teszi a telemetriai adatok tárolását, lekérdezését és feldolgozását olyan eszközökről, mint az IoT Plug and Play okostelefon alkalmazás.

Ebben a rövid útmutatóban a következőket hajtja végre:

• Használja az IoT Central adatexportálási funkcióját az okostelefon-alkalmazásból egy Azure Data Explorer-adatbázisba irányuló telemetriai adatokhoz.
• Az Azure Data Explorer használatával lekérdezéseket futtathat a telemetrián.

Ennek a rövid útmutatónak a elvégzése kis költséggel jár az Azure Data Explorer-példányhoz tartozó Azure-fiókjában. Az IoT Central-alkalmazás első két eszköze ingyenes.

Előfeltételek

• Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
• Végezze el az első rövid útmutatót , amely egy Azure IoT Central-alkalmazást hoz létre. A második rövid útmutató, a Szabályok és műveletek konfigurálása az eszközhöz nem kötelező.
• Az Azure IoT Central-alkalmazás létrehozásának első rövid útmutatójában kiválasztott IoT Central-alkalmazás URL-előtagra van szüksége.

• Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.

  

• Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.

  • Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.

  • Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.

  • Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.

Az Azure-szolgáltatások telepítése

Mielőtt adatokat exportálhat az IoT Central-alkalmazásból, szüksége lesz egy Azure Data Explorer-fürtre és -adatbázisra. Ebben a rövid útmutatóban egy bash-szkriptet futtat az Azure Cloud Shellben a létrehozásukhoz és konfigurálásukhoz.

A szkript az alábbi lépéseket hajtja végre:

• Kéri, hogy jelentkezzen be az Azure-előfizetésbe, hogy létrehozhassa a tulajdonosi jogkivonatot a REST API-hívások hitelesítéséhez.
• Létrehoz egy Azure Data Explorer-fürtöt és -adatbázist.
• Létrehoz egy felügyelt identitást az IoT Central-alkalmazáshoz.
• Konfigurálja a felügyelt identitást az Azure Data Explorer-adatbázis elérésére vonatkozó engedéllyel.
• Hozzáad egy táblát az adatbázishoz a bejövő telemetria IoT Centralból való tárolásához.

Futtassa a következő parancsokat a szkript Azure Cloud Shell-környezetbe való letöltéséhez:

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

A szkript futtatásához használja a következő parancsot:

• Cserélje le CLUSTER_NAME az Azure Data Explorer-fürt egyedi nevére. A fürt neve csak kisbetűket és számokat tartalmazhat. A fürtnév hosszának 4 és 22 karakter közöttinek kell lennie.
• Cserélje le CENTRAL_URL_PREFIX az IoT Central-alkalmazás első rövid útmutatójában kiválasztott URL-előtagra.
• Amikor a rendszer kéri, kövesse az utasításokat a fiókba való bejelentkezéshez. A szkriptnek be kell jelentkeznie, mert létrehoz egy tulajdonosi jogkivonatot egy REST API-hívás hitelesítéséhez.

./createADX.sh CLUSTER_NAME CENTRAL_URL_PREFIX

Jegyezze fel az Azure Data Explorer URL-kimenetét a szkripttel. Ezt az értéket használni fogja a rövid útmutató későbbi részében.

Adatexportálás konfigurálása

Az adatexportálási célhely konfigurálása az IoT Centralról:

1. Lépjen az Adatexportálási lapra az IoT Central-alkalmazásban.
2. Válassza a Célhelyek lapot, majd adja meg a célhelyet.
3. Adja meg az Azure Data Explorert célnévként. Válassza az Azure Data Explorert céltípusként.
4. A fürt URL-címében adja meg a korábban jegyzett Azure Data Explorer URL-címet.
5. Az Adatbázis nevében adja meg a phonedata értéket.
6. A Táblanév mezőbe írja be a gyorsítást.
7. Az Engedélyezés területen válassza a rendszer által hozzárendelt felügyelt identitást.
8. Válassza a Mentés lehetőséget.

Az adatexportálás konfigurálása:

1. Az Adatexportálási lapon válassza az Exportálás lapot, majd az Exportálás hozzáadása lehetőséget.

2. Exportálási névként adja meg Telefon gyorsulásmérőt.

3. Válassza ki a telemetriát az exportálni kívánt adatok típusaként.

4. Az alábbi táblázatban szereplő információk segítségével két szűrőt vehet fel:

   Név	Operátor	Érték
   Eszközsablon	Egyenlő	IoT Plug and Play mobil
   Érzékelők/Gyorsulás/X	Létezik	n/a

   Győződjön meg arról, hogy az adatok exportálásának lehetősége, ha az összes feltétel teljesül, be van állítva.

5. Adja hozzá az Azure Data Explorert célként.

6. Adatátalakítás hozzáadása a célhelyhez. Adja hozzá a következő lekérdezést a 2-ben. Átalakítási lekérdezés mező létrehozása az Adatátalakítás lapon:

   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
   }
   

   

   Az átalakítás működéséhez és a lekérdezéssel való kísérletezéshez illessze be az alábbi telemetriamintát az 1-be . Adja hozzá a bemeneti üzenetet:

   {
     "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. Mentse az átalakítást. Ezután mentse az adatexportálási definíciót.

Várjon, amíg az exportálás állapota kifogástalan:

Exportált adatok lekérdezése

Az exportált telemetriai adatok lekérdezése:

1. Használja az Azure Data Explorer URL-kimenetét a korábban futtatott szkripttel az Azure Data Explorer-környezethez való navigáláshoz.

2. Bontsa ki a fürtcsomópontot, és válassza ki a phonedata-adatbázist . A lekérdezési ablak hatóköre a következőre változik Scope:yourclustername.eastus/phonedata: .

3. Az Azure Data Explorerben nyisson meg egy új lapot, és illessze be a következő Kusto-lekérdezésbe, majd válassza a Futtatás lehetőséget a gyorsulásmérő telemetriájának ábrázolásához:

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

Előfordulhat, hogy várnia kell néhány percet, hogy elegendő adatot gyűjtsön. A telemetriai értékek változásának megtekintéséhez próbálja meg a telefont különböző tájolásban tartani:

Az erőforrások eltávolítása

Ha nem tervezi további IoT Central-rövid útmutatók vagy oktatóanyagok elvégzését, törölheti az IoT Central-alkalmazást:

1. Az IoT Central-alkalmazásban lépjen az Alkalmazáskezelés elemre>.
2. Válassza a Törlés lehetőséget, majd erősítse meg a műveletet.

Ha el szeretné távolítani az Azure Data Explorer-példányt az előfizetéséből, és el szeretné kerülni a felesleges számlázást, törölje az IoTCentralExportData-rg erőforráscsoportot az Azure Portalról , vagy futtassa a következő parancsot az Azure Cloud Shellben:

az group delete --name IoTCentralExportData-rg

Következő lépés

Ebben a rövid útmutatóban megtanulta, hogyan exportálhat folyamatosan adatokat az IoT Centralból egy másik Azure-szolgáltatásba.

Most, hogy már tudja, hogy exportálja az adatokat, a javasolt következő lépés a következő: