Oktatóanyag: Azure Digital Twins-gráf létrehozása az Azure CLI használatával

• Mintaügyfél-alkalmazás
• CLI

Ebben az oktatóanyagban egy gráfot fog létrehozni az Azure Digital Twinsben modellek, ikerpéldányok és kapcsolatok használatával. Az oktatóanyag eszköze az Azure CLI Azure Digital Twins parancskészlete.

A CLI-parancsokkal olyan alapvető Azure Digital Twins-műveleteket hajthat végre, mint a modellek feltöltése, az ikerpéldányok létrehozása és módosítása, valamint kapcsolatok létrehozása. Az az dt parancskészlet referenciadokumentációját is megtekintheti a PARANCSSOR-parancsok teljes készletének megtekintéséhez.

Ebben az oktatóanyagban...

• Környezet modellezése
• Digitális ikerpéldányok létrehozása
• Kapcsolatok hozzáadása gráf létrehozásához
• A gráf lekérdezése a kérdések megválaszolásához

Előfeltételek

Az oktatóanyag lépéseinek elvégzéséhez először el kell végeznie a következő előfeltételeket.

Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.

A mintamodellek letöltése

Az oktatóanyag két előre megírt modellt használ, amelyek az Azure Digital Twins C# teljes körű mintaprojektjének részét képezik. A modellfájlok itt találhatók:

• Room.json
• Floor.json

A fájlok számítógépen való lekéréséhez használja a fenti navigációs hivatkozásokat, és másolja a fájltörzseket a számítógépen lévő helyi fájlokba ugyanazokkal a névvel (Room.json és Floor.json).

A környezet előkészítése az Azure CLI-hez

• 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.

Parancssori felületi munkamenet beállítása

Az Azure Digital Twins parancssori felületen való használatának megkezdéséhez először be kell jelentkeznie, és be kell állítania a CLI-környezetet az előfizetéséhez ehhez a munkamenethez. Futtassa az alábbi parancsokat a parancssori felület ablakában:

az login
az account set --subscription "<your-Azure-subscription-ID>"

Tipp.

A fenti parancsban szereplő azonosító helyett az előfizetés nevét is használhatja.

Ha ez az első alkalom, hogy ezt az előfizetést az Azure Digital Twins szolgáltatással használja, futtassa ezt a parancsot az Azure Digital Twins névtérben való regisztrációhoz. (Ha nem biztos benne, akkor is nyugodtan futtathatja újra, ha valamikor a múltban tette.)

az provider register --namespace 'Microsoft.DigitalTwins'

Ezután hozzáadja az Azure CLI-hez készült Microsoft Azure IoT-bővítményt, hogy lehetővé tegye az Azure Digital Twins és más IoT-szolgáltatások közötti interakció parancsait. Futtassa ezt a parancsot, és győződjön meg arról, hogy a bővítmény legújabb verziójával rendelkezik:

az extension add --upgrade --name azure-iot

Most már készen áll az Azure Digital Twins azure CLI-ben való kezelésére.

Ezt bármikor ellenőrizheti az dt --help , és megtekintheti az elérhető legfelső szintű Azure Digital Twins-parancsok listáját.

Azure Digital Twins-példány előkészítése

Az Azure Digital Twins ebben a cikkben való használatához először be kell állítania egy Azure Digital Twins-példányt és a használatához szükséges engedélyeket. Ha már beállított egy Azure Digital Twins-példányt az előző munkából, használhatja ezt a példányt.

Ellenkező esetben kövesse a példány és a hitelesítés beállítása című témakör utasításait. Az utasítások lépéseket is tartalmaznak annak ellenőrzéséhez, hogy sikeresen végrehajtotta-e az egyes lépéseket, és készen áll az új példány használatára.

Az Azure Digital Twins-példány beállítása után jegyezze fel a következő értékeket, amelyeket később csatlakoznia kell a példányhoz:

• A példány állomásneve
• A példány létrehozásához használt Azure-előfizetés

Tipp.

Ha ismeri a példány rövid nevét, a következő PARANCSSOR-paranccsal lekérheti a gazdagép nevét és az előfizetés értékeit:

az dt show --dt-name <Azure-Digital-Twins-instance-name>

A következő módon jelennek meg a kimenetben:

Fizikai környezet modellezése DTDL-vel

Most, hogy a CLI és az Azure Digital Twins-példány be van állítva, megkezdheti egy forgatókönyv gráfjának elkészítését.

