Szybki start — rozpoczynanie pracy z przykładowym scenariuszem w usłudze Azure Digital Twins Explorer

Ten szybki przewodnik to wprowadzenie do Azure Digital Twins, pokazując, jak Azure Digital Twins reprezentuje dane i jak przebiega interakcja z grafem cyfrowego bliźniaka budynku fizycznego. Używasz witryny Azure Portal i Eksploratora usługi Azure Digital Twins, który jest narzędziem do wizualizacji i interakcji z danymi usługi Azure Digital Twins w przeglądarce internetowej.

W tym szybkim przewodniku zapoznasz się ze wstępnie utworzonymi przykładowymi modelami, które cyfrowo definiują koncepcje budynku, piętra i pomieszczenia, i użyjesz tych definicji modelu, aby utworzyć cyfrowe bliźniaki reprezentujące określone piętra i pokoje w budynku fizycznym. Te pojedyncze bliźniaki są połączone z wirtualnym grafem bliźniaczym, który odzwierciedla ich wzajemne relacje, tworząc pełną cyfrową reprezentację przykładowego budynku. Wykres, z którym pracujesz, reprezentuje budynek, który zawiera dwa piętra, a każde piętro zawiera pokoje. Wykres wygląda następująco:

Poniżej przedstawiono kroki używane do eksplorowania grafu w tym artykule:

1. Utwórz wystąpienie usługi Azure Digital Twins i otwórz je w eksploratorze usługi Azure Digital Twins.
2. Przekaż wstępnie utworzone modele i dane grafu, aby utworzyć przykładowy scenariusz. Dodaj kolejnego bliźniaka ręcznie.
3. Symuluj zmianę danych IoT i wykonaj zapytanie względem grafu, aby wyświetlić wyniki.
4. Zapoznaj się ze swoimi doświadczeniami.

Uwaga

Dla uproszczenia ten szybki przewodnik nie obejmuje konfigurowania przepływu danych na żywo z urządzeń IoT w modelowanym środowisku ani z innych źródeł danych. Aby skonfigurować symulowany pełny przepływ danych, który napędza wykres bliźniaczej reprezentacji, przejdź do samouczków: Łączenie kompleksowego rozwiązania. Aby uzyskać więcej informacji na temat przepływu danych między usługami i integracji usługi Azure Digital Twins z szerszym rozwiązaniem IoT, zobacz Dane przychodzące i wychodzące.

Wymagania wstępne

Do ukończenia tego przewodnika Szybki start potrzebna jest subskrypcja platformy Azure. Jeśli jeszcze go nie masz, utwórz go bezpłatnie .

Musisz również pobrać materiały dla przykładowego grafu używanego w przewodniku Szybki start. Aby pobrać wymagane pliki, wykonaj poniższe instrukcje. Później postępuj zgodnie z kolejnymi instrukcjami, aby przekazać je do usługi Azure Digital Twins.

• Pliki modelu: przejdź do każdego z poniższych linków, kliknij prawym przyciskiem myszy w dowolnym miejscu na ekranie, a następnie wybierz opcję Zapisz jako w menu kontekstowym przeglądarki. Użyj okna Zapisz jako, aby zapisać plik gdzieś na maszynie.

  • Building.json: ten plik modelu cyfrowo definiuje budynek. Określa, że budynki mogą zawierać podłogi.
  • Floor.json: ten plik modelu cyfrowo definiuje podłogę. Określa, że kondygnacje mogą zawierać pokoje.
  • Room.json: ten plik modelu cyfrowo definiuje pomieszczenie. Ma właściwość temperatury.

• buildingScenario.xlsx: Ten arkusz kalkulacyjny zawiera dane dla przykładowego bliźniaczego grafu, w tym pięć cyfrowych bliźniaków reprezentujących konkretny budynek z kondygnacjami i pokojami. Reprezentacje bliźniacze są oparte na modelach ogólnych i połączone relacjami wskazującymi, które elementy zawierają inne. W zależności od ustawień przeglądarki wybranie tego linku może automatycznie pobrać plik buildingScenario.xlsx do domyślnej lokalizacji pobierania lub otworzyć plik w przeglądarce z opcją pobierania. Oto, jak wygląda ta opcja pobierania w przeglądarce Microsoft Edge:

  

