Rövid útmutató – Bevezetés egy mintaforgatókönyv használatába az Azure Digital Twins Explorerben
Ez a rövid útmutató az Azure Digital Twins bemutatása, amely bemutatja, hogy az Azure Digital Twins hogyan képviseli az adatokat, és bemutatja, milyen egy fizikai épület digitális ikergráfjával együttműködni. Az Azure Portal webhelyét és az Azure Digital Twins Explorert fogja használni, amely egy eszköz az Azure Digital Twins-adatok webböngészőben való megjelenítésére és kezelésére.
Ebben a rövid útmutatóban olyan előre elkészített mintamodelleket tekinthet meg, amelyek digitálisan definiálják az épület, a padló és a szoba fogalmait, és ezekkel a modelldefiníciókkal digitális ikerpéldányokat hozhat létre, amelyek egy fizikai épület adott emeleteit és helyiségeit jelölik. Ezek az egyes ikerpéldányok egy olyan virtuális ikerdiagramhoz lesznek csatlakoztatva, amely tükrözi az egymáshoz való viszonyukat, és a mintaépület teljes digitális ábrázolását alkotja. A gráf, amellyel dolgozni fog, egy két emeletet tartalmazó épületet jelöl, az egyes emeletek pedig szobákat. A gráf így fog kinézni:
A gráf megismeréséhez a következő lépéseket kell elvégeznie:
- Hozzon létre egy Azure Digital Twins-példányt, és nyissa meg az Azure Digital Twins Explorerben.
- A mintaforgatókönyv létrehozásához töltsön fel előre elkészített modelleket és gráfadatokat. Adjon hozzá még egy ikerpéldányt manuálisan.
- Az IoT-adatok módosításának szimulálása és a gráf lekérdezése az eredmények megtekintéséhez.
- Tekintse át a tapasztalatait.
Feljegyzés
Az egyszerűség kedvéért ez a rövid útmutató nem foglalja magában az élő adatfolyam beállítását a modellezett környezetben lévő IoT-eszközökről vagy más adatforrásokból. Az ikergráfot meghajtó szimulált, végpontok közötti adatfolyam beállításához lépjen tovább az oktatóanyagokra: Csatlakozás egy végpontok közötti megoldást. A szolgáltatások közötti adatfolyamról és az Azure Digital Twins szélesebb IoT-megoldásba való integrálásáról további információt az Adatforgalom és a kimenő forgalom című témakörben talál.
Előfeltételek
A rövid útmutató elvégzéséhez Azure-előfizetésre lesz szüksége. Ha még nincs ilyen, hozzon létre egyet ingyen .
A gyorsútmutatóban használt mintagráf anyagait is le kell töltenie. Az alábbi utasításokat követve töltse le a szükséges fájlokat. Később további utasításokat követve töltheti fel őket az Azure Digital Twinsbe.
Modellfájlok. Navigáljon az alábbi hivatkozásokra, kattintson a jobb gombbal a képernyő tetszőleges pontjára, és válassza a Mentés másként lehetőséget a böngésző jobb gombbal elérhető menüjében. A Mentés másként ablakban mentse a fájlt valahol a gépén.
- Building.json: Ez egy olyan modellfájl, amely digitálisan definiál egy épületet. Meghatározza, hogy az épületek tartalmazhatnak padlót.
- Floor.json: Ez egy olyan modellfájl, amely digitálisan definiál egy padlót. Meghatározza, hogy a padló tartalmazhat-e helyiségeket.
- Room.json: Ez egy olyan modellfájl, amely digitálisan definiál egy helyiséget. Hőmérsékleti tulajdonsága van.
buildingScenario.xlsx: Ez a táblázat egy minta ikergráf adatait tartalmazza, köztük öt digitális ikerpéldányt, amelyek egy adott épületet jelölnek emeletekkel és szobákkal. Az ikerpéldányok az általános modelleken alapulnak, és olyan kapcsolatokhoz kapcsolódnak, amelyek jelzik, hogy mely elemek tartalmazzák egymást. A böngésző beállításaitól függően a hivatkozás kiválasztásával automatikusan letöltheti a buildingScenario.xlsx fájlt az alapértelmezett letöltési helyre, vagy megnyithatja a fájlt a böngészőben a letöltési lehetőséggel. Így néz ki ez a letöltési lehetőség a Microsoft Edge-ben:
Tipp.
Ezek a fájlok a GitHub Azure Digital Twins Explorer-adattárából származnak. A tárházban további mintafájlokat, explorer-kódot és egyebeket is kereshet.
Az Azure Digital Twins beállítása
Az Azure Digital Twins használatának első lépése egy Azure Digital Twins-példány létrehozása, amely az összes gráfadatot tárolja. Ebben a szakaszban létrehozza a szolgáltatás egy példányát, és megnyitja az Azure Digital Twins Explorerben.
Azure Digital Twins-példány létrehozása
Ebben a szakaszban az Azure Digital Twins új példányát fogja létrehozni az Azure Portal használatával. Lépjen a portálra, és jelentkezzen be a hitelesítő adataival.
A portálon először válassza az Erőforrás létrehozása lehetőséget az Azure-szolgáltatások kezdőlapjának menüjében.
Keresse meg az Azure Digital Twins szolgáltatást a keresőmezőben, és válassza ki az Azure Digital Twins szolgáltatást az eredmények közül.
Hagyja az Azure Digital Twins csomag mezőjét, és a Létrehozás gombra kattintva kezdje el létrehozni a szolgáltatás új példányát.
Töltse ki a beállítás Alapjai lapján található mezőket, beleértve az előfizetést, az erőforráscsoportot, az új példány erőforrásnevét és a régiót. Jelölje be az Azure Digital Twins adattulajdonosi szerepkör hozzárendelése jelölőnégyzetet, és adjon magának engedélyeket a példány adatainak kezeléséhez.
Feljegyzés
Ha az Azure Digital Twins-adattulajdonosi szerepkör hozzárendelése mező szürkére van szürkítve, az azt jelenti, hogy nincs engedélye az Azure-előfizetésben az erőforrásokhoz való felhasználói hozzáférés kezelésére. Ebben a szakaszban továbbra is létrehozhatja a példányt, és a rövid útmutató folytatása előtt rendelkeznie kell a szükséges engedélyekkel.
A követelménynek megfelelő gyakori szerepkörök a tulajdonos, a fiókadminisztrátor vagy a felhasználói hozzáférés Rendszergazda istrator és a közreműködő kombinációja.
Válassza a Véleményezés + Létrehozás lehetőséget a példány létrehozásának befejezéséhez.
Megjelenik egy összefoglaló oldal, amelyen a megadott adatok láthatók. Erősítse meg és hozza létre a példányt a Létrehozás gombra kattintva.
Ekkor megjelenik egy áttekintési oldal, amely nyomon követi a példány üzembehelyezési állapotát.
Várja meg, amíg a lap azt mondja, hogy az üzembe helyezés befejeződött.
Példány megnyitása az Azure Digital Twins Explorerben
Az üzembe helyezés befejezése után az Erőforrás megnyitása gombbal lépjen a példány Áttekintés lapjára a portálon.
Ezután válassza az Open Azure Digital Twins Explorer (előzetes verzió) gombot.
Ezzel megnyitja az Azure Digital Twins Explorert egy új lapon. Ha most először használja az Explorert, megjelenik egy üdvözlő modális, amely összefoglalja a főbb funkcióit.
Előfordulhat, hogy az Azure Digital Twins Explorer automatikusan csatlakozik a példányhoz. Ha nem, akkor az alábbi képernyő kéri, hogy adjon meg egy Azure Digital Twins URL-címet. (Ha nem látja ezt a mezőt a képernyőn, az Azure Digital Twins Explorer már elvégezte ezt a lépést automatikusan.)
Ha ezt a mezőt látja, írja be a https:// a mezőbe, majd a példány állomásnevét (ez a példány áttekintési oldalán található meg a portálon). Ezek az értékek együttesen alkotják a példány URL-címét. Válassza a Mentés lehetőséget a példányhoz való csatlakozáshoz.
Fontos
Az Azure Digital Twins Explorer nem támogatja a privát végpontokat. Ha az Azure Digital Twins Explorert olyan Azure Digital Twins-példánnyal szeretné használni, amely privát kapcsolattal tiltja le a nyilvános hozzáférést, az Azure Digital Twins Explorer kódbázist privátan is üzembe helyezheti a felhőben. Ennek módjáról az Azure Digital Twins Explorer: Fut a felhőben című témakörben talál útmutatást.
A mintaforgatókönyv felépítése
Ezután az Azure Digital Twins Explorerrel fogja beállítani a mintamodelleket és az ikergráfot. Először importálja a modellfájlokat és a gépére letöltött ikergráffájlt az Előfeltételek szakaszban. Ezután a forgatókönyvet úgy fogja befejezni, hogy még egy ikerpéldányt manuálisan hoz létre.
Modellek
Az Azure Digital Twins-gráfok létrehozásának első lépése a környezet szókincsének meghatározása. A modellek általános definíciók a környezetben található entitástípusokhoz. Ez a mintaépítési forgatókönyv egy épületet, emeletet és helyiséget tartalmaz, ezért szüksége lesz egy modelldefinícióra, amely leírja az épület fogalmát, egy modelldefiníciót, amely leírja, hogy mi az a emelet, és egy modelldefinícióra, amely leírja, hogy mi az a helyiség. Később létrehozhat olyan digitális ikerpéldányokat , amelyek ezeknek a modelleknek a példányai, amelyek konkrét épületeket, emeleteket és szobákat jelölnek.
Az Azure Digital Twins modelljei a JSON-LD-hez hasonló adatobjektum-nyelv, a Digital Twin Definition Language (DTDL) nyelven vannak megírva. Minden modell egyetlen típusú entitást ír le a tulajdonságai, kapcsolatai és összetevői szempontjából.
Ebben a rövid útmutatóban a modellfájlokat már megírtuk Önnek. Letöltötte Building.json, Floor.json és Room.json az Előfeltételek szakaszban, és most feltölti őket az Azure Digital Twins-példányba az Azure Digital Twins Explorer használatával.
Modellek feltöltése (.json fájlok)
Az Azure Digital Twins Explorerben ezeket a lépéseket követve töltse fel az épület-, emelet- és helyiségmodelleket (a korábban letöltött .json fájlokat).
A Modellek panelen válassza a Modell feltöltése ikont, amelyen felfelé mutató nyíl látható.
A megjelenő Megnyitás ablakban keresse meg a letöltött .json fájlokat tartalmazó mappát a számítógépen.
Válassza Building.json, Floor.json és Room.json, majd a Megnyitás gombra kattintva egyszerre töltse fel őket.
Az Azure Digital Twins Explorer feltölti ezeket a modellfájlokat az Azure Digital Twins-példányba. Meg kell jelenniük a Modellek panelen, és meg kell jelenniük a felhasználóbarát nevüknek és a teljes modellazonosítójuknak.
Az egyes modelltípusokat meghatározó DTDL-kód megtekintéséhez a modellek bármelyikében kiválaszthatja a Modell megtekintése lehetőséget.
Ikerpéldányok és az ikergráf
Most, hogy néhány modelldefiníció fel lett töltve az Azure Digital Twins-példányba, ezekkel a definíciókkal digitális ikerpéldányokat hozhat létre a környezet elemeihez.
A megoldás minden digitális ikerpéldánya egy fizikai környezetből származó entitást jelöl. Több ikerpéldányt is létrehozhat ugyanazon modelltípus alapján, például több szobai ikerpéldányt, amelyek mindegyike a Helyiség modellt használja. Ebben a rövid útmutatóban szüksége lesz egy digitális ikerpéldányra az épülethez, valamint egy digitális ikerpéldányra az épület minden emeletéhez és helyiségéhez. Az ikerpéldányok kapcsolatokkal lesznek összekapcsolva egy ikergráfmal , amely a teljes épületkörnyezetet képviseli.
Ebben a szakaszban egy előre létrehozott gráfot fog feltölteni, amely egy épület ikerpéldányát, két emeleti ikerpéldányt és két szobai ikerpéldányt tartalmaz.
A gráf importálása (.xlsx fájl)
Az Azure Digital Twins Explorerben kövesse az alábbi lépéseket a mintadiagram (a korábban letöltött .xlsx fájl) importálásához.
A Twin Graph panelen válassza az Importálás gráf ikont, amely egy felhőbe mutató nyíllal jelenik meg.
A Megnyitás ablakban keresse meg a korábban letöltött buildingScenario.xlsx fájlt. Ez a fájl a mintagráf iker- és kapcsolatadatait tartalmazza. Válassza a Megnyitás lehetőséget.
Néhány másodperc elteltével az Azure Digital Twins Explorer megnyit egy Importálás nézetet, amely a betöltendő gráf előnézetét jeleníti meg.
A gráf importálásának befejezéséhez válassza a Mentés ikont a gráf előnézeti paneljének jobb felső sarkában.
Az Azure Digital Twins Explorer a feltöltött fájl használatával hozza létre a kért ikerpéldányokat és a köztük lévő kapcsolatokat. A továbblépés előtt győződjön meg arról, hogy az alábbi párbeszédpanel jelzi, hogy az importálás sikeres volt.
Válassza a Bezárás lehetőséget.
A gráf most fel lett töltve az Azure Digital Twins Explorerbe, és a Twin Graph panel újra betöltődik. Üresnek fog tűnni.
A gráf megtekintéséhez válassza a Lekérdezéskezelő panel Lekérdezéskezelő paneljének Lekérdezés futtatása gombját az Azure Digital Twins Explorer ablakának tetején.
Ez a művelet az alapértelmezett lekérdezést futtatja az összes digitális ikerpéldány kiválasztásához és megjelenítéséhez. Az Azure Digital Twins Explorer lekéri az összes ikerpéldányt és kapcsolatot a szolgáltatásból. A Twin Graph panelen rajzolja meg az általuk definiált gráfot . Most már láthatja a mintaforgatókönyv feltöltött gráfját.
A körök (gráfcsomópontok) a digitális ikerpéldányokat jelölik. A sorok a kapcsolatokat jelölik. A BuildingA ikerpéldány "tartalmazza" a Floor0 és a Floor1 ikerpéldányt, a Floor0 ikerpéldányt "tartalmazza" Room0, a Floor1 ikerpéldány pedig "tartalmazza" Room1. Ha egeret használ, a gráfra kattintva és húzással mozoghat az elemek között.
Másik ikerpéldány hozzáadása
A létrehozása után is szerkesztheti a digitális ikergráfok szerkezetét. Tegyük fel, hogy a közelmúltban egy másik szobát építettek a példaépület 1. emeletén. Ebben a szakaszban egy új ikerpéldányt fog hozzáadni a gráfhoz, amely az új helyiséget jelöli.
Először válassza ki azt a modellt, amely meghatározza a létrehozni kívánt ikerpéldány típusát. A bal oldali Modellek panelen nyissa meg a Szobamodell beállítások menüjét. Válassza az Ikerpéldány létrehozása lehetőséget a modelltípus új példányának létrehozásához.
Írja be az Új ikerpéldány 2. szobáját, és válassza a Mentés lehetőséget. Ez létrehoz egy új digitális ikerpéldányt, amelyet a gráf többi részéhez való kapcsolatok még nem kapcsolnak össze.
Ezután hozzáad egy kapcsolatot, amely megmutatja, hogy a Floor1 tartalmazza a Room2-t. A CTRL/CMD vagy a SHIFT billentyűkombinációval egyszerre választhatja ki a Floor1 és a Room2 billentyűkombinációt a diagramon. Ha mindkét ikerpéldány ki van jelölve, kattintson a jobb gombbal a Room2 elemre, és válassza a Kapcsolatok hozzáadása lehetőséget.
Ekkor megnyílik egy Kapcsolat létrehozása párbeszédpanel, amely előre meg van töltve a "tartalmaz" kapcsolat részleteivel az 1. emelettől a 2. helyiségig. Válassza a Mentés lehetőséget.
Most a 2. szoba csatlakoztatva van a diagramon. Ha egeret használ, a gráfban az ikerpéldányokra kattintva és húzásával a kívánt konfigurációba rendezheti őket.
Ikertulajdonságok megtekintése
Kiválaszthat egy ikerpéldányt, ha meg szeretné tekinteni annak tulajdonságait és értékeit az Ikertulajdonságok panelen.
Íme a Room0 tulajdonságai. Figyelje meg, hogy a Room0 hőmérséklete 70.
Íme az 1. szoba tulajdonságai. Figyelje meg, hogy a Room1 hőmérséklete 80.
A Room2 még nem rendelkezik a tulajdonságaihoz beállított értékekkel, mivel ez az ikerpéldány manuálisan lett létrehozva. A tulajdonságértékek beállításához szerkessze a mezőket úgy, hogy a páratartalom 50, a hőmérséklet pedig 72 legyen. Válassza a Mentés ikont.
Lekérdezés az IoT-adatok módosításáról
Az Azure Digital Twinsben lekérdezheti az ikergráfot a környezetével kapcsolatos kérdések megválaszolásához az SQL-stílusú Azure Digital Twins lekérdezési nyelv használatával. A gráfban lévő ikerpéldányok lekérdezésének egyik módja a tulajdonságaik. A tulajdonságokon alapuló lekérdezés segíthet megválaszolni a környezettel kapcsolatos kérdéseket vagy azonosítani a kiugró értékeket. Egy teljesen csatlakoztatott, adatvezérelt forgatókönyvben az ikerpéldányok tulajdonságai gyakran változnak a környezet érzékelőitől származó IoT-adatokra vagy más csatlakoztatott adatforrásokra reagálva. Ebben a rövid útmutatóban manuálisan fogja módosítani az értékeket, hogy szimulálja az érzékelő változó olvasását.
Először is futtasson egy lekérdezést, amelyből megtudhatja, hogy a környezetben hány ikerpéldány hőmérséklete 75 felett van. Futtassa a következő lekérdezést a Lekérdezéskezelő panelen.
SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75
Emlékezzen vissza az ikertulajdonságok korábbi megtekintéséből, hogy a Room0 hőmérséklet-mérése 70, az 1. helyiség hőmérséklet-mérése 80, a 2. szobában pedig 72 hőmérsékleti érték van. Az épület és a padló ikertestvére nem rendelkezik hőmérsékleti tulajdonság egyáltalán. Ezen okok miatt csak a Room1 jelenik meg az eredményekben.
Tipp.
A lekérdezésekben más összehasonlító operátorok (<,>, =vagy !=) is támogatottak. Megpróbálhatja csatlakoztatni ezeket az operátorokat, különböző értékeket vagy különböző ikertulajdonságokat a lekérdezéshez, hogy megpróbálja megválaszolni a saját kérdéseit.
Hőmérsékleti adatok szerkesztése
A teljes mértékben csatlakoztatott Azure Digital Twins-megoldásban a gráfban szereplő ikerpéldányok valós IoT-eszközökről és más adatforrásokból kapnak élő frissítéseket, és automatikusan frissítik a tulajdonságokat, hogy szinkronban maradjanak a valós környezettel. Ebben a rövid útmutatóban az egyszerűség kedvéért az Azure Digital Twins Explorer használatával manuálisan állíthatja be a Room0 hőmérséklet-olvasását 76-ra.
Először futtassa újra a következő lekérdezést az összes digitális ikerpéldány kiválasztásához. Ekkor ismét megjelenik a teljes gráf a Twin Graph panelen.
SELECT * FROM DIGITALTWINS
Válassza a Room0 lehetőséget a tulajdonságlistájának az ikertulajdonságok panelen való megjelenítéséhez.
Módosítsa a hőmérséklet értékét 70-ről76-ra, majd a Mentés ikonra kattintva frissítse a hőmérsékletet.
A tulajdonság sikeres frissítése után megjelenik egy Patch Information mező, amelyen az Azure Digital Twins API-kkal a színfalak mögött használt javításkód látható a frissítés elvégzéséhez.
Zárja be a javítás adatait.
Lekérdezés az új eredmény megtekintéséhez
A gráfban tükröződő Room0 új hőmérsékletének megtekintéséhez futtassa újra a lekérdezést a korábbiakból, hogy a környezet összes ikerpéldánya 75-nél magasabb hőmérsékletű legyen.
SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75
Most, hogy a Room0 hőmérséklete 70-ről 76-ra változott, a Room0 és a Room1 is megjelenik az eredményben.
A tanulás áttekintése és kontextusba iktatása
Ebben a rövid útmutatóban létrehozott egy Azure Digital Twins-példányt, és az Azure Digital Twins Explorer használatával feltöltötte egy mintaforgatókönyvvel. Manuálisan is hozzáadott egy digitális ikerpéldányt.
Ezután megvizsgálta a gráfot, beleértve a...
- Lekérdezéssel válaszolhat a forgatókönyvkel kapcsolatos kérdésekre.
- Tulajdonság szerkesztése egy digitális ikerpéldányon.
- Futtassa újra a lekérdezést, hogy lássa, hogyan változott a válasz a frissítés eredményeként.
A gyakorlat célja, hogy bemutassa, hogyan használható az Azure Digital Twins-gráf a környezettel kapcsolatos kérdések megválaszolására, különösen az IoT-környezetek folyamatos változása során.
Ebben a rövid útmutatóban manuálisan hajtotta végre a hőmérséklet-frissítést. Az Azure Digital Twinsben gyakran előfordul, hogy a digitális ikerpéldányokat valós IoT-eszközökhöz csatlakoztatják, hogy automatikusan megkapják a frissítéseket az eszköz telemetriai adatai alapján. Más adatforrásokat is csatlakoztathat, integrálhatja a különböző rendszerekből származó adatokat, és meghatározhatja az ikerpéldányok frissítésének saját logikáját. Ily módon létrehozhat egy élő grafikont, amely mindig a környezet valós állapotát tükrözi. Lekérdezésekkel valós időben kaphat információt arról, hogy mi történik a környezetében.
Az Azure Digital Twins-adatokat az előzménykövetési, adatelemzési és AI-szolgáltatásokba is exportálhatja, így nagyobb elemzéseket tehet lehetővé, és környezeti szimulációkat hajthat végre. Az Azure Digital Twins IoT-megoldásokba való integrálása segíthet a múlt hatékonyabb nyomon követésében, a jelen szabályozásában és a jövő előrejelzésében.
Az erőforrások eltávolítása
A rövid útmutató után a következő lépések alapján válassza ki, hogy mely Azure Digital Twins-erőforrásokat szeretné eltávolítani.
- Ha folytatni szeretné az Azure Digital Twins rövid útmutatóit és oktatóanyagait, az ebben a rövid útmutatóban szereplő példányt újra felhasználhatja ezekhez a cikkekhez, és nem kell eltávolítania.
Ha továbbra is az Azure Digital Twins-példányt szeretné használni ebből a cikkből, de törli az összes modellt, ikerpéldányt és kapcsolatot, futtassa az alábbi az dt feladattörlési parancssori parancsot:
az dt job deletion create -n <name-of-Azure-Digital-Twins-instance> -yHa csak néhány elemet szeretne törölni, az az dt twin relationship delete, az dt twin delete és az dt model delete parancsokkal csak az eltávolítani kívánt elemeket törölheti szelektíven.
Ha már nincs szüksége az Azure Digital Twins-példányra, törölheti azt az Azure Portalon.
Lépjen vissza a példány áttekintési lapjára a portálon. (Ha már bezárta ezt a lapot, a példányt újra megkeresheti, ha megkeresi a nevét az Azure Portal keresősávjában, és kiválasztja azt a keresési eredmények közül.)
A Törlés gombra kattintva törölheti a példányt, beleértve az összes modellt és ikerpéldányt is.
Érdemes lehet törölni a mintaprojektfájlokat is a helyi gépről.
Következő lépések
Lépjen tovább a következő rövid útmutatóra egy Azure Digital Twins-forgatókönyv 3D környezetben való megjelenítéséhez.
Vagy ugorjon tovább az oktatóanyagokra, hogy mélyebben megismerkedjen az SDK-kkal, az ikergráfok létrehozásával és az eseményfolyamat beállításával.