Rychlý Start – začněte s ukázkovým scénářem v Průzkumníkovi digitálních vláken Azure

V tomto rychlém startu prozkoumáte předem sestavený graf digitálních vláken Azure pomocí Průzkumníka digitálních vláken Azure. Tento nástroj umožňuje vizualizovat a pracovat s daty digitálních dat Azure v rámci Azure Portal.

Pomocí digitálních vláken Azure můžete vytvářet a interagovat s živými modely vašich reálných prostředí, která můžou být součástí širších řešení IoT. Nejprve modelujte jednotlivé prvky jako digitální vlákna. Pak je připojíte ke znalostnímu diagramu , který může reagovat na živé události a dotazovat se na informace.

Provedete následující kroky:

  1. Vytvořte instanci digitálních vláken Azure a připojte se k ní v Průzkumníkovi digitálních vláken Azure.
  2. Upload předem sestavené modely a data grafu pro vytvoření ukázkového scénáře.
  3. Prozkoumejte graf scénáře, který se vytvoří.
  4. Proveďte změny v grafu.
  5. Projděte si kurzy z prostředí.

Příkladem grafu digitálních vláken Azure, který budete pracovat, je sestavení se dvěma podlahami a dvěma místnosti. Floor0 obsahuje Room0 a Floor1 obsahuje Room1. Graf bude vypadat jako tento obrázek:

Snímek obrazovky grafu se čtyřmi kruhovými uzly, které jsou připojeny šipkami v Průzkumníkovi digitálních vláken Azure

Poznámka

Tento rychlý Start vám pomůže prozkoumat předem sestavený graf, který vám pomůže pochopit, jak digitální vlákna Azure představuje data. V zájmu jednoduchosti rychlý Start nepokrývá nastavení připojení mezi IoT Hubmi zařízeními a jejich reprezentacemi v grafu. pokud chcete pro graf nastavit připojený kompletní tok, přejděte dopředu k kurzům: Připojení kompletní řešení.

Požadavky

K dokončení tohoto rychlého startu budete potřebovat předplatné Azure. Pokud ho ještě nemáte, vytvořte si ho zdarma hned teď.

Budete také muset stáhnout materiály pro vzorový graf použitý v rychlém startu. pomocí odkazů a pokynů níže si stáhněte tři požadované soubory z úložiště digital--explorer GitHub. Později budete postupovat podle dalších pokynů, abyste je nahráli do digitálních vláken Azure.

  • Room. JSON: Jedná se o soubor modelu představující místnost v budově. Přejděte na odkaz, klikněte pravým tlačítkem myši kamkoli na obrazovku a vyberte Uložit jako v místní nabídce prohlížeče. Pomocí následujícího okna Uložit jako uložte soubor někam do počítače s názvem Room. JSON.

  • Floor. JSON: Jedná se o modelový soubor, který představuje podlahovou základnu v budově. Přejděte na odkaz, klikněte pravým tlačítkem myši kamkoli na obrazovku a vyberte Uložit jako v místní nabídce prohlížeče. Pomocí následujícího okna Uložit jako uložte soubor do stejného umístění jako soubor Room. JSON pod názvem Floor. JSON.

  • buildingScenario.xlsx: Tento soubor obsahuje graf vláken místností a podlahového vlákna a vztahy mezi nimi. Přejděte na odkaz a vyberte tlačítko Stáhnout . Tím se stáhne soubor do výchozího umístění pro stahování.

    Snímek obrazovky souboru Digital-revlákened-Explorer/Client/Examples/buildingScenario.xlsx v GitHub. Je zvýrazněno tlačítko Stáhnout.

Nastavení Azure Digital Twins

Prvním krokem při práci se službou Azure Digital proworking je vytvoření instance digitálních vláken Azure. Po vytvoření instance služby se můžete připojit k instanci v Průzkumníkovi digitálních vláken Azure, kterou použijete pro práci s instancí v celém rychlém startu.

Zbytek této části vás provede následujícími kroky.

Vytvoření instance služby Azure Digital Twins

