Vytvořte připojení historie dat pro Azure Digital Twins

Historie dat je funkce Azure Digital Twins pro automatické historizaci aktualizací grafu v Azure Data Exploreru. Tato data se dají dotazovat pomocí modulu plug-in dotazů Azure Digital Twins pro Azure Data Explorer , abyste získali přehled o vašem prostředí v průběhu času.

Tento článek ukazuje, jak nastavit funkční připojení historie dat mezi službou Azure Digital Twins a Azure Data Explorerem. Používá Azure CLI a Azure Portal k nastavení a připojení požadovaných prostředků historie dat, mezi které patří:

• instanci Azure Digital Twins
• Obor názvů Event Hubs obsahující událostní rozbočovač
• Cluster Azure Data Exploreru obsahující databázi

Obsahuje také ukázkový graf dvojčete, který můžete použít k zobrazení aktualizací historizovaných grafů v Azure Data Exploreru.

Návod

I když tento článek používá Azure Portal, můžete také pracovat s historií dat pomocí verze 2022-05-31 rozhraní REST API.

Požadavky

Příprava prostředí pro rozhraní příkazového řádku Azure

• Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Začínáme s Azure Cloud Shellem.

  

• Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Dockeru. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.

  • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených v terminálu. Další možnosti přihlášení najdete v tématu Ověřování v Azure pomocí Azure CLI.

  • Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Použití a správa rozšíření pomocí Azure CLI.

  • Spusťte az version a zjistěte verzi a nainstalované závislé knihovny. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

Poznámka:

Pokud chcete, můžete azure Cloud Shell použít také v prostředí PowerShellu místo prostředí Bash. Příkazy na této stránce jsou napsané pro prostředí Bash, takže můžou vyžadovat několik malých úprav, které se mají spustit v PowerShellu.

Nastavení relace CLI

Abyste mohli začít pracovat se službou Azure Digital Twins v rozhraní příkazového řádku, je nejprve nutné se přihlásit a nastavit kontext rozhraní příkazového řádku podle vašeho předplatného pro aktuální relaci. V okně rozhraní příkazového řádku spusťte tyto příkazy:

az login
az account set --subscription "<your-Azure-subscription-ID>"

Návod

Název předplatného můžete použít také místo ID v předchozím příkazu.

Pokud toto předplatné používáte s Azure Digital Twins poprvé, spusťte následující příkaz a zaregistrujte se v oboru názvů Azure Digital Twins. (Pokud si nejste jistí, můžete ho znovu spustit, i když jste ho někdy spustili v minulosti.)

az provider register --namespace 'Microsoft.DigitalTwins'

Dále přidáte rozšíření Microsoft Azure IoT pro Azure CLI, které povolí příkazy pro interakci se službou Azure Digital Twins a dalšími službami IoT. Spuštěním tohoto příkazu se ujistěte, že máte nejnovější verzi rozšíření:

az extension add --upgrade --name azure-iot

Teď jste připraveni pracovat s Azure Digital Twins v Azure CLI.

Tento stav můžete kdykoli ověřit spuštěním az dt --help a zobrazit seznam dostupných příkazů Služby Azure Digital Twins nejvyšší úrovně.

Nastavení lokálních proměnných pro relaci CLI

Tento článek obsahuje příkazy rozhraní příkazového řádku, které můžete použít k vytvoření prostředků historie dat. Abyste mohli tyto příkazy později snadno zkopírovat a spustit, můžete nyní nastavit místní proměnné v relaci rozhraní příkazového řádku a poté na tyto proměnné při vytváření prostředků v příkazech CLI odkazovat. Pokud chcete vytvořit proměnné, aktualizujte zástupné symboly (identifikované <...> závorkami) v následujících příkazech a spusťte příkazy. Nezapomeňte dodržovat pravidla pojmenování popsaná v komentářích. Tyto hodnoty se později použijí při vytváření nových prostředků.

Poznámka:

Tyto příkazy jsou napsané pro prostředí Bash. Pokud chcete použít prostředí PowerShell CLI, můžete je upravit pro PowerShell.

## General Setup
location="<your-resource-region>"
resourcegroup="<your-resource-group-name>"