Napiwek

Te pliki pochodzą z repozytorium Azure Digital Twins Explorer w usłudze GitHub. Możesz odwiedzić repozytorium dla innych przykładowych plików, kodu eksploratora i nie tylko.

Konfigurowanie usługi Azure Digital Twins

Pierwszym krokiem podczas pracy z usługą Azure Digital Twins jest utworzenie wystąpienia usługi Azure Digital Twins zawierającego wszystkie dane grafu. W tej sekcji utworzysz wystąpienie usługi i otworzysz je w Eksploratorze usługi Azure Digital Twins.

Tworzenie wystąpienia usługi Azure Digital Twins

W tej sekcji utworzysz nowe wystąpienie usługi Azure Digital Twins przy użyciu witryny Azure Portal. Przejdź do portalu i zaloguj się przy użyciu swoich poświadczeń.

1. Po przejściu do portalu zacznij od wybrania pozycji Utwórz zasób w menu strony głównej usług platformy Azure.

   

2. Wyszukaj usługę Azure Digital Twins w polu wyszukiwania i wybierz usługę Azure Digital Twins z wyników.

   W polu Plan pozostaw wartość Azure Digital Twins i wybierz przycisk Utwórz, aby rozpocząć tworzenie nowego wystąpienia usługi.

   

3. Wypełnij pola na karcie Podstawowe ustawienia , w tym subskrypcję, grupę zasobów, nazwę zasobu dla nowego wystąpienia i regionu. Zaznacz pole Przypisywanie roli właściciela danych usługi Azure Digital Twins, aby przyznać sobie uprawnienia do zarządzania danymi w wystąpieniu.

   

   Uwaga

   Jeśli pole Przypisywanie roli właściciela danych usługi Azure Digital Twins jest wyszarzone, oznacza to, że nie masz uprawnień w subskrypcji platformy Azure, aby zarządzać dostępem użytkowników do zasobów. Możesz kontynuować tworzenie wystąpienia w tej sekcji, a następnie ktoś z odpowiednimi uprawnieniami powinien przypisać ci tę rolę w wystąpieniu przed ukończeniem reszty tego przewodnika w ramach szybkiego startu.

   Typowe role spełniające to wymaganie to Właściciel, Administrator konta lub Kombinacja administratorów dostępu użytkowników i Współautor.

4. Wybierz pozycję Przejrzyj i utwórz , aby zakończyć tworzenie wystąpienia.

5. Zostanie wyświetlona strona podsumowania przedstawiająca wprowadzone szczegóły. Potwierdź i utwórz wystąpienie, wybierając pozycję Utwórz.

Ta akcja powoduje przejście do strony Przegląd śledzenia stanu wdrożenia wystąpienia.

Poczekaj, aż na stronie będzie napisane, że wdrożenie zostało ukończone.

Otwórz wystąpienie w eksploratorze usługi Azure Digital Twins

Po zakończeniu wdrażania, użyj przycisku Przejdź do zasobu, aby przejść do strony Przegląd wystąpienia w portalu.

Następnie wybierz przycisk Open Azure Digital Twins Explorer (wersja zapoznawcza).

Ta akcja spowoduje otwarcie Eksploratora usługi Azure Digital Twins na nowej karcie. Jeśli używasz eksploratora po raz pierwszy, zobaczysz modalne podsumowanie jego kluczowych funkcji.

Narzędzie Azure Digital Twins Explorer może automatycznie łączyć się z wystąpieniem. Jeśli nie, zostanie wyświetlony następujący ekran z prośbą o określenie adresu URL usługi Azure Digital Twins. (Jeśli to pole nie jest widoczne na ekranie, Azure Digital Twins Explorer wykonało ten krok automatycznie.)

Jeśli widzisz to pole, wprowadź https:// w polu, a następnie nazwę hosta wystąpienia (tę wartość można znaleźć ponownie na stronie Przegląd wystąpienia w portalu). Te wartości razem tworzą adres URL wystąpienia. Wybierz Zapisz, aby połączyć się z instancją.

Ważne

