Linguagem de consulta dos Gêmeos Digitais do Azure

Este artigo descreve os conceitos básicos da linguagem de consulta e os recursos dela. Lembre-se de que o centro dos Gêmeos Digitais do Azure é o grafo de gêmeo, baseado em gêmeos e relações digitais. O grafo pode ser consultado para obter informações sobre os Gêmeos Digitais e os relacionamentos que ele contém. Essas consultas são escritas em uma linguagem de consulta do tipo SQL personalizada, chamada de linguagem de consulta dos Gêmeos Digitais do Azure. A linguagem é semelhante à linguagem de consulta do Hub IoT, com muitos recursos comparáveis.

Veja exemplos mais detalhados da sintaxe de consulta e como executar solicitações de consulta em Como consultar o gráfico de gêmeos.

Sobre as consultas

Você pode usar a linguagem de consulta dos Gêmeos Digitais do Azure para recuperar gêmeos digitais de acordo com estas características:

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

Para enviar uma consulta de um aplicativo cliente ao serviço, use a API de Consulta dos Gêmeos Digitais do Azure. É possível usar uma API por meio de um dos SDKs dos Gêmeos Digitais do Azure.

Documentação de referência

A referência de linguagem de consulta pode ser encontrada em Referência, no índice à esquerda, para a documentação dos Gêmeos Digitais do Azure. Você também pode ir diretamente para as seções de referência usando os links abaixo:

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

Considerações sobre consultas

Ao criar consultas para os Gêmeos Digitais do Azure, observe as seguintes considerações:

• Lembre-se da diferenciação de maiúsculas e minúsculas: todas as operações de consulta dos Gêmeos Digitais do Azure diferenciam maiúsculas de minúsculas, portanto, use os nomes exatos definidos. Se houver erros na grafia dos nomes de propriedade, o conjunto de resultados será vazio sem erros retornados.

• Escape as aspas simples: se o texto da consulta incluir um caractere de aspas simples nos dados, a cotação precisará ser substituída pelo caractere \. Veja a seguir um exemplo que lida com o valor de propriedade D'Souza:

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

Observação

Após a realização de uma alteração nos dados do grafo, talvez haja uma latência de até dez segundos antes que as alterações sejam exibidas nas consultas.

A API do DigitalTwins reflete as alterações imediatamente. Portanto, se você precisar de uma resposta instantânea, use uma solicitação de API (DigitalTwins GetById) ou uma chamada de SDK (GetDigitalTwin) para obter dados dos gêmeos em vez de uma consulta.

Consultando dados gêmeos em histórico ao longo do tempo

A linguagem de consulta dos Gêmeos Digitais do Azure é apenas para consultar o estado atual dos gêmeos digitais e relações.

Para executar consultas em dados de grafo gêmeos historizados coletados ao longo do tempo, use o recurso de histórico de dados para conectar sua instância dos Gêmeos Digitais do Azure a um cluster do Azure Data Explorer. Isso historizará automaticamente as atualizações de grafo no Azure Data Explorer, em que elas podem ser consultadas usando o plug-in dos Gêmeos Digitais do Azure para a Data Explorer do Azure.

Próximas etapas

Aprenda a criar consultas e veja exemplos de código de cliente em Como consultar o gráfico de gêmeos.