azure_digital_twins_query_request plugin
Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer
El azure_digital_twins_query_request complemento ejecuta una consulta de Azure Digital Twins como parte de una consulta de Lenguaje de consulta Kusto (KQL). El complemento se invoca con el evaluate operador .
Con el complemento, puede consultar los datos de Azure Digital Twins y cualquier origen de datos accesible a través de KQL. Por ejemplo, puede realizar análisis de series temporales.
Para más información sobre el complemento, consulte Complemento de consulta de Azure Digital Twins.
Sintaxis
evaluateazure_digital_twins_query_request ( AdtInstanceEndpoint , AdtQuery )
Obtenga más información sobre las convenciones de sintaxis.
Parámetros
| Nombre | Type | Obligatorio | Descripción |
|---|---|---|---|
| AdtInstanceEndpoint | string |
✔️ | Punto de conexión de instancia de Azure Digital Twins que se va a consultar. |
| AdtQuery | string |
✔️ | Consulta que se va a ejecutar en el punto de conexión de Azure Digital Twins. Esta consulta se escribe en un lenguaje de consulta similar a SQL personalizado para Azure Digital Twins, denominado lenguaje de consulta de Azure Digital Twins. Para más información, consulte Lenguaje de consulta para Azure Digital Twins. |
Autenticación y autorización
El azure_digital_twins_query_request complemento usa la cuenta de Microsoft Entra del usuario que ejecuta la consulta para autenticarse. Para ejecutar una consulta, se debe conceder al menos a un usuario el rol Lector de datos de Azure Digital Twins. Encontrará información sobre cómo asignar este rol en Seguridad para las soluciones de Azure Digital Twins.
Ejemplos
En los ejemplos siguientes se muestra cómo puede ejecutar varias consultas de Azure Digital Twins, incluidas las consultas que usan expresiones de Kusto adicionales.
Recuperación de todos los gemelos dentro de una instancia de Azure Digital Twins
En el ejemplo siguiente se devuelven todos los gemelos digitales dentro de una instancia de Azure Digital Twins.
evaluate azure_digital_twins_query_request(
'https://contoso.api.wcus.digitaltwins.azure.net',
'SELECT T AS Twins FROM DIGITALTWINS T')
Proyección de propiedades gemelas como columnas junto con expresiones de Kusto adicionales
En el ejemplo siguiente se devuelve el resultado del complemento como columnas independientes y, a continuación, se realizan operaciones adicionales mediante expresiones 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
Salida
| TemperatureInC | Humedad |
|---|---|
| 21 | 48 |
| 49 | 34 |
| 80 | 32 |
Realización de análisis de series temporales
Puede usar la característica de integración del historial de datos de Azure Digital Twins para historizar las actualizaciones de propiedades del gemelo digital. Para obtener información sobre cómo ver las actualizaciones de gemelos historizados, consulte Visualización de las actualizaciones de gemelos historizados.