## Azure Digital Twins Setup
# Instance name can contain letters, numbers, and hyphens. It must start and end with a letter or number, and be between 4 and 62 characters long.
dtname="<name-for-your-digital-twins-instance>"
# Connection name can contain letters, numbers, and hyphens. It must contain at least one letter, and be between 3 and 50 characters long.
connectionname="<name-for-your-data-history-connection>"

## Event Hub Setup
# Namespace can contain letters, numbers, and hyphens. It must start with a letter, end with a letter or number, and be between 6 and 50 characters long.
eventhubnamespace="<name-for-your-event-hub-namespace>"
# Event hub name can contain only letters, numbers, periods, hyphens and underscores. It must start and end with a letter or number.
eventhub="<name-for-your-event-hub>"

## Azure Data Explorer Setup
# Cluster name can contain only lowercase alphanumeric characters. It must start with a letter, and be between 4 and 22 characters long.
clustername="<name-for-your-cluster>"  
# Database name can contain only alphanumeric, spaces, dash and dot characters, and be up to 260 characters in length.
databasename="<name-for-your-database>"

# Enter a name for the table where relationship create and delete events are stored.
relationshiplifecycletablename="<name-for-your-relationship-lifecycle-events-table>"
# Enter a name for the table where twin create and delete events are stored.
twinlifecycletablename="<name-for-your-twin-lifecycle-events-table>"
# Optionally, enter a custom name for the table where twin property updates are stored. If not provided, the table is named AdtPropertyEvents.
twinpropertytablename="<name-for-your-twin-property-events-table>"

Vytvoření instance Azure Digital Twins se spravovanou identitou

Pokud už máte instanci Služby Azure Digital Twins, ujistěte se, že pro ni povolíte spravovanou identitu přiřazenou systémem .

Pokud nemáte instanci Azure Digital Twins, postupujte podle pokynů v tématu Vytvoření instance se spravovanou identitou a vytvořte instanci Azure Digital Twins s spravovanou identitou přiřazenou systémem poprvé.

Pak se ujistěte, že máte v instanci roli Vlastník dat Služby Azure Digital Twins . Pokyny najdete v tématu Nastavení uživatelských přístupových oprávnění.

Pokud chcete přidat název instance do místních proměnných rozhraní příkazového řádku, abyste ho mohli automaticky připojit k pozdějším příkazům zkopírovaným z tohoto článku, uložte ho do proměnné dtname takto:

dtname="<name-of-your-instance>"

Vytvořte obor názvů služby Event Hubs a centrum událostí

Dalším krokem je vytvoření oboru názvů služby Event Hubs a centra událostí. Tento hub přijímá oznámení o cyklu grafu a aktualizaci vlastností z instance Azure Digital Twins a poté přeposílá zprávy do cílového clusteru Azure Data Explorer.

V rámci nastavení připojení historie dat později udělíte instanci služby Azure Digital Twins roli Vlastník dat služby Azure Event Hubs pro prostředek centra událostí.

Další informace o službě Event Hubs a jejich možnostech najdete v dokumentaci ke službě Event Hubs.

Poznámka:

Při nastavování historie dat musí být v centru událostí povolená místní autorizace. Pokud v centru událostí nakonec chcete mít zakázanou místní autorizaci, zakažte autorizaci po nastavení připojení. Musíte také upravit některá oprávnění popsaná v části Omezení síťového přístupu k prostředkům historie dat dále v tomto článku.

CLI

K vytvoření požadovaných prostředků použijte následující příkazy rozhraní příkazového řádku. Příkazy používají několik místních proměnných ($location, $resourcegroup, $eventhubnamespacea $eventhub) vytvořených dříve v části Nastavení místních proměnných pro relaci rozhraní příkazového řádku.

Vytvořte obor názvů služby Event Hubs:

az eventhubs namespace create --name $eventhubnamespace --resource-group $resourcegroup --location $location

Vytvořte centrum událostí ve vašem jmenném prostoru.

az eventhubs eventhub create --name $eventhub --resource-group $resourcegroup --namespace-name $eventhubnamespace

Portál

