modul plug-in azure_digital_twins_query_request

Modul azure_digital_twins_query_request plug-in spustí 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 v Azure Digital Twins i v jakémkoli zdroji dat, který je přístupný prostřednictvím KQL. Můžete například provádět analýzu časových řad.

Další informace o modulu plug-in najdete v tématu Modul plug-in dotazů Azure Digital Twins pro Azure Data Explorer.

Syntax

evaluateazure_digital_twins_query_request(AdtInstanceEndpoint,AdtQuery)

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

Parametry

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

Ověřování a autorizace

Modul plug-in azure_digital_twins_query_request k ověření používá účet Microsoft Entra uživatele, který dotaz spouští. Pokud chcete spustit dotaz, musí mít uživatel alespoň udělenou roli Čtenář dat služby Azure Digital Twins . Informace o přiřazení této role 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 Azure Digital Twins

Následující příklad vrátí všechna digitální dvojčata v rámci instance 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

K historizaci aktualizací vlastností digitálního dvojčete můžete použít funkci integrace historie dat služby Azure Digital Twins. Informace o zobrazení aktualizací historizovaného dvojčete najdete v tématu Zobrazení aktualizací historizovaného dvojčete v Azure Data Explorer