Sdílet prostřednictvím

Pochopte principy objektových modelů služby Digital Twins a grafu prostorové inteligence

Důležité

Byla vydána nová verze služby Azure Digital Twins. Vzhledem k rozšířeným funkcím nové služby se původní služba Azure Digital Twins (popsaná v této sadě dokumentace) vyřadila z provozu.

Pokud chcete zobrazit dokumentaci k nové službě, navštivte aktivní dokumentaci ke službě Azure Digital Twins.

Azure Digital Twins je služba Azure IoT, která využívá komplexní virtuální reprezentaci fyzických prostředí a přidružených zařízení, senzorů a lidí. Zlepšuje vývoj uspořádáním konceptů specifických pro doménu do užitečných modelů. Modely se pak nacházejí v grafu prostorové inteligence. Tyto koncepty věrně modelují vztahy a interakce mezi lidmi, prostory a zařízeními.

Objektové modely služby Digital Twins popisují koncepty, kategorie a vlastnosti specifické pro doménu. Modely jsou předdefinované uživateli, kteří chtějí přizpůsobit řešení svým konkrétním potřebám. Společně tyto předdefinované objektové modely Služby Digital Twins tvoří ontologie. Ontologie inteligentní budovy zahrnuje oblasti, místa konání, podlahy, kanceláře, zóny, konferenční místnosti a místnosti pro soustředění. Ontologie energetické sítě popisuje různé elektrárny, rozvodny, energetické zdroje a zákazníky. S objektovými modely a ontologiemi služby Digital Twins je možné přizpůsobit různé scénáře a potřeby.

Pomocí objektových modelů služby Digital Twins a ontologie můžete naplnit prostorový graf. Prostorové grafy představují virtuální reprezentaci mnoha vztahů mezi prostory, zařízeními a lidmi, které jsou relevantní pro řešení IoT. Tento diagram znázorňuje příklad prostorového grafu, který používá ontologii inteligentní budovy.

prostorová grafová konstrukce Digital Twins

Prostorový graf spojuje prostory, zařízení, senzory a uživatele. Každá z nich je propojená způsobem, který modeluje skutečný svět. V této ukázce má místo 43 čtyři patra, z nichž každá má mnoho různých oblastí. Uživatelé jsou přidruženi ke svým pracovním stanicím a mají přístup k částem grafu. Správce má práva provádět změny prostorového grafu, zatímco návštěvník má práva k zobrazení pouze určitých dat o budově.

Objektové modely služby Digital Twins

Objektové modely služby Digital Twins podporují tyto hlavní kategorie objektů:

  • Prostory jsou virtuální nebo fyzická místa, například Tenant, Customer, Regiona Venue.
  • zařízení jsou virtuální nebo fyzické části zařízení, například AwesomeCompany Device a Raspberry Pi 3.
  • Senzory jsou objekty, které detekují události, například AwesomeCompany Temperature Sensor a AwesomeCompany Presence Sensor.
  • Uživatelé identifikují obyvatele a jejich charakteristiky.

Další kategorie objektů jsou:

  • Prostředky jsou navázány na prostor a obvykle představují prostředky Azure, které používají objekty v prostorovém grafu, například IoTHub.
  • Blobs jsou připojeny k objektům (například prostorům, zařízením, senzorům a uživatelům). Používají se jako soubory s typem MIME a metadaty, například maps, picturesa manuals.
  • rozšířené typy jsou rozšiřitelné výčty, které rozšiřují entity o specifické charakteristiky, například SpaceType a SpaceSubtype.
  • ontologie představují sadu rozšířených typů, například Default, Building, BACneta EnergyGrid.
  • klíče vlastností a hodnoty jsou vlastní charakteristiky prostorů, zařízení, senzorů a uživatelů. Dají se použít společně s předdefinované charakteristiky, například DeltaProcessingRefreshTime jako klíč a 10 jako hodnota.
  • role jsou sady oprávnění přiřazených uživatelům a zařízením v prostorovém grafu, například Space Administrator, User Administratora Device Administrator.
  • přiřazení rolí jsou spojení mezi rolí a objektem v prostorovém grafu. Například uživateli nebo principálu služby může být uděleno oprávnění spravovat prostor v prostorovém grafu.
  • úložiště klíčů zabezpečení poskytují klíče zabezpečení pro všechna zařízení v hierarchii pod daným objektem prostoru, aby zařízení mohlo bezpečně komunikovat se službou Digital Twins.
  • uživatelem definované funkce (UDF) umožňují přizpůsobitelné zpracování telemetrie senzorů v rámci prostorového grafu. UDF může například:
    • Nastavte hodnotu senzoru.
    • Proveďte vlastní logiku založenou na hodnotách ze snímačů a nastavte výstup na příslušnou hodnotu.
    • Připojte metadata k prostoru.
    • Odesílání oznámení při splnění předdefinovaných podmínek V současné době lze UDF (uživatelsky definované funkce) psát v JavaScriptu.
  • Matchers jsou objekty, které určují, které uživatelské funkce se spouští pro konkrétní telemetrickou zprávu.
  • koncové body představují místa, kam lze směrovat telemetrické zprávy a události služby Digital Twins, například Event Hub, Service Busa Event Grid.

