Sdílet prostřednictvím

Vysvětlení modelů objektů Služby Digital Twins a grafu prostorové inteligence

  • Článek

Důležité

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

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á umožňuje komplexní virtuální reprezentaci fyzických prostředí a přidružených zařízení, senzorů a lidí. Vylepš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í řešení přizpůsobit svým konkrétním potřebám. Společně tyto předdefinované objektové modely Služby Digital Twins tvoří ontologii. Ontologie inteligentní budovy popisuje oblasti, místa, podlahy, kanceláře, zóny, konferenční místnosti a fokusové místnosti. Ontologie energetické sítě popisuje různé elektrárny, rozvodny, energetické zdroje a zákazníky. Díky modelům objektů a ontologiím služby Digital Twins je možné přizpůsobit různé scénáře a potřeby.

Pomocí modelů objektů 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á budova prostorového grafu Služby 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 tomto vzorku má místo 43 čtyři patra, každý s mnoha různými oblastmi. Uživatelé jsou přidruženi ke svým pracovním stanicím a přistupují k částem grafu. Správce má práva k provádění změn prostorového grafu, zatímco návštěvník má práva pouze zobrazit určitá data budovy.

Objektové modely služby Digital Twins

Modely objektů Služby Digital Twins podporují tyto hlavní kategorie objektů:

  • Prostory jsou virtuální nebo fyzická umístění, 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í uživatele a jejich charakteristiky.

Mezi další kategorie objektů patří:

  • Prostředky jsou připojené k prostoru a obvykle představují prostředky Azure, které mají být používány objekty v prostorovém grafu, například IoTHub.
  • Objekty blob jsou připojené k objektům (například mezery, zařízení, senzory a uživatelé). Používají se jako soubory s typem mime a metadaty, například maps, a picturesmanuals.
  • Rozšířené typy jsou rozšiřitelné výčty, které rozšiřují entity s konkrétními vlastnostmi, například SpaceType a SpaceSubtype.
  • Ontologie představují sadu rozšířených typů, například Default, , Buildinga BACnetEnergyGrid.
  • Klíče vlastností a hodnoty jsou vlastní charakteristiky prostorů, zařízení, senzorů a uživatelů. Dají se použít spolu s předdefinované charakteristiky, DeltaProcessingRefreshTime například 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, Space Administratornapříklad , a User AdministratorDevice Administrator.
  • Přiřazení rolí jsou přidružení mezi rolí a objektem v prostorovém grafu. Například uživateli nebo instančnímu objektu může být uděleno oprávnění ke správě prostoru 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. Například UDF může:
    • Nastavte hodnotu senzoru.
    • Proveďte vlastní logiku na základě čtení snímačů a nastavte výstup na prostor.
    • Připojte metadata k prostoru.
    • Odesílání oznámení při splnění předdefinovaných podmínek V současné době je možné definované uživatelem psát v JavaScriptu.
  • Matchers jsou objekty, které určují, které UDF se pro danou zprávu telemetrie spouští.
  • Koncové body jsou umístění, kde se dají směrovat telemetrické zprávy a události služby Digital Twins, Event Hubnapříklad , a Service BusEvent Grid.

Graf prostorové inteligence

Prostorový graf je hierarchický graf prostorových prostorů, zařízení a osob 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 ní 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 jste automaticky udělen úplný přístup k celé struktuře. Zřiďte v grafu mezery pomocí rozhraní API pro mezery. Zřiďte služby pomocí rozhraní API a senzorů zařízení pomocí rozhraní API senzoru. Opensourcové nástroje jsou také k dispozici pro hromadné zřizování grafu.

Dědičnost grafu Dědičnost se vztahuje na oprávnění a vlastnosti, které sestupně od nadřazeného uzlu do všech uzlů 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ý pro daný uzel je zděděný všemi uzly pod tímto uzlem.

Filtrování grafů Filtrování slouží 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 mezer. Můžete také filtrovat podle datových typů snímačů, klíčů vlastností a hodnot, procházení, minLevel, maxLevel a dalších parametrů filtru OData.

Procházení grafů Prostorový graf můžete procházet hloubkou a šířkou. Pro hloubku projdete graf shora dolů nebo dolů pomocí parametrů procházející parametry, minLevel a maxLevel. Procházením grafu získáte uzly na stejné úrovni přímo připojené k nadřazeném prostoru nebo jednomu z jeho potomků pro šířku. Při dotazování na objekt můžete získat všechny související objekty, které mají relace s tímto objektem, pomocí parametru zahrnutí rozhraní GET API.

Škálovatelnost grafu Služba Digital Twins zaručuje škálovatelnost grafu, takže dokáže zpracovávat úlohy z reálného světa. Digital Twins lze použít k reprezentaci rozsáhlých portfolií nemovitostí, infrastruktury, zařízení, senzorů, telemetrie a dalších.

Rozšiřitelnost grafu Pomocí rozšiřitelnosti můžete 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 grafů prostorové inteligence

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

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger
Name Nahradit hodnotou
YOUR_INSTANCE_NAME Název instance služby Digital Twins
YOUR_LOCATION Na které oblasti serveru je vaše instance hostovaná

Úplný formát adresy URL se zobrazí na tomto obrázku.

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

Další podrobnosti o tom, jak používat grafy prostorové inteligence, najdete v rozhraních API služby Azure Digital Twins Management Preview.

Tip

K předvedení sady funkcí rozhraní API se poskytuje Swagger sneak Preview. 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 rozhraní MICROSOFT REST API. Většina rozhraní API, která vracejí kolekce, podporují možnosti systémového dotazu OData .

Další kroky