Az Azure Digital Twins-megoldás létrehozásának első lépése az ikermodellek meghatározása a környezet számára.

A modellek hasonlóak az objektumorientált programozási nyelvek osztályaihoz; felhasználó által definiált sablonokat biztosítanak a digitális ikerpéldányok számára, hogy később követhessenek és példányosíthassanak . Ezek egy JSON-szerű, Digital Twins Definition Language (DTDL) nevű nyelven vannak megírva, és meghatározhatják az ikerpéldány tulajdonságait, kapcsolatait és összetevőit.

Megjegyzés:

A DTDL lehetővé teszi a digitális ikerpéldányok parancsainak meghatározását is. Az Azure Digital Twins szolgáltatás azonban jelenleg nem támogatja a parancsokat.

Navigáljon a számítógépen az Előfeltételek szakaszban létrehozott Room.json fájlhoz. Nyissa meg egy kódszerkesztőben, és módosítsa a következő módokon:

1. Frissítse a verziószámot, hogy jelezze, hogy a modell frissítettebb verzióját adja meg. Ezt úgy teheti meg, hogy az érték végén @id lévő 1-et 2-re módosítja. Az aktuális verziószámnál nagyobb szám is működni fog.

2. Tulajdonság szerkesztése. Módosítsa a tulajdonság nevét Humidity Páratartalomszintre (vagy ha szeretné, valami másra). Ha valami mást használ, mint a HumidityLevel, jegyezze meg, mit használt, és folytassa a használatát a Páratartalomszint helyett az oktatóanyag során).

3. Adjon hozzá egy tulajdonságot. HumidityLevel A 15. sorban végződő tulajdonság alatt illessze be a következő kódot, hogy hozzáadjon egy RoomName tulajdonságot a helyiséghez:

   ,{
     "@type": "Property",
     "name": "RoomName",
     "schema": "string"
   }
   

4. Adjon hozzá egy kapcsolatot. RoomName Az imént hozzáadott tulajdonság alá illessze be a következő kódot, hogy hozzáadja az ikerpéldányok contains ilyen típusú kapcsolatának lehetőségét más ikerpéldányokkal:

   ,{
     "@type": "Relationship",
     "name": "contains"
   }
   

Ha végzett, a frissített modellnek a következőnek kell megfelelnie:

{
    "@id": "dtmi:example:Room;2",
    "@type": "Interface",
    "displayName": "Room",
    "contents": [
      {
        "@type": "Property",
        "name": "Temperature",
        "schema": "double"
      },
      {
        "@type": "Property",
        "name": "HumidityLevel",
        "schema": "double"
      }
      ,{
        "@type": "Property",
        "name": "RoomName",
        "schema": "string"
      }
      ,{
        "@type": "Relationship",
        "name": "contains"
      }
    ],
    "@context": "dtmi:dtdl:context;3"
  }

Mielőtt továbblépne, mentse a fájlt.

Modellek feltöltése az Azure Digital Twinsbe

A modellek tervezése után fel kell töltenie őket az Azure Digital Twins-példányba. Ezzel konfigurálja az Azure Digital Twins szolgáltatáspéldányt saját egyéni tartománykincsével. Miután feltöltötte a modelleket, létrehozhat azokat használó ikerpéldányokat.

1. Ha az Azure CLI helyi telepítését használja, kihagyhatja ezt a lépést. Ha Cloud Shellt használ, fel kell töltenie a modellfájlokat a Cloud Shell tárterületére, hogy a fájlok elérhetők legyenek az őket használó Cloud Shell-parancs futtatásakor. Ehhez válassza a "Fájlok feltöltése/letöltése" ikont, majd a "Feltöltés" lehetőséget.

   

   Lépjen a Room.json fájlra a számítógépen, és válassza a "Megnyitás" lehetőséget. Ezután ismételje meg ezt a lépést a Floor.json esetében.