Postupujte podle pokynů v tématu Vytvoření centra událostí pomocí webu Azure Portal a vytvořte obor názvů služby Event Hubs a centrum událostí. (Článek obsahuje také pokyny k vytvoření nové skupiny prostředků. Můžete vytvořit novou skupinu prostředků pro prostředky služby Event Hubs nebo tento krok přeskočit a použít existující skupinu prostředků pro nové prostředky služby Event Hubs.)

Názvy, které těmto prostředkům poskytnete, si zapamatujte, abyste je mohli později použít.

Vytvoření clusteru a databáze Kusto (Azure Data Explorer)

Dále vytvořte cluster a databázi Kusto (Azure Data Explorer) pro příjem dat z Azure Digital Twins.

V rámci nastavení připojení historie dat později udělíte instanci Azure Digital Twins roli Přispěvatel alespoň pro databázi (může být také vymezena na cluster) a roli Správce v databázi.

Důležité

Ujistěte se, že je v clusteru povolený přístup k veřejné síti. Pokud má cluster Azure Data Exploreru zakázaný přístup k veřejné síti, Azure Digital Twins nemůže nakonfigurovat tabulky a další požadované artefakty a nastavení historie dat se nezdaří.

CLI

K vytvoření požadovaných prostředků použijte následující příkazy rozhraní příkazového řádku. Příkazy používají několik místních proměnných ($location, $resourcegroup, $clusternamea $databasename) vytvořených dříve v části Nastavení místních proměnných pro relaci rozhraní příkazového řádku.

Začněte tím, že do relace CLI přidáte rozšíření Kusto, pokud ho ještě nemáte.

az extension add --name kusto

Dále vytvořte cluster Kusto. Následující příkaz vyžaduje spuštění 5 až 10 minut a vytvoří cluster E2a v4 na úrovni vývojáře. Tento typ clusteru má jeden uzel pro modul a cluster pro správu dat a je použitelný pro scénáře vývoje a testování. Další informace o úrovních v Azure Data Exploreru a o tom, jak vybrat správné možnosti pro produkční úlohy, najdete v tématu Výběr správné skladové položky výpočetních prostředků pro cluster Azure Data Explorer a ceny Azure Data Exploreru.

az kusto cluster create --cluster-name $clustername --sku name="Dev(No SLA)_Standard_E2a_v4" tier="Basic" --resource-group $resourcegroup --location $location --type SystemAssigned

Vytvořte databázi v novém clusteru Kusto (pomocí dříve zadaného názvu clusteru a ve stejném umístění). Tato databáze slouží k ukládání kontextových dat Azure Digital Twins. Následující příkaz vytvoří databázi s obdobím obnovitelného odstranění 365 dnů a obdobím horké mezipaměti 31 dnů. Další informace o možnostech dostupných pro tento příkaz najdete v tématu az kusto database create.

az kusto database create --cluster-name $clustername --database-name $databasename --resource-group $resourcegroup --read-write-database soft-delete-period=P365D hot-cache-period=P31D location=$location

Portál

Pokud chcete vytvořit cluster Azure Data Exploreru a databázi v clusteru, postupujte podle pokynů v tématu Vytvoření clusteru a databáze Azure Data Exploreru .

Zapamatujte si názvy, které pro tyto prostředky zadáte, abyste je mohli později použít.

Nastavte připojení k historii dat

Teď, když jste vytvořili požadované prostředky, pomocí příkazu v této části vytvořte připojení historie dat mezi instancí služby Azure Digital Twins, centrem událostí a clusterem Azure Data Exploreru.

Tento příkaz také vytvoří ve vaší databázi Azure Data Exploreru tři tabulky pro ukládání aktualizací vlastností dvojčat, událostí životního cyklu relací a událostí životního cyklu dvojčat. Další informace o těchto typech historizovaných dat a jejich odpovídajících tabulkách Azure Data Exploreru najdete v tématu Datové typy a schémata.

CLI

Pomocí příkazu v této části vytvořte připojení k historii dat a tabulky v Azure Data Explorer. Příkaz vždy vytvoří tabulku pro aktualizace vlastností historizovaného dvojčete a obsahuje parametry pro vytvoření tabulek pro životní cyklus relace a události životního cyklu dvojčat.

Poznámka:

