azure_digital_twins_query_request plugin

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 entre datos tanto en Azure Digital Twins como en 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 para Azure Data Explorer.

Syntax

evaluateazure_digital_twins_query_request(AdtInstanceEndpoint,AdtQuery)

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Tipo	Requerido	Descripción
AdtInstanceEndpoint	string	✔️	Punto de conexión de la 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 personalizado similar a SQL 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 Microsoft Entra del usuario que ejecuta la consulta para autenticarse. Para ejecutar una consulta, se debe conceder al menos al 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 de 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 en Azure Data Explorer