Lenguaje de consulta de Azure Digital Twins

En este artículo se describen los aspectos básicos del lenguaje de consulta y sus funcionalidades. Recuerde que el centro de Azure Digital Twins es el grafo de gemelos, que se crea partir de gemelos digitales y relaciones. Este grafo se puede consultar para obtener información sobre los gemelos digitales y las relaciones que contiene. Estas consultas se escriben en un lenguaje de consulta personalizado similar a SQL al que se conoce como lenguaje de consulta de Azure Digital Twins. Este lenguaje es similar al lenguaje de consulta de IoT Hub con muchas características comparables.

Puede ver ejemplos más detallados de la sintaxis de consulta y cómo ejecutar solicitudes de consulta en Consulta del grafo gemelo de Azure Digital Twins.

Acerca de las consultas

Puede usar el lenguaje de consulta de Azure Digital Twins para recuperar gemelos digitales según sus...

• Propiedades (incluidas propiedades de etiqueta)
• Modelos
• Relaciones
  • Propiedades de las relaciones

Para enviar una consulta al servicio desde una aplicación cliente, usará la API de consulta de Azure Digital Twins. Una manera de usar la API es a mediante uno de los SDK de Azure Digital Twins.

Documentación de referencia

La referencia del Lenguaje de consulta se puede encontrar debajo de Referencia en el índice de la izquierda de la documentación de Azure Digital Twins. También puede ir directamente a las secciones de referencia mediante los vínculos a continuación:

• Cláusulas
  • SELECT
  • FROM
  • MATCH
  • JOIN
  • WHERE
• Funciones
• Operadores
• Palabras clave reservadas

Consideraciones para la consulta

Al escribir consultas para Azure Digital Twins, tenga en cuenta las consideraciones siguientes:

• Recuerde la distinción entre mayúsculas y minúsculas: todas las operaciones de consulta de Azure Digital Twins distinguen mayúsculas de minúsculas, por lo que debe tener cuidado de usar los nombres exactos definidos en los modelos. Si los nombres de propiedad están mal escritos o usan las mayúsculas de forma incorrecta, el conjunto de resultados está vacío y no se devuelven errores.

• Escape de comillas simples: si el texto de la consulta incluye un carácter de comilla simple en los datos, la comilla tendrá que escaparse con el carácter \. Este es un ejemplo que trata sobre el valor de una propiedad de D'Souza:

  SELECT * FROM DIGITALTWINS WHERE Name = 'D\'Souza'
  

Nota

Después de realizar un cambio en los datos del gráfico, puede haber una latencia de hasta 10 segundos antes de que los cambios se reflejen en las consultas.

La API de DigitalTwins refleja los cambios inmediatamente, por lo que si necesita una respuesta instantánea, use una solicitud de API (DigitalTwins GetById) o una llamada SDK (GetDigitalTwin) para obtener datos gemelos en lugar de una consulta.

Consulta de datos gemelos historizados a lo largo del tiempo

El lenguaje de consulta de Azure Digital Twins es solo para consultar el estado actual de los gemelos digitales y las relaciones.

Para ejecutar consultas en los datos de grafos de gemelos historizados recopilados con el tiempo, use la característica de historial de datos para conectar la instancia de Azure Digital Twins a un clúster de Azure Data Explorer. Esto historizará automáticamente las actualizaciones de grafos en Azure Data Explorer, donde se pueden consultar mediante el complemento Azure Digital Twins para Azure Data Explorer.

Pasos siguientes

Obtenga información sobre cómo escribir consultas y ver ejemplos de código de cliente en Consulta del grafo gemelo de Azure Digital Twins.