Ve výchozím nastavení tento příkaz předpokládá, že všechny prostředky jsou ve stejné skupině prostředků jako instance Azure Digital Twins. Prostředky, které jsou v různých skupinách prostředků, můžete zadat pomocí možností parametrů pro tento příkaz.

Následující příkaz používá místní proměnné, které byly vytvořeny dříve v nastavení místních proměnných pro relaci rozhraní příkazového řádku a má několik parametrů, včetně...

• Názvy tabulek životního cyklu relace a životního cyklu dvojčat v Azure Data Exploreru (tyto parametry jsou volitelné, pokud nechcete historizovat tyto typy událostí, ale vyžaduje se, pokud chcete tyto typy událostí historizovat).
• Volitelný parametr pro zadání názvu tabulky událostí vlastnosti dvojčete (pokud tato hodnota není zadána, tato tabulka má ve výchozím nastavení název AdtPropertyEvents ). Pokud nechcete zadat jiný název, odeberte parametr --adx-property-events-table z příkazu před jeho spuštěním.
• Volitelný parametr --adx-record-removals pro zapnutí historizace pro odstranění vlastností dvojčete (události, které zcela odeberou vlastnosti)

az dt data-history connection create adx --dt-name $dtname --cn $connectionname --adx-cluster-name $clustername --adx-database-name $databasename --eventhub $eventhub --eventhub-namespace $eventhubnamespace --adx-property-events-table $twinpropertytablename --adx-twin-events-table $twinlifecycletablename --adx-relationship-events-table $relationshiplifecycletablename --adx-record-removals true

Při provádění předchozího příkazu máte možnost přiřadit potřebná oprávnění potřebná k nastavení připojení historie dat vaším jménem (pokud jste už přiřadili potřebná oprávnění, můžete tyto výzvy přeskočit). Tato oprávnění jsou udělena spravované identitě vaší instance Služby Azure Digital Twins. Minimální požadované role jsou:

• Vlastník dat služby Azure Event Hubs v centru událostí
• Přispěvatel vymezený alespoň na zadanou databázi (může být také vymezen na cluster)
• Přiřazení hlavního objektu databáze s přiřazenou rolí správce (pro vytvoření nebo správu tabulky) v rámci zadané databáze

U běžné operace roviny dat je možné tyto role v případě potřeby omezit na jednu roli odesílatele dat služby Azure Event Hubs.

Portál

Začněte tím, že přejdete na instanci služby Azure Digital Twins na webu Azure Portal (instanci najdete zadáním jejího názvu do panelu hledání na portálu). Pak proveďte následující kroky.

1. V části Připojit výstupy v nabídce instance vyberte historii dat .

   Vyberte Vytvořit připojení. Tím se zahájí proces připojení historie dat.

2. (NĚKTEŘÍ UŽIVATELÉ) Pokud ještě nemátepro instanci Služby Azure Digital Twins povolenou spravovanou identitu, zobrazí se tato stránka jako první, která vás požádá o zapnutí identity instance jako prvního kroku připojení historie dat.

   

   Pokud už máte spravovanou identitu povolenou, vaše nastavení tento krok přeskočí a hned se zobrazí další stránka.

3. Na stránce Odeslat zadejte podrobnosti o prostředcích služby Event Hubs , které jste vytvořili dříve.

   Vyberte Další.

4. Na stránce Store zadejte podrobnosti o prostředcích Azure Data Exploreru , které jste vytvořili dříve. Můžete zvolit vlastní název tabulky, ve které jsou uloženy aktualizace vlastností dvojčete, nebo ponechat prázdný, pokud chcete použít výchozí název tabulky AdtPropertyEvents, a můžete zvolit, zda mají být odstraněné vlastnosti dvojčete (události, které odeberou vlastnosti zcela) zahrnuty do historizovaných dat. Pokud chcete historizovat životní cyklus relace a události životního cyklu dvojčat, zadejte vlastní názvy těchto tabulek.

   Vyberte Další.

5. Na stránce Oprávnění zaškrtněte všechna políčka a udělte instanci Služby Azure Digital Twins oprávnění pro připojení k prostředkům služby Event Hubs a Azure Data Exploreru. Pokud už máte rovna nebo vyšší oprávnění, můžete tento krok přeskočit.

   Vyberte Další.

