Linguagem de consulta do Azure Digital Twins

Este artigo descreve as noções básicas da linguagem de consulta e as respetivas capacidades. Lembre-se de que o centro do Azure Digital Twins é o grafo duplo, construído a partir de duplos digitais e relações. Este gráfico pode ser consultado para obter informações sobre os duplos digitais e as relações que contém. Essas consultas são escritas numa linguagem de consulta personalizada do tipo SQL, denominada linguagem de consulta do Azure Digital Twins. Este idioma é semelhante à linguagem de consulta Hub IoT com muitas funcionalidades comparáveis.

Para obter exemplos mais detalhados de sintaxe de consulta e como executar pedidos de consulta, veja Consultar o gráfico duplo.

Acerca das consultas

Pode utilizar a linguagem de consulta do Azure Digital Twins para obter duplos digitais de acordo com os respetivos...

• Propriedades (incluindo propriedades de etiquetas)
• Modelos
• Relações
  • Propriedades das relações

Para submeter uma consulta ao serviço a partir de uma aplicação cliente, irá utilizar a API de Consulta do Azure Digital Twins. Uma forma de utilizar a API é através de um dos SDKs do Azure Digital Twins.

Documentação de referência

A referência da linguagem de consulta pode ser encontrada em Referência no índice esquerdo da documentação do Azure Digital Twins. Também pode aceder diretamente às secções de referência com as ligações abaixo:

• Cláusulas
  • SELECT
  • FROM
  • CORRESP
  • PARTICIPAR
  • WHERE
• Funções
• Operadores
• Palavras-chave reservadas

Considerações para a consulta

Ao escrever consultas para o Azure Digital Twins, tenha em atenção as seguintes considerações:

• Memorizar sensibilidade a maiúsculas e minúsculas: todas as operações de consulta do Azure Digital Twins são sensíveis a maiúsculas e minúsculas, pelo que tenha cuidado ao utilizar os nomes exatos definidos nos modelos. Se os nomes das propriedades estiverem mal escritos ou estiverem incorretamente maiúsculas e minúsculas, o conjunto de resultados estará vazio sem erros devolvidos.

• Escape aspas individuais: se o texto da consulta incluir um único caráter de aspas nos dados, a aspa terá de ser escapada com o \ caráter. Eis um exemplo que lida com um valor de propriedade de D'Souza:

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

Nota

Depois de efetuar uma alteração aos dados no gráfico, poderá existir uma latência de até 10 segundos antes de as alterações serem refletidas nas consultas.

A API DigitalTwins reflete imediatamente as alterações, por isso, se precisar de uma resposta instantânea, utilize um pedido de API (DigitalTwins GetById) ou uma chamada SDK (GetDigitalTwin) para obter dados duplos em vez de uma consulta.

Consultar dados duplos historizados ao longo do tempo

A linguagem de consulta do Azure Digital Twins é apenas para consultar o estado atual dos seus duplos digitais e relações.

Para executar consultas em dados duplos digitais historizados recolhidos ao longo do tempo, utilize a funcionalidade de histórico de dados para ligar a instância do Azure Digital Twins a um cluster do Azure Data Explorer. Isto irá criar automaticamente atualizações de propriedades de duplos digitais para o Azure Data Explorer, onde podem ser consultadas com o plug-in do Azure Digital Twins para o Azure Data Explorer.

Passos seguintes

Saiba como escrever consultas e ver exemplos de código de cliente em Consultar o gráfico duplo.