V této části vytvoříte novou instanci digitálních vláken Azure pomocí Azure Portal. Přejděte na portál a přihlaste se pomocí svých přihlašovacích údajů.

  1. Na portálu Začněte výběrem možnosti vytvořit prostředek v nabídce domovské stránky služeb Azure.

    Snímek obrazovky Azure Portal zvýrazněte ikonu vytvořit prostředek z domovské stránky.

  2. Ve vyhledávacím poli vyhledejte digitální vlákna Azure a z výsledků vyberte službu Azure Digital . Kliknutím na tlačítko vytvořit vytvořte novou instanci služby.

    Snímek obrazovky s Azure Portalem – zvýrazní se tlačítko vytvořit ze stránky služby digitálního vyzdvojení Azure.

  1. Vyplňte pole na kartě základy instalačního programu, včetně vašeho předplatného, skupiny prostředků, umístění a názvu prostředku pro novou instanci. Zaškrtněte pole přiřadit roli vlastníka dat digitálních vláken Azure , abyste měli oprávnění ke správě dat v instanci.

    Poznámka

    Pokud je pole přiřadit roli vlastníka dat digitálních vláken Azure šedé, znamená to, že nemáte oprávnění ve vašem předplatném Azure ke správě přístupu uživatelů k prostředkům. V této části můžete pokračovat v vytváření instance a pak by měl mít někdo s potřebnými oprávněními přiřadit tuto roli na instanci před dokončením zbývající části tohoto rychlého startu.

    Mezi běžné role, které splňují tento požadavek, patří vlastník, účet správce nebo kombinace správce a přispěvatele přístupu uživatele .

  2. Pokud chcete dokončit vytváření instance, vyberte zkontrolovat + vytvořit .

    Snímek obrazovky procesu vytváření zdrojů pro digitální vlákna Azure v Azure Portal. Popsané hodnoty jsou vyplněny.

  3. Zobrazí se stránka Souhrn zobrazující podrobnosti, které jste zadali. Potvrďte a vytvořte instanci výběrem možnosti vytvořit.

Tím přejdete na stránku Přehled stavu nasazení v instanci.

Otevřít instanci v Průzkumníkovi digitálních vláken Azure

Po dokončení nasazení instance použijte tlačítko Přejít k prostředku a přejděte na stránku Přehled instance na portálu.

Snímek stránky nasazení pro digitální vlákna Azure v Azure Portal. Na stránce je uvedeno, že nasazení bylo dokončeno.

Pak vyberte tlačítko otevřít Průzkumníka digitálních vláken Azure (Preview) .

Snímek obrazovky Azure Portal zobrazující stránku s přehledem instance digitálních vláken Azure Existuje zvýraznění kolem otevřeného tlačítka Průzkumníka digitálních vláken Azure (Preview).

Otevře se okno Průzkumníka digitálních vláken Azure, které je připojené k vaší instanci.

Snímek obrazovky s Průzkumníkem digitálních vláken Azure v internetovém prohlížeči.

Upload ukázkových materiálech

V dalším kroku naimportujete ukázkové modely a graf do Průzkumníka digitálních vláken Azure. Použijete soubory modelů a soubor grafu, který jste stáhli do počítače v části požadavky .

Modely

Prvním krokem v řešení digitálních vláken Azure je definování slovníku pro vaše prostředí. Vytvoříte vlastní modely , které popisují typy entit, které ve vašem prostředí existují.

Každý model je napsán v jazyce, jako je JSON-LD, označovaný jako Digital DTDL Definition Language (). Každý model popisuje jeden typ entity z pohledu jeho vlastností, telemetrie, vztahů a komponent. Později tyto modely použijete jako základ pro digitální vlákna, které představuje konkrétní instance těchto typů.

Obvykle při vytváření modelu dokončíte tři kroky:

  1. Napište definici modelu. V rychlém startu je tento krok již proveden jako součást ukázkového řešení.
  2. Ověřte ho a ujistěte se, že je syntaxe přesná. V rychlém startu je tento krok již proveden jako součást ukázkového řešení.
  3. Upload do instance digitálního vlákna Azure.

Pro tento rychlý Start jsou soubory modelů již zapsány a ověřovány. Ty jsou součástí řešení, které jste stáhli. V této části nahrajete do své instance dva předpsané modely, abyste definovali tyto komponenty stavebního prostředí:

  • Floor
  • Prostor

Upload modelů (soubory. json)

Pomocí těchto kroků nahrajte modely (soubory . JSON , které jste stáhli dříve).

  1. na panelu modely vyberte Upload ikonu modelu , která zobrazuje šipku ukazující na cloud.

    snímek obrazovky průzkumníka digitálních vláken Azure, který zvýrazní panel modely a v něm ikonu Upload Model

  2. V otevřeném okně, které se zobrazí, přejděte do složky obsahující soubory Room. JSON a Floor. JSON , které jste stáhli dříve.

  3. Vyberte Room. JSON a Floor. JSON a vyberte otevřít a nahrajte je.

Průzkumník digitálních vláken Azure odešle tyto soubory modelu do instance digitálního vlákna Azure. Měly by se zobrazit na panelu modely a zobrazovat jejich popisné názvy a úplná ID modelu. Můžete vybrat ikony Zobrazit informace o modelu , abyste si zobrazili kód DTDL za nimi.

Vlákna a Dvojitá graf

Teď, když se některé modely nahrály do instance digitálního vlákna Azure, můžete přidat digitální vlákna , která následují za definicemi modelu.

