modul plug-in azure_digital_twins_query_request

Modul azure_digital_twins_query_request plug-in spouští dotaz Azure Digital Twins jako součást dotazu dotazovací jazyk Kusto (KQL). Modul plug-in se vyvolá pomocí operátoru evaluate .

Pomocí modulu plug-in můžete dotazovat data ve službě Azure Digital Twins i v jakémkoli zdroji dat přístupném prostřednictvím KQL. Můžete například provádět analýzy časových řad.

Další informace o modulu plug-in najdete v tématu Dotazovací modul plug-in Služby Azure Digital Twins pro Azure Data Explorer.

Syntaxe

evaluateazure_digital_twins_query_request ( AdtInstanceEndpoint , AdtQuery )

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název	Type	Požadováno	Popis
AdtInstanceEndpoint	string	✔️	Koncový bod instance služby Azure Digital Twins, který se má dotazovat.
AdtQuery	string	✔️	Dotaz, který se má spustit na koncovém bodu Služby Azure Digital Twins. Tento dotaz je napsaný ve vlastním dotazovacím jazyce podobném SQL pro Azure Digital Twins, kterému se říká dotazovací jazyk Azure Digital Twins. Další informace najdete v tématu Dotazovací jazyk pro Azure Digital Twins.

Ověřování a autorizace

Modul azure_digital_twins_query_request plug-in používá účet Microsoft Entra uživatele, který dotaz spouští k ověření. Pokud chcete spustit dotaz, musí mít uživatel alespoň udělenou roli Čtenář dat Azure Digital Twins. Informace o tom, jak přiřadit tuto roli, najdete v tématu Zabezpečení pro řešení Azure Digital Twins.

Příklady

Následující příklady ukazují, jak můžete spouštět různé dotazy Azure Digital Twins, včetně dotazů, které používají další výrazy Kusto.

Načtení všech dvojčat v instanci Služby Azure Digital Twins

Následující příklad vrátí všechna digitální dvojčata v instanci Azure Digital Twins.

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T AS Twins FROM DIGITALTWINS T')

Projekce vlastností dvojčat jako sloupců spolu s dalšími výrazy Kusto

Následující příklad vrátí výsledek z modulu plug-in jako samostatné sloupce a pak provede další operace pomocí výrazů Kusto.

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T.Temperature, T.Humidity FROM DIGITALTWINS T WHERE IS_PRIMITIVE(T.Temperature) AND IS_PRIMITIVE(T.Humidity)')
| where Temperature > 20
| project TemperatureInC = Temperature, Humidity

Výstup

TemperatureInC	Vlhkost
21	48
49	34
80	32

Provádění analýz časových řad

Pomocí funkce integrace historie dat služby Azure Digital Twins můžete historizovat aktualizace vlastností digitálního dvojčete. Informace o zobrazení aktualizací historizovaných dvojčat najdete v tématu Zobrazení aktualizací historizovaného dvojčete v Azure Data Exploreru.