Eksplorator usługi Azure Digital Twins nie obsługuje prywatnych punktów końcowych. Jeśli chcesz użyć narzędzia Azure Digital Twins Explorer z wystąpieniem usługi Azure Digital Twins, które używa usługi Private Link do wyłączenia dostępu publicznego, możesz wdrożyć bazę kodu usługi Azure Digital Twins Explorer prywatnie w chmurze. Aby uzyskać instrukcje dotyczące tego, jak to zrobić, zobacz Azure Digital Twins Explorer: Running in the cloud (Eksplorator usługi Azure Digital Twins: uruchamianie w chmurze).

Tworzenie przykładowego scenariusza

Następnie użyjesz narzędzia Azure Digital Twins Explorer, aby skonfigurować przykładowe modele i graf bliźniaczych reprezentacji. Najpierw zaimportujesz pliki modelu i plik grafu bliźniaczego, który został pobrany na maszynę w sekcji Wymagania wstępne . Następnie ukończysz scenariusz, tworząc jeszcze jedną reprezentację bliźniaczą ręcznie.

Modele

Pierwszym krokiem tworzenia grafu usługi Azure Digital Twins jest zdefiniowanie słownictwa dla danego środowiska. Modele to definicje ogólne dla każdego typu jednostki, która istnieje w danym środowisku. Ten przykładowy scenariusz budynku zawiera budynek, podłogi i pokoje. W związku z tym potrzebna jest jedna definicja modelu opisująca, czym jest budynek , jedna definicja modelu opisująca, czym jest podłoga , i jedna definicja modelu opisująca, czym jest pokój . Później możesz utworzyć cyfrowe bliźniaki, które będą wystąpieniami tych modeli i będą reprezentować określone budynki, piętra oraz pokoje.

Modele dla usługi Azure Digital Twins są napisane w języku Digital Twin Definition Language (DTDL), języku obiektów danych podobnym do JSON-LD. Każdy model opisuje pojedynczy typ jednostki pod względem jego właściwości, relacji i składników.

Na potrzeby tego przewodnika szybkiego startu pliki modelu zostały dla Ciebie przygotowane. Pobrałeś Building.json, Floor.json i Room.json w sekcji Wymagania wstępne, a teraz przekazujesz je do wystąpienia usługi Azure Digital Twins przy użyciu narzędzia Azure Digital Twins Explorer.

Przekazywanie modeli (.json plików)

W Eksploratorze usługi Azure Digital Twins wykonaj następujące kroki, aby przekazać modele Building, Floor i Room ( pobrane wcześniej pliki .json ).

1. Na panelu Modele wybierz ikonę Przekaż model, która pokazuje strzałkę wskazującą w górę.

   

2. W wyświetlonym oknie Otwórz przejdź do folderu zawierającego pobrane pliki .json na maszynie.

3. Wybierz Building.json, Floor.json i Room.json, a następnie wybierz Otwórz, aby je wszystkie przekazać jednocześnie.

Narzędzie Azure Digital Twins Explorer wgrywa te pliki modelu do instancji Azure Digital Twins. Powinny one być wyświetlane w panelu Modele i wyświetlać przyjazne nazwy i pełne identyfikatory modeli.

Możesz wybrać opcję Wyświetl model z dowolnej opcji modeli, aby wyświetlić kod DTDL definiujący każdy typ modelu.

Bliźniaki i graf bliźniaczy

Teraz, gdy niektóre definicje modeli zostały załadowane do wystąpienia usługi Azure Digital Twins, możesz użyć tych definicji do utworzenia cyfrowych bliźniaków dla elementów w danym środowisku.

Każdy cyfrowy bliźniak w Twoim rozwiązaniu reprezentuje obiekt ze środowiska fizycznego. Można utworzyć wiele reprezentacji bliźniaczych na podstawie tego samego typu modelu, takich jak wiele reprezentacji bliźniaczych pomieszczeń, które używają modelu Pokój . W tym przewodniku Szybki start potrzebujesz cyfrowej reprezentacji bliźniaczej do budynku oraz cyfrowej reprezentacji bliźniaczej dla każdego piętra i pokoju w budynku. Bliźnięta są połączone za pomocą relacji w graf bliźniaczy, który reprezentuje pełne środowisko budynku.

W tej sekcji przekażesz wstępnie utworzony graf zawierający bliźniacze reprezentacje budynku, dwie piętrowe reprezentacje bliźniacze i dwie reprezentacje bliźniacze.

