modul plug-in azure_digital_twins_query_request
Platí pro: ✅Microsoft Fabric✅Azure Data Explorer
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 modulu plug-in dotazů služby Azure Digital Twins.
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ého dvojčete najdete v tématu Zobrazení aktualizací historizovaného dvojčete.