2. Ezután használja az az dt model create parancsot az alább látható módon, hogy feltöltse a frissített szobamodellt az Azure Digital Twins-példányba. A második parancs feltölt egy másik modellt, a Floort, amelyet a következő szakaszban is használni fog, hogy különböző típusú ikerpéldányokat hozzon létre. A példány gazdagépnevének helyőrzője (a példány felhasználóbarát nevét is használhatja a teljesítmény enyhe csökkenésével), valamint egy helyőrzőt az egyes modellfájlok elérési útjának. Ha Cloud Shellt használ, a Room.json és a Floor.json a fő tárkönyvtárban található, így a fájlneveket közvetlenül az alábbi parancsban használhatja, ahol elérési út szükséges.

   az dt model create --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --models <path-to-Room.json>
   az dt model create --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --models <path-to-Floor.json>
   

   Az egyes parancsok kimenete megjeleníti a sikeresen feltöltött modell adatait.

   Tipp.

   A modell létrehozási parancsának beállításával --from-directory egyszerre is feltöltheti az összes modellt egy könyvtárban. További információ: Az dt model create opcionális paraméterei.

3. Ellenőrizze, hogy a modellek létre lettek-e hozva az az dt modelllista paranccsal az alább látható módon. Ezzel kinyomtatja az Azure Digital Twins-példányba feltöltött összes modell listáját a teljes információjukkal. A példány gazdagépneve egyetlen helyőrzővel rendelkezik (a példány rövid nevét is használhatja a teljesítmény enyhe csökkenésével).

   az dt model list --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --definition
   

   Keresse meg a szerkesztett szobamodellt az eredmények között:

   

Hibák

A parancssori felület a szolgáltatás hibáit is kezeli.

Futtassa újra a az dt model create parancsot, és próbálja újra feltölteni a feltöltött modellek egyikét, még egyszer:

az dt model create --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --models Room.json

Mivel a modellek nem írhatók felül, a parancs ugyanazon a modellen való futtatása mostantól a következő hibakódot ModelIdAlreadyExistsadja vissza: .

Digitális ikerpéldányok létrehozása

Most, hogy néhány modell fel lett töltve az Azure Digital Twins-példányba, létrehozhat digitális ikerpéldányokat a modelldefiníciók alapján. A digitális ikerpéldányok az üzleti környezeten belüli entitásokat jelölik– ilyenek például a farm érzékelői, az épület helyiségei vagy az autó fényei.

Digitális ikerpéldány létrehozásához használja az az dt twin create parancsot. Hivatkoznia kell arra a modellre, amelyen az ikerpéldány alapul, és megadhat kezdeti értékeket a modell bármely tulajdonságához. Ebben a szakaszban nem kell semmilyen kapcsolati információt átadnia.

1. Futtassa ezt a kódot a parancssori felületen több ikerpéldány létrehozásához a korábban frissített Szoba modell és egy másik, Floor modell alapján. Ne feledje, hogy a Helyiség három tulajdonsággal rendelkezik, így argumentumokat adhat meg ezeknek a tulajdonságoknak a kezdeti értékeivel. (A tulajdonságértékek inicializálása általában nem kötelező, de ehhez az oktatóanyaghoz szükség van rájuk.) A példány gazdagépneve egyetlen helyőrzővel rendelkezik (a példány rövid nevét is használhatja a teljesítmény enyhe csökkenésével).

   az dt twin create --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --dtmi "dtmi:example:Room;2" --twin-id room0 --properties '{"RoomName":"Room0", "Temperature":70, "HumidityLevel":30}'
   az dt twin create --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --dtmi "dtmi:example:Room;2" --twin-id room1 --properties '{"RoomName":"Room1", "Temperature":80, "HumidityLevel":60}'
   az dt twin create --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --dtmi "dtmi:example:Floor;1" --twin-id floor0
   az dt twin create --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --dtmi "dtmi:example:Floor;1" --twin-id floor1
   

   Megjegyzés:

   Ha a Cloud Shellen kívül mást is használ a Bash-környezetben, előfordulhat, hogy a beágyazott JSON bizonyos karaktereit meg kell szabadulnia a helyes elemzéshez.

   További információ: Speciális karakterek használata különböző rendszerhéjakban.

   Az egyes parancsok kimenete megjeleníti a sikeresen létrehozott ikerpéldány adatait (beleértve a velük inicializált szobai ikerpéldányok tulajdonságait is).

2. Az alábbi módon ellenőrizheti, hogy az ikerpéldányok az az dt twin query paranccsal lettek-e létrehozva. A megjelenő lekérdezés megkeresi az Összes digitális ikerpéldányt az Azure Digital Twins-példányban. A példány gazdagépneve egyetlen helyőrzővel rendelkezik (a példány rövid nevét is használhatja a teljesítmény enyhe csökkenésével).

   az dt twin query --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --query-command "SELECT * FROM DIGITALTWINS"
   

   Keresse meg a room0, room1, floor0, és floor1 ikerpéldányokat az eredményekben. Íme egy részlet, amely a lekérdezés eredményének egy részét mutatja.

   