Importowanie grafu (plik .xlsx)

W Eksploratorze usługi Azure Digital Twins wykonaj następujące kroki, aby zaimportować przykładowy graf ( pobrany wcześniej plik .xlsx ).

1. W panelu Twin Graph wybierz ikonę Importuj graf, która pokazuje strzałkę wskazującą chmurę.

   

2. W oknie Otwórz przejdź do pliku buildingScenario.xlsx, który pobrałeś wcześniej. Ten plik zawiera dane dotyczące bliźniąt i relacji dla przykładowego grafu. Wybierz Otwórz.

   Po kilku sekundach eksplorator usługi Azure Digital Twins otwiera widok Importu , który pokazuje podgląd wykresu do załadowania.

3. Aby zakończyć importowanie grafu, wybierz ikonę Zapisz w prawym górnym rogu panelu podglądu grafu.

   

4. Eksplorator usługi Azure Digital Twins używa przekazanego pliku do tworzenia żądanych reprezentacji bliźniaczych i relacji między nimi. Upewnij się, że zostało wyświetlone następujące okno dialogowe wskazujące, że importowanie zakończyło się pomyślnie przed przejściem.

   

   Wybierz Zamknij.

   Graf jest teraz przekazywany do Eksploratora usługi Azure Digital Twins, a panel Twin Graph ładuje się ponownie. To wydaje się puste.

5. Aby wyświetlić wykres, wybierz przycisk Uruchom zapytanie w panelu Eksplorator zapytań, w górnej części okna Eksplorator Azure Digital Twins.

   

To działanie uruchamia zapytanie domyślne, aby wybrać i wyświetlić wszystkie cyfrowe bliźniaki. Przeglądarka Azure Digital Twins pobiera wszystkie bliźniaki i relacje z usługi. Rysuje graf zdefiniowany przez nich na panelu Twin Graph. Teraz możesz zobaczyć załadowany wykres przykładowego scenariusza.

Okręgi, czyli "węzły" w grafie, reprezentują cyfrowe bliźniaki. Linie reprezentują relacje. Bliźniacze reprezentacje BuildingA "zawierają" bliźniacze reprezentacje Floor0 i Floor1, bliźniacza reprezentacja Floor0 "zawiera" Room0, a bliźniacza reprezentacja Floor1 "zawiera" Room1. Jeśli używasz myszy, możesz kliknąć i przeciągnąć na wykresie, aby poruszać się wokół elementów.

Dodaj kolejnego bliźniaka

Po jego utworzeniu można nadal edytować strukturę grafu cyfrowego bliźniaka. Wyobraź sobie, że inny pokój został niedawno zbudowany na piętrze1 tego przykładowego budynku. W tej sekcji do wykresu zostanie dodana nowa reprezentacja bliźniaca reprezentująca nowy pokój.

Zacznij od wybrania modelu definiującego typ bliźniaka, który chcesz utworzyć. W panelu Modele po lewej stronie otwórz menu opcji modelu Pokój. Wybierz Utwórz bliźniaka, aby utworzyć nowe wystąpienie tego typu modelu.

Wprowadź Room2 jako nazwę nowej bliźniaczej i wybierz Zapisz. Ta akcja powoduje utworzenie nowej cyfrowej reprezentacji bliźniaczej, która nie jest jeszcze połączona przez relacje z resztą grafu.

Następnie dodasz relację, aby pokazać, że Floor1 zawiera Pokój2. Użyj CTRL/CMD lub SHIFT, aby jednocześnie wybrać pozycję Floor1 i Room2 na wykresie. Po wybraniu obu bliźniąt kliknij prawym przyciskiem myszy Room2 i wybierz polecenie Dodaj relacje.

Ta akcja powoduje otwarcie okna dialogowego Tworzenie relacji , wstępnie wypełnionego szczegółami relacji "contains" z Floor1 do Room2. Wybierz pozycję Zapisz.

Teraz Room2 jest połączony w grafie. Jeśli używasz myszy, możesz kliknąć i przeciągnąć bliźniaki na wykresie, aby ułożyć je w konfiguracji, która ci odpowiada.

Wyświetl właściwości bliźniacze