6. Na stránce Zkontrolovat a vytvořit zkontrolujte podrobnosti svých prostředků a vyberte Vytvořit připojení.

Po dokončení vytváření připojení se vrátíte na stránku Historie dat pro instanci Azure Digital Twins, která teď zobrazuje podrobnosti o připojení historie dat, které jste vytvořili.

Po nastavení připojení historie dat můžete volitelně odebrat role udělené vaší instanci služby Azure Digital Twins pro přístup k prostředkům služby Event Hubs a Azure Data Exploreru. Aby bylo možné používat historii dat, jedinou rolí, kterou instance potřebuje, je odesílatel dat služby Azure Event Hubs (nebo vyšší role, která zahrnuje tato oprávnění, například vlastník dat služby Azure Event Hubs) u prostředku služby Event Hubs.

Poznámka:

Jakmile je připojení nastavené, výchozí nastavení clusteru Azure Data Exploreru způsobí latenci příjmu dat přibližně 10 minut nebo méně. Tuto latenci můžete snížit povolením příjmu dat ze streamování (méně než 10 sekund latence) nebo politiky dávkování příjmu dat. Další informace o latenci příjmu dat v Azure Data Exploreru najdete v tématu Kompletní latence příjmu dat.

Omezení síťového přístupu k prostředkům historie dat

Pokud chcete omezit síťový přístup k prostředkům, které jsou součástí historie dat (instance služby Azure Digital Twins, centrum událostí nebo cluster Azure Data Explorer), měli byste tato omezení nastavit po nastavení připojení historie dat. Mezi tato omezení patří zakázání místního přístupu k vašim prostředkům, mimo jiné k omezení síťového přístupu.

Aby prostředky historie dat mohly vzájemně komunikovat, měli byste také upravit datové připojení pro databázi Azure Data Exploreru tak, aby používaly spravovanou identitu přiřazenou systémem.

Pokud chcete zajistit správné nastavení připojení k historii dat, pokud vaše prostředky potřebují omezený přístup k síti, proveďte následující kroky v pořadí:

1. Ujistěte se, že je pro prostředky historie dat povolená místní autorizace (instance služby Azure Digital Twins, centrum událostí a cluster Azure Data Exploreru).
2. Vytvořte připojení datové historie
3. Aktualizujte datové připojení pro databázi Azure Data Exploreru tak, aby používala spravovanou identitu přiřazenou systémem. Na webu Azure Portal můžete datové připojení aktualizovat tak, že přejdete do clusteru Azure Data Exploreru a pomocí databází v nabídce přejdete do databáze historie dat. V nabídce databáze vyberte Datová připojení. V položce tabulky pro vaše připojení historie dat by se měla zobrazit možnost Přiřadit spravovanou identitu, kde můžete zvolit Systémově přiřazený.
4. Teď můžete zakázat místní autorizaci nebo nastavit jiná omezení sítě pro požadované prostředky tak, že změníte nastavení přístupu v instanci služby Azure Digital Twins, centru událostí nebo clusteru Azure Data Exploreru.

Řešení potíží s nastavením připojení

Tady je několik běžných chyb, se kterými se můžete setkat při nastavování připojení k historii dat a jak je vyřešit.

• Pokud máte pro svůj cluster Azure Data Explorer zakázaný přístup k veřejné síti, dojde k chybě, že se službě nepodařilo vytvořit připojení historie dat, a zobrazí se zpráva "Prostředek se nepodařilo aktivovat kvůli vnitřní chybě serveru". Nastavení historie dat selže, pokud má cluster Azure Data Explorer zakázaný přístup k veřejné síti, protože Azure Digital Twins nemůže konfigurovat tabulky a další požadované artefakty.
• (uživatelé rozhraní příkazového řádku) Pokud dojde k chybě Nepodařilo se vytvořit připojení instance služby Azure Digital Twins. V databázi se nepodařilo vytvořit tabulku a pravidlo mapování. Zkontrolujte svá oprávnění pro Průzkumník služby Azure Database a spusťte az login, abyste aktualizovali své přihlašovací údaje. Chybu vyřešte tím, že se v clusteru Azure Data Explorer přidáte jako AllDatabasesAdmin pod Oprávnění.
• (Uživatelé Cloud Shellu) Pokud používáte Cloud Shell a narazíte na chybu Nepovedlo se připojit k MSI. Ujistěte se, že je msi správně nakonfigurovaná," zkuste místo toho spustit příkaz s místní instalací Azure CLI.

