Omówienie modeli obiektów usługi Digital Twins i wykresu analizy przestrzennej

Ważne

Wydano nową wersję usługi Azure Digital Twins. W świetle rozszerzonych możliwości nowej usługi oryginalna usługa Azure Digital Twins (opisana w tym zestawie dokumentacji) została wycofana.

Aby wyświetlić dokumentację nowej usługi, odwiedź aktywną dokumentację usługi Azure Digital Twins.

Azure Digital Twins to usługa Azure IoT, która obsługuje kompleksowe wirtualne reprezentacje środowisk fizycznych i skojarzonych urządzeń, czujników i osób. Usprawnia programowanie, organizując koncepcje specyficzne dla domeny w przydatne modele. Następnie modele znajdują się w grafie analizy przestrzennej. Takie koncepcje dokładnie modelują relacje i interakcje między osobami, przestrzeniami i urządzeniami.

Modele obiektów usługi Digital Twins opisują pojęcia, kategorie i właściwości specyficzne dla domeny. Modele są wstępnie zdefiniowane przez użytkowników, którzy chcą dostosować rozwiązanie do swoich potrzeb. Razem te wstępnie zdefiniowane modele obiektów usługi Digital Twins tworzą ontologię. Ontologia inteligentnego budynku opisuje regiony, miejsca, piętra, biura, strefy, sale konferencyjne i pokoje fokusowe. Intologia sieci energetycznej opisuje różne elektrownie, podstacje, zasoby energetyczne i klientów. Dzięki modelom obiektów i nalogom usługi Digital Twins można dostosować różne scenariusze i potrzeby.

Dzięki modelom obiektów usługi Digital Twins i lokalnej grafowi można wypełnić graf przestrzenny. Wykresy przestrzenne to wirtualne reprezentacje wielu relacji między przestrzeniami, urządzeniami i osobami, które są istotne dla rozwiązania IoT. Ten diagram przedstawia przykład wykresu przestrzennego, który używa ontologii inteligentnego budynku.

Wykres przestrzenny łączy przestrzenie, urządzenia, czujniki i użytkowników. Każda z nich jest połączona w sposób, który modeluje świat rzeczywisty. W tym przykładzie miejsce 43 ma cztery piętra, z których każdy ma wiele różnych obszarów. Użytkownicy są powiązani ze swoimi stacjami roboczymi i mają dostęp do części grafu. Administrator ma uprawnienia do wprowadzania zmian w grafie przestrzennym, podczas gdy gość ma uprawnienia do wyświetlania tylko niektórych danych konstrukcyjnych.

Modele obiektów usługi Digital Twins

Modele obiektów usługi Digital Twins obsługują następujące główne kategorie obiektów:

• Miejsca to lokalizacje wirtualne lub fizyczne, na przykład , TenantCustomer, Regioni Venue.
• Urządzenia to wirtualne lub fizyczne elementy sprzętu, na przykład i AwesomeCompany DeviceRaspberry Pi 3.
• Czujniki to obiekty, które wykrywają zdarzenia, na przykład i AwesomeCompany Temperature SensorAwesomeCompany Presence Sensor.
• Użytkownicy identyfikują pasażerów i ich cechy.

Inne kategorie obiektów to:

• Zasoby są dołączane do przestrzeni i zwykle reprezentują zasoby platformy Azure, które mają być używane przez obiekty na wykresie przestrzennym, na przykład IoTHub.
• Obiekty blob są dołączane do obiektów (takich jak spacje, urządzenia, czujniki i użytkownicy). Są one używane jako pliki z typem mime i metadanymi, mapsna przykład , picturesi manuals.
• Rozszerzone typy to rozszerzalne wyliczenia, które rozszerzają jednostki o określone cechy, na przykład SpaceType i SpaceSubtype.
• Nalogie reprezentują zestaw rozszerzonych typów, Defaultna przykład , Building, BACneti EnergyGrid.
• Klucze i wartości właściwości to niestandardowe cechy przestrzeni, urządzeń, czujników i użytkowników. Można ich używać wraz z wbudowanymi cechami, DeltaProcessingRefreshTime na przykład kluczem i 10 wartością.
• Role to zestawy uprawnień przypisanych do użytkowników i urządzeń na wykresie przestrzennym, na przykład Space Administrator, User Administratori Device Administrator.
• Przypisania ról to skojarzenie między rolą a obiektem na grafie przestrzennym. Na przykład użytkownik lub jednostka usługi można udzielić uprawnień do zarządzania przestrzenią na grafie przestrzennym.
• Magazyny kluczy zabezpieczeń udostępniają klucze zabezpieczeń dla wszystkich urządzeń w hierarchii w ramach danego obiektu przestrzeni, aby umożliwić urządzeniu bezpieczną komunikację z usługą Digital Twins.
• Funkcje zdefiniowane przez użytkownika (UDF) umożliwiają dostosowywanie przetwarzania telemetrii czujnika w ramach grafu przestrzennego. Na przykład funkcja zdefiniowanej przez użytkownika może:
  • Ustaw wartość czujnika.
  • Wykonuj logikę niestandardową na podstawie odczytów czujników i ustaw dane wyjściowe na spację.
  • Dołączanie metadanych do przestrzeni.
  • Wysyłanie powiadomień po spełnieniu wstępnie zdefiniowanych warunków. Obecnie funkcje zdefiniowane przez użytkownika można pisać w języku JavaScript.