Możesz wybrać bliźniętą reprezentację, aby wyświetlić listę jej właściwości i ich wartości w panelu Właściwości bliźniaczej reprezentacji.

Oto właściwości Pokoju0. Zwróć uwagę, że Room0 ma temperaturę 70.

Oto właściwości Pokoju1. Zwróć uwagę, że Room1 ma temperaturę 80.

Room2 nie ma jeszcze ustawionych wartości dla swoich właściwości, ponieważ ten bliźniak cyfrowy został utworzony ręcznie. Aby ustawić wartości właściwości, zmodyfikuj pola tak, aby wilgotność wynosi 50, a temperatura wynosi 72. Wybierz ikonę Zapisz.

Wykonywanie zapytań dotyczących zmiany danych IoT

W rozwiązaniu Azure Digital Twins możesz wysłać zapytanie do grafu bliźniaczych obiektów, aby odpowiedzieć na pytania dotyczące swojego środowiska, używając języka zapytań Azure Digital Twins w stylu SQL. Jednym ze sposobów wykonywania zapytań dotyczących bliźniaków na grafie jest według ich właściwości. Wykonywanie zapytań na podstawie właściwości może pomóc w odpowiadaniu na pytania dotyczące elementów odstających w danym środowisku lub identyfikowaniu wartości odstających. W scenariuszu opartym na danych właściwości bliźniaczych reprezentacji bliźniaczych często zmieniają się w odpowiedzi na dane IoT z czujników w środowisku lub innych połączonych źródeł danych. W tym szybkim przewodniku zmienisz wartości ręcznie, aby zasymulować zmianę odczytu czujnika.

Zacznij od uruchomienia zapytania, aby zobaczyć, ile bliźniaków w Twoim środowisku ma temperaturę powyżej 75 stopni. Uruchom następujące zapytanie w panelu Eksplorator zapytań.

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

Przypomnij sobie z oglądania właściwości bliźniaczych wcześniej, że Room0 ma odczyt temperatury 70, Room1 ma odczyt temperatury 80, a Room2 ma odczyt temperatury 72. Bliźniacze reprezentacje budynku i podłogi nie mają w ogóle właściwości temperatury. Z tych powodów tylko room1 jest wyświetlany w wynikach tutaj.

Napiwek

Inne operatory porównania (<,>, =lub !=) są również obsługiwane w zapytaniach. Możesz spróbować wprowadzić do zapytania te operatory, różne wartości lub różne właściwości, aby wypróbować i odpowiedzieć na własne pytania.

Edytowanie danych temperatury

W w pełni połączonym rozwiązaniu usługi Azure Digital Twins bliźniacze reprezentacje w grafie otrzymują aktualizacje na żywo z rzeczywistych urządzeń IoT i innych źródeł danych oraz automatycznie aktualizują swoje właściwości, by zachować synchronizację ze środowiskiem rzeczywistym. Dla uproszczenia w tym przewodniku Szybki start użyjesz tutaj eksploratora usługi Azure Digital Twins, aby ręcznie ustawić odczyt temperatury dla opcji Room0 na 76.

Najpierw uruchom ponownie następujące zapytanie, aby wybrać wszystkie cyfrowe bliźniaki. Ta akcja ponownie wyświetla pełny wykres w panelu Graf bliźniaczy.

SELECT * FROM DIGITALTWINS

Wybierz Room0, aby wyświetlić listę jego właściwości w panelu Twin Properties.

Zmień wartość temperatury z 70 na 76, a następnie wybierz ikonę Zapisz , aby zaktualizować temperaturę.

Po pomyślnej aktualizacji właściwości zobaczysz pole Informacje o poprawce, które pokazuje kod poprawki użyty w tle za pomocą interfejsów API Azure Digital Twins do dokonania aktualizacji.

Zamknij informacje o poprawce.

Zapytanie w celu wyświetlenia nowego wyniku

Aby zobaczyć nową temperaturę dla room0 odzwierciedlone na wykresie, uruchom ponownie zapytanie z wcześniejszej strony, aby pobrać wszystkie bliźniacze reprezentacje w środowisku z temperaturą powyżej 75.

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

Teraz, gdy temperatura Room0 zmieniła się z 70 na 76, zarówno Room0, jak i Room1 powinny pojawić się w wyniku.