Ověřte s pomocí ukázkového souměrného grafu

Teď, když je nastavené připojení k historii dat, můžete ho otestovat pomocí dat z digitálních dvojčat.

Pokud už ve své instanci Služby Azure Digital Twins máte dvojčata, která aktivně přijímají aktualizace grafu (včetně aktualizací vlastností dvojčete nebo aktualizací od změny struktury grafu vytvořením nebo odstraněním prvků), můžete tuto část přeskočit a vizualizovat výsledky pomocí vlastních prostředků.

V opačném případě pokračujte v této části a nastavte ukázkový graf, který prochází událostmi životního cyklu dvojčat a vztahů a generuje aktualizace vlastností dvojčete.

Ukázkový graf pro tento scénář můžete nastavit pomocí simulátoru dat Azure Digital Twins. Simulátor dat Azure Digital Twins vytvoří dvojčata a vztahy v instanci služby Azure Digital Twins a neustále zasílá aktualizace vlastností dvojčatům.

Vytvoření ukázkového grafu

Pomocí simulátoru dat Azure Digital Twins můžete zřídit ukázkový graf dvojčete a do něj odeslat aktualizace vlastností. Graf dvojčat vytvořený zde modeluje procesy pasterizace pro mlékárnou společnost.

Začněte otevřením datového simulátoru Azure Digital Twins v prohlížeči. Nastavte tato pole:

• Adresa URL instance: Zadejte název hostitele vaší instance Azure Digital Twins. Název hostitele najdete na portálové stránce pro vaši instanci, a má formát jako .
• Typ simulace: V rozevírací nabídce vyberte mlékárnu.

Vyberte Generovat prostředí.

Na obrazovce se zobrazují potvrzovací zprávy při vytváření modelů, dvojčat a relací ve vašem prostředí. Tento proces také generuje události vytvoření dvojčat a relací, které jsou historizovány do Azure Data Exploreru jako události životního cyklu dvojčat a vztahů.

Jakmile je simulace připravená, povolí se tlačítko Spustit simulaci . Posuňte se dolů a vyberte Spustit simulaci a nasdílejte simulovaná data do instance služby Azure Digital Twins. Pokud chcete nepřetržitě aktualizovat dvojčata v instanci služby Azure Digital Twins, nechte toto okno prohlížeče na popředí na ploše a proveďte další akce prohlížeče v samostatném okně. V tomto okně se průběžně generují události aktualizací vlastností dvojčat, které jsou ukládány jako historická data do Azure Data Exploreru.

Zobrazení historizovaných aktualizací v Azure Data Exploreru

Tato část ukazuje, jak zobrazit všechny tři typy historizovaných aktualizací vygenerovaných simulátorem a uložené v tabulkách Azure Data Exploreru.

Začněte na webu Azure Portal a přejděte do clusteru Azure Data Exploreru, který jste vytvořili dříve. Výběrem podokna Dotaz v části Data v nabídce vlevo otevřete zobrazení dotazu.

Dále rozbalte cluster a databázi v levém podokně a zobrazte název tabulek historie dat. Měly by existovat tři: jedna pro události aktualizace vlastnosti dvojčete, jedna pro události životního cyklu vztahu a jedna pro události životního cyklu dvojčat. Tyto názvy tabulek slouží ke spouštění dotazů na tabulky k ověření a zobrazení historizovaných dat.

Ověření položek tabulky

Pokud chcete ověřit, že události jsou historizovány do databáze, začněte zkopírováním následujícího příkazu. Má zástupný symbol pro název tabulky událostí životního cyklu relace a změní příjem dat tabulky do dávkového režimu , aby ingestoval data z živé simulace každých 10 sekund.

.alter table <relationship-lifecycle-events-table-name> policy ingestionbatching @'{"MaximumBatchingTimeSpan":"00:00:10", "MaximumNumberOfItems": 500, "MaximumRawDataSizeMB": 1024}'