Megjegyzés:

A gráf adatainak módosítása után akár 10 másodperces késés is előfordulhat, mielőtt a módosítások megjelennek a lekérdezésekben.

A DigitalTwins API azonnal tükrözi a változásokat, ezért ha azonnali válaszra van szüksége, lekérdezés helyett használjon EGY API-kérést (DigitalTwins GetById) vagy egy SDK-hívást (GetDigitalTwin).

Digitális ikerpéldány módosítása

A létrehozott ikerpéldány tulajdonságait is módosíthatja.

1. Futtassa az alábbi az dt twin update parancsot a room0 Room0 RoomName-ről PresidentialSuite-ra való módosításához. A példány gazdagépneve egyetlen helyőrzővel rendelkezik (a példány rövid nevét is használhatja a teljesítmény enyhe csökkenésével).

   az dt twin update --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --twin-id room0 --json-patch '{"op":"add", "path":"/RoomName", "value": "PresidentialSuite"}'
   

   Megjegyzés:

   Javasoljuk, hogy az oktatóanyaghoz használja a parancssori felületet a Bash-környezetben. Ha a PowerShell-környezetet használja, előfordulhat, hogy el kell menekülnie az idézőjelek karakterei elől ahhoz, hogy a --json-patch JSON-érték megfelelően legyen elemezve.

   A parancs kimenete megjeleníti az ikerpéldány aktuális adatait, és látnia kell az RoomName eredmény új értékét.

   

2. A frissítés sikerességét az az dt twin show parancs futtatásával ellenőrizheti a room0 információinak megtekintéséhez. A példány gazdagépneve egyetlen helyőrzővel rendelkezik (a példány rövid nevét is használhatja a teljesítmény enyhe csökkenésével).

   az dt twin show --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --twin-id room0
   

   A kimenetnek tükröznie kell a frissített nevet.

Diagram létrehozása kapcsolatok hozzáadásával

Ezután létrehozhat néhány kapcsolatot ezek között az ikerpéldányok között, hogy összekapcsolja őket egy ikergráfban. Az ikergráfok egy teljes környezetet jelölnek.

Az ikerpéldányról a másikra létrehozható kapcsolatok típusai a korábban feltöltött modelleken belül vannak definiálva. A Floor modelldefiníciója azt határozza meg, hogy a padlóknak legyen egy kapcsolattípusuk.contains Mivel a modelldefiníció ezt a kapcsolatot határozza meg, létrehozhat egy contains-type kapcsolatot az egyes emeleti ikerpéldányok és a benne található megfelelő helyiség között.

Kapcsolat hozzáadásához használja az az dt twin relationship create parancsot. Adja meg azt az ikerpéldányt, amelyből a kapcsolat származik, a kapcsolat típusát és azt az ikerpéldányt, amelyhez a kapcsolat kapcsolódik. Végül adjon meg egy egyedi azonosítót a kapcsolatnak. Ha egy kapcsolat tulajdonsággal rendelkezik, inicializálhatja a kapcsolat tulajdonságait ebben a parancsban is.

1. Futtassa a következő kódot egy contains-type kapcsolat hozzáadásához a korábban létrehozott egyes emeleti ikerpéldányokból a megfelelő szobai ikerpéldányhoz. A kapcsolatok neve relationship0 és relationship1. A példány gazdagépneve egyetlen helyőrzővel rendelkezik (a példány rövid nevét is használhatja a teljesítmény enyhe csökkenésével).

   az dt twin relationship create --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --relationship-id relationship0 --relationship contains --twin-id floor0 --target room0
   az dt twin relationship create --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --relationship-id relationship1 --relationship contains --twin-id floor1 --target room1
   

   Tipp.

   A contains Floor modellben lévő kapcsolatot két tulajdonsággal is definiálta, ownershipUser így ownershipDepartmenta kapcsolatok létrehozásakor argumentumokat is megadhat ezek kezdeti értékeivel. Ha inicializálva szeretne kapcsolatot létesíteni ezekkel a tulajdonságokkal, adja hozzá a --properties lehetőséget a fenti parancsok egyikéhez, például a következőhöz:

   ... --properties '{"ownershipUser":"MyUser", "ownershipDepartment":"MyDepartment"}'
   

   Az egyes parancsok kimenete megjeleníti a sikeresen létrehozott kapcsolat adatait.