Przeglądaj i umieszczaj w kontekście zdobyte wiedzę

W tym przewodniku szybkiego startu utworzono wystąpienie usługi Azure Digital Twins oraz użyto narzędzia Azure Digital Twins Explorer, aby napełnić je przykładowym scenariuszem. Ręcznie dodałeś również cyfrowego bliźniaka.

Następnie zapoznaliśmy się z wykresem, w tym...

• Używanie zapytania w celu udzielenia odpowiedzi na pytanie dotyczące scenariusza.
• Edytowanie właściwości w cyfrowym bliźniaku.
• Uruchom ponownie zapytanie, aby zobaczyć, jak odpowiedź zmieniła się w wyniku aktualizacji.

Celem tego ćwiczenia jest pokazanie, jak za pomocą grafu usługi Azure Digital Twins odpowiadać na pytania dotyczące środowiska, zwłaszcza gdy środowiska IoT nadal się zmieniają.

W tym szybkim przewodniku startowym wprowadziłeś aktualizację temperatury ręcznie. W Azure Digital Twins powszechnie łączy się cyfrowe bliźniaki z rzeczywistymi urządzeniami IoT, aby automatycznie otrzymywać aktualizacje na podstawie danych urządzenia. Możesz również połączyć inne źródła danych, integrując dane z różnych systemów i definiując własną logikę, jak aktualizować bliźniacze obiekty. W ten sposób można utworzyć graf na żywo, który zawsze odzwierciedla rzeczywisty stan środowiska. Możesz użyć zapytań, aby uzyskać informacje o tym, co dzieje się w środowisku w czasie rzeczywistym.

Możesz również wyeksportować dane usługi Azure Digital Twins do historycznych usług śledzenia, analizy danych i sztucznej inteligencji, aby umożliwić uzyskanie większej analizy i przeprowadzanie symulacji środowiska. Zintegrowanie usługi Azure Digital Twins z rozwiązaniami IoT może pomóc ci efektywniej śledzić przeszłość, kontrolować teraźniejszość i przewidywać przyszłość.

Czyszczenie zasobów

Aby wyczyścić po wykonaniu tego szybkiego startu, wybierz zasoby usługi Azure Digital Twins, które chcesz usunąć, w zależności od tego, co planujesz zrobić dalej.

• Jeśli planujesz kontynuować pracę z przewodnikami szybkiego startu i samouczkami dla usługi Azure Digital Twins, możesz ponownie użyć wystąpienia w tym przewodniku szybkiego startu dla tych artykułów i nie musisz go usuwać.

• Jeśli chcesz kontynuować korzystanie z wystąpienia Azure Digital Twins opisanego w tym artykule, ale chcesz wyczyścić wszystkie jego modele, bliźniaki i relacje, uruchom następujące polecenie CLI: az dt job deletion.

  az dt job deletion create -n <name-of-Azure-Digital-Twins-instance> -y
  

  Jeśli chcesz usunąć tylko niektóre z tych elementów, możesz użyć poleceń az dt twin relationship delete, az dt twin delete i az dt model delete, aby usunąć tylko wybrane elementy.

• Jeśli nie potrzebujesz wystąpienia usługi Azure Digital Twins, możesz je usunąć za pomocą portalu Azure.

  Wróć do strony Przegląd wystąpienia w portalu. (Jeśli zamknięto tę kartę, możesz ponownie znaleźć wystąpienie, wyszukując jego nazwę na pasku wyszukiwania w witrynie Azure Portal i wybierając je z wyników wyszukiwania).

  Wybierz Usuń, aby usunąć wystąpienie, w tym wszystkie jego modele i bliźniaki.

  

Możesz również usunąć przykładowe pliki projektu z komputera lokalnego.

Następne kroki

Przejdź do następnego przewodnika Szybki Start, aby zobrazować scenariusz usługi Azure Digital Twins w środowisku 3D.

Wprowadzenie do programu 3D Scenes Studio

Możesz też przejść do samouczków, aby dokładniej poznać zestawy SDK, tworzenie wykresu bliźniaczego i konfigurację przepływu zdarzeń.

• Kodacja aplikacji klienckiej
• Tworzenie grafu w usłudze Azure Digital Twins
• Łączenie kompleksowego rozwiązania