Digitální vlákna reprezentují skutečné entity v rámci vašeho podnikového prostředí. Můžou to být věci, jako jsou senzory ve farmě, světla v kleci nebo – v tomto rychlém startu – místnosti v rámci stavebních prostorů. Můžete vytvořit mnoho vláken libovolného typu daného modelu, například více místností, které používají model Room. Připojíte je s relacemi do vlákna , které představuje celé prostředí.

V této části nahrajete předem vytvořené vlákna, které jsou připojené do předem vytvořeného grafu. Graf obsahuje dvě podlahová a dvě místnosti připojená v následujícím rozložení:

  • Floor0
    • Obsahuje Room0
  • Floor1
    • Obsahuje Room1

Import grafu (.xlsx souboru)

Pomocí následujícího postupu naimportujte graf ( .xlsx soubor, který jste stáhli dříve).

  1. na panelu s dvojitým Graph vyberte ikonu importovat Graph , která zobrazuje šipku ukazující na cloud.

    snímek obrazovky s průzkumníkem digitálních vláken Azure, na které se zobrazuje panel zobrazení Graph, se zvýrazněnou ikonou Import Graph

  2. V otevřeném okně přejděte do souboru buildingScenario.xlsx , který jste dříve stáhli. Tento soubor obsahuje popis ukázkového grafu. Vyberte Otevřít.

    Po několika sekundách Průzkumník digitálních vláken Azure otevře zobrazení importu , ve kterém se zobrazí náhled grafu, který se má načíst.

  3. Pokud chcete potvrdit nahrávání grafu, vyberte ikonu Uložit v pravém horním rohu panelu náhledu grafu.

    snímek obrazovky průzkumníka digitálních vláken Azure se zvýrazněnou ikonou uložit v podokně náhledu Graph.

  4. Průzkumník digitálních vláken Azure pomocí nahraného souboru vytvoří požadované zdvojení a vztahy mezi nimi. Po dokončení se zobrazí dialogové okno. Vyberte Zavřít.

  5. Graf se teď nahrál do Průzkumníka digitálních vláken Azure. přepněte zpátky na panel s dvojitým Graph .

    snímek obrazovky průzkumníka digitálních vláken Azure se zvýrazněnou kartou s dvojitou Graphou.

  6. Graf zobrazíte tak, že na panelu Průzkumník dotazů v horní části okna Průzkumníka digitálních vláken Azure vyberete tlačítko Spustit dotaz .

    Snímek obrazovky Průzkumníka digitálních vláken Azure se zvýrazněným tlačítkem spustit dotaz v pravém horním rohu okna

Tato akce spustí výchozí dotaz pro výběr a zobrazení všech digitálních vláken. Průzkumník digitálních vláken Azure načítá všechny vlákna a vztahy ze služby. nakreslí graf definovaný v nich na panelu Graph s dvojitou polohou.

Prozkoumat graf

Teď si můžete prohlédnout nahraný graf ukázkového scénáře.

snímek obrazovky s průzkumníkem digitálních vláken Azure zobrazující panel zobrazení Graph s dvojitým grafem v.

Kruhy (grafy "uzly") reprezentují digitální vlákna. Řádky prezentují relace. Floor0 se nevlákenně obsahuje Room0 a vlákna Floor1 obsahuje Room1.

Pokud používáte myš, můžete přetáhnout části grafu, abyste je mohli přesunout.

Zobrazit zdvojené vlastnosti

Můžete vybrat dvojitou hodnotu pro zobrazení seznamu vlastností a jejich hodnot na panelu vlastnosti .

Tady jsou vlastnosti Room0:

Room0 má teplotu 70.

Tady jsou vlastnosti Room1:

Room1 má teplotu 80.

Dotazování grafu

Hlavní funkcí digitálních vláken Azure je schopnost snadno a efektivně dotazovat se na váš graf, aby odpovídal na dotazy týkající se vašeho prostředí.

Jedním ze způsobů, jak zadat dotaz na vlákna v grafu, je podle jejich vlastností. Dotazování na základě vlastností může přispět k zodpovězení nejrůznějších otázek. Můžete například najít mimo jiné vaše prostředí, které může vyžadovat pozornost.

V této části spustíte dotaz, který odpoví na otázku, kolik vláken ve vašem prostředí má teplotu vyšší než 75.

Chcete-li zobrazit odpověď, spusťte následující dotaz na panelu Průzkumník dotazů .

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

Odvolání ze zobrazení vlastností s dvojitou platností dříve, než Room0 má teplotu 70 a Room1 má teplotu 80. Z tohoto důvodu se tady zobrazí jenom Room1.