2. A kapcsolatokat az alábbi parancsok bármelyikével ellenőrizheti, amelyek kinyomtatják a kapcsolatokat az Azure Digital Twins-példányban. Minden parancs egy helyőrzővel rendelkezik a példány gazdagépneve számára (a példány felhasználóbarát nevét is használhatja enyhe teljesítménycsökkenéssel).

   • Ha látni szeretné, hogy minden kapcsolat lejön az egyes emeletekről (a kapcsolatokat az egyik oldalról tekintheti meg):

     az dt twin relationship list --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --twin-id floor0
     az dt twin relationship list --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --twin-id floor1
     

   • Az egyes szobákba érkező összes kapcsolat megtekintése (a kapcsolat megtekintése a "másik" oldalról):

     az dt twin relationship list --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --twin-id room0 --incoming
     az dt twin relationship list --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --twin-id room1 --incoming
     

   • Ha ezeket a kapcsolatokat egyenként szeretné megkeresni, azonosító szerint:

     az dt twin relationship show --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --twin-id floor0 --relationship-id relationship0
     az dt twin relationship show --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --twin-id floor1 --relationship-id relationship1
     

Az oktatóanyagban beállított ikerpéldányok és kapcsolatok a következő fogalmi grafikont alkotják:

Az ikergráf lekérdezése környezeti kérdések megválaszolásához

Az Azure Digital Twins fő funkciója az ikergráf egyszerű és hatékony lekérdezése a környezettel kapcsolatos kérdések megválaszolásához. Az Azure CLI-ben a lekérdezés az az dt twin query paranccsal történik.

Megjegyzés:

A gráf adatainak módosítása után akár 10 másodperces késés is előfordulhat, mielőtt a módosítások megjelennek a lekérdezésekben.

A DigitalTwins API azonnal tükrözi a változásokat, ezért ha azonnali válaszra van szüksége, lekérdezés helyett használjon EGY API-kérést (DigitalTwins GetById) vagy egy SDK-hívást (GetDigitalTwin).

Futtassa az alábbi lekérdezéseket a parancssori felületen a mintakörnyezettel kapcsolatos kérdések megválaszolásához. Minden parancs egy helyőrzővel rendelkezik a példány gazdagépneve számára (a példány felhasználóbarát nevét is használhatja enyhe teljesítménycsökkenéssel).

1. Mik a környezetem összes entitása az Azure Digital Twinsben? (az összes lekérdezése)

   az dt twin query --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --query-command "SELECT * FROM DIGITALTWINS"
   

   Ez a lekérdezés lehetővé teszi, hogy egy pillantással áttekintse a környezetét, és győződjön meg arról, hogy minden úgy jelenik meg, ahogy szeretné, hogy az Azure Digital Twinsben legyen. A lekérdezés eredménye egy olyan kimenet, amely az egyes digitális ikerpéldányokat tartalmazza annak részleteivel. Íme egy részlet:

   

   Tipp.

   Felismerheti, hogy ez ugyanaz a parancs, amelyet korábban a Digitális ikerpéldányok létrehozása szakaszban használt a példány összes Azure Digital Twins-példányának megkereséséhez.

2. Mik a környezetemben lévő összes szoba? (lekérdezés modell szerint)

   az dt twin query --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --query-command "SELECT * FROM DIGITALTWINS T WHERE IS_OF_MODEL(T, 'dtmi:example:Room;2')"
   

   A lekérdezést egy bizonyos típusú ikerpéldányra korlátozhatja, hogy pontosabb információkat kapjon a képviselt adatokról. Ennek eredménye a room0 és a room1, de nem a floor0 vagy a floor1 (mivel ezek emeletek, nem szobák).

   