Vložte příkaz do okna dotazu a nahraďte zástupný text názvem tabulky událostí relace. Výběrem tlačítka Spustit spusťte příkaz.

Opakujte tento příkaz ještě dvakrát pomocí názvu tabulky událostí životního cyklu dvojčete a potom aktualizujte tabulku vlastností , aby se aktualizoval režim příjmu dat ostatních tabulek.

Dále do okna dotazu přidejte následující příkazy a spusťte je. Každý příkaz obsahuje zástupný symbol pro název jedné z tabulek a příkazy vypisují počet položek v tabulkách.

Poznámka:

Zobrazení první dávky přijatých dat může trvat až 5 minut.

<twin-property-updates-table-name>
| count

<relationship-lifecycle-events-table-name>
| count

<twin-lifecycle-events-table-name>
| count

Ve výsledcích byste měli vidět, že počet položek v každé tabulce je něco větší než nula, což znamená, že aktualizace vlastností, události životního cyklu relací a životního cyklu dvojčat jsou zaznamenávány do příslušných tabulek.

Prozkoumat tabulku aktualizací vlastností dvojčete

V této části provedete další zkoumání s aktualizovanými daty vlastnosti dvojice, která jsou v tabulce.

Nejprve spuštěním následujícího příkazu zobrazte 100 záznamů v tabulce:

<twin-property-updates-table-name>
| limit 100

Potom spusťte dotaz založený na datech dvojčat, abyste viděli kontextová data časových řad.

Pomocí následujícího dotazu zobrazte odtok všech dvojčat strojů na sůl v ukázkové mlékárně v Oslu. Tento dotaz Kusto používá modul plug-in Azure Digital Twins k výběru dvojčat, která jsou zajímají, připojí tato dvojčata k časovým řadám historie dat v Azure Data Exploreru a pak zobrazí grafy výsledků. Nezapomeňte zástupný text <ADT-instance-host-name> nahradit názvem hostitele vaší instance a zástupný text <table-name> názvem tabulky aktualizací vlastnosti dvojčete.

let ADTendpoint = "https://<ADT-instance-host-name>";
let ADTquery = ```SELECT SALT_MACHINE.$dtId as tid
FROM DIGITALTWINS FACTORY 
JOIN SALT_MACHINE RELATED FACTORY.contains 
WHERE FACTORY.$dtId = 'OsloFactory'
AND IS_OF_MODEL(SALT_MACHINE , 'dtmi:assetGen:SaltMachine;1')```;
evaluate azure_digital_twins_query_request(ADTendpoint, ADTquery)
| extend Id = tostring(tid)
| join kind=inner (<table-name>) on Id
| extend val_double = todouble(Value)
| where Key == "OutFlow"
| render timechart with (ycolumns = val_double)

Výsledky by měly zobrazovat čísla odtoku, která se v průběhu času mění.

Řešit potíže s připojením

Pokud v Azure Data Exploreru nevidíte data, tok dat historizace nefunguje správně. Problém můžete prozkoumat zobrazením oboru názvů služby Event Hubs na webu Azure Portal, který zobrazuje grafy znázorňující tok zpráv do oboru názvů a mimo obor názvů. Toto zobrazení umožňuje ověřit tok příchozích zpráv z Azure Digital Twins i odchozích zpráv do Azure Data Exploreru, abyste mohli zjistit, která část toku nefunguje.

Další kroky

Pokud chcete pokračovat ve zkoumání scénáře mléka, můžete na GitHubu zobrazit další ukázkové dotazy , které ukazují, jak můžete monitorovat výkon operace mléka na základě typu stroje, továrny, technika údržby a různých kombinací těchto parametrů.

Pokud chcete vytvořit řídicí panely Grafana, které vizualizují výkon mléčné operace, přečtěte si téma Vytváření řídicích panelů pomocí azure Digital Twins, Azure Data Exploreru a Grafany.

Další informace o použití modulu plug-in dotazů Azure Digital Twins pro Azure Data Explorer najdete v tématu Dotazování pomocí modulu plug-in Azure Data Explorer a tohoto blogového příspěvku. Další informace o modulu plug-in najdete tady: Dotazování pomocí modulu plug-in Azure Data Explorer.