Graf prostorové inteligence

Prostorový graf je hierarchický graf prostorových prostorů, zařízení a lidí definovaných v objektovém modelu služby Digital Twins. Prostorový graf podporuje dědičnost, filtrování, procházení, škálovatelnost a rozšiřitelnost. Prostorový graf můžete spravovat a pracovat s nimi pomocí kolekce rozhraní REST API.

Pokud ve svém předplatném nasadíte službu Digital Twins, stanete se globálním správcem kořenového uzlu. Pak máte automaticky udělen úplný přístup k celé struktuře. Zřiďte v grafu mezery pomocí rozhraní SPACE API. Poskytujte služby s využitím rozhraní API zařízení a senzorů s využitím rozhraní API pro senzory. open source nástroje jsou také k dispozici pro hromadné nastavení grafu.

Dědičnost grafu. Dědičnost se vztahuje na oprávnění a vlastnosti, které se přenášejí z nadřazeného uzlu na všechny uzly pod ním. Pokud je například role přiřazena uživateli na daném uzlu, má uživatel oprávnění dané role k danému uzlu a každému uzlu pod ním. Každý klíč vlastnosti a rozšířený typ definovaný v daném uzlu je děděný všemi uzly pod tímto uzlem.

filtrování grafů . Filtrování se používá k zúžení výsledků požadavků. Můžete filtrovat podle ID, názvu, typů, podtypů, nadřazeného prostoru a přidružených prostorů. Můžete také filtrovat podle datových typů snímačů, klíčů vlastností a hodnot, procházet, minLevel, maxLevela další parametry filtru OData.

procházení grafů. Prostorový graf můžete procházet jeho hloubkou a šířkou. Pokud chcete procházet grafem do hloubky shora dolů nebo zdola nahoru, použijte parametry procházet, minLevela maxLevel. Procházením grafu získáte sourozenecké uzly přímo připojené k nadřazenému prostoru nebo jednomu z jeho potomků v rámci postupu do šířky. Při dotazování na objekt můžete získat všechny související objekty, které mají vztahy k tomuto objektu, pomocí parametru includes v rámci GET API.

škálovatelnost grafu. Služba Digital Twins zaručuje škálovatelnost grafu, aby zvládla vaše úlohy z reálného světa. Služba Digital Twins se dá použít k reprezentaci rozsáhlých portfolií nemovitostí, infrastruktury, zařízení, senzorů, telemetrie a dalších.

Rozšiřitelnost grafu Rozšiřitelnost umožňuje přizpůsobit základní objektové modely služby Digital Twins pomocí nových typů a ontologií. Data služby Digital Twins je také možné rozšířit o rozšiřitelné vlastnosti a hodnoty.

Rozhraní API pro správu grafu s prostorovou inteligencí

Po nasazení služby Digital Twins z webu Azure Portalse automaticky vygeneruje adresa URL Swagger rozhraní API pro správu. Zobrazí se na webu Azure Portal v části Přehled s následujícím formátem.

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger
Název Nahradit za
NÁZEV_VAŠEHO_INSTANCE Název instance služby Digital Twins
VAŠE_MÍSTO V jaké oblasti serveru je vaše instance hostovaná

Na tomto obrázku se zobrazí celý formát adresy URL.

rozhraní API pro správu portálu Digital Twins

Další podrobnosti o používání grafů prostorové inteligence najdete v rozhraních API pro správu služby Azure Digital Twins ve verzi Preview.

Návod

K demonstraci sady funkcí rozhraní API je poskytován náhled Swaggeru. Hostuje se v docs.westcentralus.azuresmartspaces.net/management/swagger.

Přečtěte si další informace o tom, jak používat Swagger.

Všechna volání rozhraní API musí být ověřena pomocí OAuth. Rozhraní API se řídí konvencemi Microsoft REST API Guidelines. Většina rozhraní API, která vracejí kolekce, podporují OData možnosti systémového dotazu.

Další kroky

  • Last updated on