3. Mik azok a szobák a padlón? (lekérdezés kapcsolat szerint)

   az dt twin query --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --query-command "SELECT room FROM DIGITALTWINS floor JOIN room RELATED floor.contains where floor.\$dtId = 'floor0'"
   

   A gráfban lévő kapcsolatok alapján lekérdezheti az ikerpéldányok kapcsolatát, vagy korlátozhatja a lekérdezést egy adott területre. Ez a lekérdezés azt is szemlélteti, hogy egy ikerpéldány azonosítóját (például a fenti lekérdezés floor0-ját) a metaadatmező használatával kérdezi le a rendszer $dtId. Csak a szoba0 van a padlón, ezért ez az egyetlen helyiség az eredményben a lekérdezéshez.

   

   Megjegyzés:

   Ha a Cloud Shell használatával olyan metaadatmezőkkel futtat lekérdezést, mint ez a lekérdezés $, akkor egy fordított perjellel kell megkerülnie a $ lekérdezést, hogy a Cloud Shell tudja, hogy ez nem változó, és a lekérdezés szövegében literálként kell használni. Ez a fenti képernyőképen is megjelenik.

4. Milyen ikerpéldányok vannak a környezetemben 75 fölötti hőmérséklettel? (lekérdezés tulajdonság szerint)

   az dt twin query --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --query-command "SELECT * FROM DigitalTwins T WHERE T.Temperature > 75"
   

   A gráfot tulajdonságok alapján kérdezheti le, hogy különböző típusú kérdésekre válaszoljon, beleértve azokat a kiugró értékeket a környezetben, amelyek figyelmet igényelhetnek. Más összehasonlító operátorok (<,>, =vagy !=) is támogatottak. room1 jelenik meg az eredmények itt, mert a hőmérséklete 80.

   

5. Mik azok a szobák a padlón, amelyek hőmérséklete 75 felett van? (összetett lekérdezés)

   az dt twin query --dt-name <Azure-Digital-Twins-instance-hostname-or-name> --query-command "SELECT room FROM DIGITALTWINS floor JOIN room RELATED floor.contains where floor.\$dtId = 'floor0' AND IS_OF_MODEL(room, 'dtmi:example:Room;2') AND room.Temperature > 75"
   

   Kombinálhatja a korábbi lekérdezéseket is, mint az SQL-ben, olyan kombinációs operátorok használatával, mint a AND, OR. NOT Ez a lekérdezés az AND ikerhőmérsékletekkel kapcsolatos előző lekérdezés pontosabbá tétele. Az eredmény most már csak a 75-ösnél magasabb hőmérsékletű helyiségeket tartalmazza, amelyek a padlón vannak – ami ebben az esetben egyik sem. Az eredményhalmaz üres.

   

Clean up resources

Az oktatóanyag elvégzése után kiválaszthatja, hogy mely erőforrásokat szeretné eltávolítani a következő lépéstől függően.

• Ha folytatni szeretné a következő oktatóanyagot, megtarthatja az itt beállított erőforrásokat, és újra felhasználhatja az Azure Digital Twins-példányt anélkül, hogy bármit törölnél a kettő között.

• 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> -y
  

  Ha 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 nincs szüksége az oktatóanyagban létrehozott erőforrások egyikére sem, törölheti az Azure Digital Twins-példányt és az összes többi erőforrást ebből a cikkből az az group delete CLI paranccsal. Ez törli az erőforráscsoport összes Azure-erőforrását, valamint magát az erőforráscsoportot is.

  Fontos

  Az erőforráscsoport törlése nem vonható vissza. Az erőforráscsoport és a benne foglalt erőforrások véglegesen törlődnek. Figyeljen, nehogy véletlenül rossz erőforráscsoportot vagy erőforrásokat töröljön.

  Nyissa meg az Azure Cloud Shellt vagy egy helyi CLI-ablakot, és futtassa a következő parancsot az erőforráscsoport és a benne található elemek törléséhez.

  az group delete --name <your-resource-group>
  

Érdemes lehet törölni a helyi gépen létrehozott modellfájlokat is.

További lépések

Ebben az oktatóanyagban az Azure Digital Twins használatának első lépéseit az Azure CLI használatával készített egy gráf használatával a példányban. Modelleket, digitális ikerpéldányokat és kapcsolatokat hozott létre egy gráf létrehozásához. A gráfon is futtatott néhány lekérdezést, hogy képet kapjon arról, hogy az Azure Digital Twins milyen típusú kérdésekre tud válaszolni egy környezettel kapcsolatban.

Folytassa a következő oktatóanyaggal az Azure Digital Twins más Azure-szolgáltatásokkal való kombinálásához egy adatvezérelt, teljes körű forgatókönyv végrehajtásához:

végpontok közötti megoldás Csatlakozás