• Matchers to obiekty, które określają, które funkcje zdefiniowane przez użytkownika są wykonywane dla danego komunikatu telemetrii.
• Punkty końcowe to lokalizacje , w których można kierować komunikaty telemetryczne i zdarzenia usługi Digital Twins, na przykład Event Hub, Service Busi Event Grid.

Wykres analizy przestrzennej

Wykres przestrzenny to hierarchiczny wykres spacji, urządzeń i osób zdefiniowanych w modelu obiektów usługi Digital Twins. Wykres przestrzenny obsługuje dziedziczenie, filtrowanie, przechodzenie, skalowalność i rozszerzalność. Możesz zarządzać grafem przestrzennym i korzystać z niej za pomocą kolekcji interfejsów API REST.

Jeśli wdrożysz usługę Digital Twins w ramach subskrypcji, zostaniesz administratorem globalnym węzła głównego. Następnie otrzymujesz automatycznie pełny dostęp do całej struktury. Aprowizuj spacje na grafie przy użyciu interfejsu API spacji. Aprowizuj usługi przy użyciu interfejsu API urządzenia i czujników przy użyciu interfejsu API czujnika. Narzędzia typu open source są również dostępne do zbiorczej aprowizacji grafu.

Dziedziczenie grafu. Dziedziczenie ma zastosowanie do uprawnień i właściwości, które pochodzą z węzła nadrzędnego do wszystkich węzłów pod nim. Na przykład gdy rola jest przypisana do użytkownika w danym węźle, użytkownik ma uprawnienia tej roli do danego węzła i każdego węzła poniżej niego. Każdy klucz właściwości i rozszerzony typ zdefiniowany dla danego węzła są dziedziczone przez wszystkie węzły pod tym węzłem.

Filtrowanie grafów. Filtrowanie służy do zawężania wyników żądania. Można filtrować według identyfikatorów, nazw, typów, podtypów, przestrzeni nadrzędnej i skojarzonych spacji. Można również filtrować według typów danych czujników, kluczy właściwości i wartości, przechodzenia, minLevel, maxLevel i innych parametrów filtru OData.

Przechodzenie grafu. Wykres przestrzenny można przechodzić przez jego głębokość i szerokość. Aby uzyskać głębokość, przejdź do wykresu od góry do dołu lub do dołu, korzystając z przechodzenia parametrów, minLevel i maxLevel. Przechodzenie przez graf w celu bezpośredniego dołączenia węzłów równorzędnych do przestrzeni nadrzędnej lub jednego z jego elementów podrzędnych w celu uzyskania szerokości. Podczas wykonywania zapytania dotyczącego obiektu można pobrać wszystkie powiązane obiekty, które mają relacje z tym obiektem, używając parametru dołączania interfejsów API GET.

Skalowalność grafu. Usługa Digital Twins gwarantuje skalowalność grafu, dzięki czemu może obsługiwać rzeczywiste obciążenia. Usługa Digital Twins może służyć do reprezentowania dużych portfeli nieruchomości, infrastruktury, urządzeń, czujników, telemetrii i nie tylko.

Rozszerzalność grafu. Rozszerzalność służy do dostosowywania podstawowych modeli obiektów usługi Digital Twins przy użyciu nowych typów i nalogów. Dane usługi Digital Twins można również wzbogacić o rozszerzalne właściwości i wartości.

Interfejsy API zarządzania grafami analizy przestrzennej

Po wdrożeniu usługi Digital Twins z Azure Portal automatycznie generowany jest adres URL programu Swagger interfejsów API zarządzania. Jest on wyświetlany w Azure Portal w sekcji Przegląd z następującym formatem.

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger

Nazwa	Zamień na
YOUR_INSTANCE_NAME	Nazwa używanego wystąpienia usługi Digital Twins
YOUR_LOCATION	Region serwera, w którym jest hostowane używane wystąpienie

Pełny format adresu URL zostanie wyświetlony na tym obrazie.

Aby uzyskać więcej informacji na temat używania wykresów analizy przestrzennej, odwiedź stronę Interfejsy API zarządzania usługą Azure Digital Twins w wersji zapoznawczej.

Porada

Dostępna jest wersja zapoznawcza programu Swagger w celu zademonstrowania zestawu funkcji interfejsu API. Jest on hostowany w docs.westcentralus.azuresmartspaces.net/management/swagger.

Dowiedz się więcej o sposobie korzystania z programu Swagger.

Wszystkie wywołania interfejsu API muszą być uwierzytelniane przy użyciu protokołu OAuth. Interfejsy API są zgodne z konwencjami wytycznych dotyczących interfejsów API REST firmy Microsoft. Większość interfejsów API, które zwracają kolekcje, obsługuje opcje zapytań systemowych OData .

Następne kroki

• Aby dowiedzieć się więcej o łączności urządzeń i sposobie wysyłania komunikatów telemetrycznych do usługi Digital Twins, przeczytaj artykuł Łączność urządzenia usługi Azure Digital Twins i ruch przychodzący telemetrii.

• Aby dowiedzieć się więcej na temat ograniczeń i ograniczeń interfejsu API zarządzania, przeczytaj artykuł Azure Digital Twins API Management and limitations (Zarządzanie interfejsem API usługi Azure Digital Twins i ograniczenia).