Snímek obrazovky s Průzkumníkem digitálních vláken Azure zobrazující výsledky dotazu na vlastnost, který zobrazuje pouze Room1.

Tip

Jiné operátory porovnání (<, >, = nebo! =) jsou také podporovány v rámci předchozího dotazu. Můžete zkusit zapojit tyto operátory, jiné hodnoty nebo jiné vlastnosti do dotazu, abyste si vyzkoušeli odpovědi na vlastní otázky.

Úprava dat v grafu

Pomocí Průzkumníka digitálních vláken Azure můžete upravit vlastnosti vláken reprezentovaných v grafu. V této části zvýšíme teplotu Room0 až 76.

Začněte tak, že znovu spustíte následující dotaz a vyberete všechny digitální vlákna. tím se zobrazí celý graf, a to ještě jednou na panelu Graph .

SELECT * FROM DIGITALTWINS

Vyberte Room0 a zobrazte tak seznam vlastností na panelu vlastnosti .

Vlastnosti v tomto seznamu lze upravovat. Vyberte hodnotu teploty 70 a povolte tak zadání nové hodnoty. Zadejte 76 a výběrem ikony Uložit aktualizujte teplotu na 76.

Teď se zobrazí okno s informacemi o opravě , kde se zobrazí kód opravy, který se použil na pozadí s rozhraními API pro digitální vlákna Azure, aby se aktualizace provedla. Vyberte Zavřít.

Dotaz pro zobrazení výsledku

Chcete-li ověřit, že se v grafu úspěšně zaregistrovala vaše aktualizace na teplotu pro Room0, znovu spusťte dotaz ze starší verze, abyste získali všechny vlákna v prostředí s teplotou vyšší než 75.

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

Teď, když se teplota Room0 změnila z 70 na 76, ve výsledku by se měla zobrazit obě vlákna.

Snímek obrazovky s Průzkumníkem digitálních vláken Azure zobrazující výsledky dotazu na vlastnost, který zobrazuje jak Room0, tak Room1.

Recenze a dát učení

V tomto rychlém startu jste vytvořili instanci digitálních vláken Azure a použili Průzkumníka digitálních vláken Azure k naplnění ukázkového scénáře.

Pak jste prozkoumali graf podle:

  • Použití dotazu k zodpovězení otázky týkající se scénáře.
  • Úprava vlastnosti u digitálního vlákna.
  • Spusťte dotaz znovu, abyste viděli, jak se odpověď změnila v důsledku aktualizace.

Účelem tohoto cvičení je Ukázat, jak můžete pomocí grafu digitálních vláken Azure zodpovědět otázky týkající se vašeho prostředí, i když se prostředí stále mění.

V tomto rychlém startu jste provedli aktualizaci teploty ručně. Je běžné, že v digitálních prostředcích Azure propojí digitální vlákna se skutečnými zařízeními IoT, aby se aktualizace automaticky přijímaly na základě dat telemetrie. Tímto způsobem můžete vytvořit živý graf, který vždy odráží skutečný stav vašeho prostředí. Dotazy můžete použít k získání informací o tom, co se ve vašem prostředí děje v reálném čase.

Vyčištění prostředků

Pokud chcete po tomto rychlém startu vyčistit, vyberte prostředky, které chcete odebrat, podle toho, co chcete udělat dál.

  • Pokud máte v úmyslu pokračovat na kurzy digitálních vláken Azure, můžete tuto instanci v tomto rychlém startu znovu použít pro tyto články a nemusíte ji odebrat.
  • Pokud chcete pokračovat v používání instance digitálních vazeb Azure, kterou jste nastavili v tomto článku, ale vymažete některé nebo všechny jeho modely, vlákna a relace, můžete k odstranění prvků, které chcete odebrat, použít příkazy AZ dt CLI v Azure Cloud Shellm okně.
  • Pokud nepotřebujete žádné prostředky, které jste vytvořili v tomto kurzu, můžete odstranit instanci digitálních vláken Azure a všechny další prostředky z tohoto článku pomocí příkazu AZ Group Delete . Tím se odstraní všechny prostředky Azure ve skupině prostředků i v samotné skupině prostředků.

    Důležité

    Odstranění skupiny prostředků je nevratné. Skupina prostředků i všechny prostředky v ní obsažené se trvale odstraní. Ujistěte se, že nechtěně neodstraníte nesprávnou skupinu prostředků nebo prostředky.

    Otevřete Azure Cloud Shella spuštěním následujícího příkazu odstraňte skupinu prostředků a vše, co obsahuje.

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

Je také možné, že budete chtít odstranit ukázkovou složku projektu z místního počítače.

Další kroky

Dál se můžete podívat na kurzy digitálních vláken Azure a vytvořit vlastní scénář a nástroje pro interakci s digitálními scénáři Azure.