Linguagem de consulta dos Gêmeos Digitais do Azure

Este artigo descreve os conceitos básicos da linguagem de consulta e seus recursos. Lembre-se de que o centro dos Gêmeos Digitais do Azure é o gráfico gêmeo, construído a partir de gêmeos digitais e relacionamentos. Este gráfico pode ser consultado para obter informações sobre os gêmeos digitais e relacionamentos que ele contém. Essas consultas são escritas numa linguagem de consulta personalizada do tipo SQL, denominada linguagem de consulta do Azure Digital Twins. Essa linguagem é semelhante à linguagem de consulta do Hub IoT com muitos recursos comparáveis.

Para obter exemplos mais detalhados de sintaxe de consulta e como executar solicitações de consulta, consulte Consultar o gráfico gêmeo.

Sobre as consultas

Você pode usar a linguagem de consulta Gêmeos Digitais do Azure para recuperar gêmeos digitais de acordo com...

• Propriedades (incluindo propriedades de tag)
• Modelos
• Relacionamentos
  • Propriedades das relações

Para enviar uma consulta ao serviço a partir de um aplicativo cliente, você usará a API de Consulta de Gêmeos Digitais do Azure. Uma maneira de usar a API é por meio de um dos SDKs para Gêmeos Digitais do Azure.

Documentação de referência

A referência de linguagem de consulta pode ser encontrada em Referência no sumário esquerdo da 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
  • DE
  • CORRESPONDÊNCIA
  • ADERIR
  • EM QUE
• Funções
• Operadores
• Palavras-chave reservadas

Considerações para consulta

Ao escrever consultas para Gêmeos Digitais do Azure, lembre-se das seguintes considerações:

• Lembre-se da diferenciação de maiúsculas e minúsculas: todas as operações de consulta do Azure Digital Twins diferenciam maiúsculas de minúsculas, portanto, tenha cuidado para usar os nomes exatos definidos nos modelos. Se os nomes de propriedade estiverem com erros ortográficos ou incorretos em maiúsculas, o conjunto de resultados estará vazio sem erros retornados.

• Escape de aspas simples: se o texto da consulta incluir um único caractere de aspas nos dados, a citação precisará ser escapada com o \ caractere. Veja um exemplo que trata do valor de um imóvel de D'Souza:

  SQL

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

• Se você estiver usando a CLI do Azure para executar consultas, talvez seja necessário escapar de certos caracteres adicionais para atender aos requisitos de vários shells. Para obter mais informações, consulte Usar caracteres especiais em diferentes shells

Nota

Depois de fazer uma alteração nos dados do gráfico, pode haver uma latência de até 10 segundos antes que as alterações sejam refletidas 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 SDK (GetDigitalTwin) para obter dados gêmeos em vez de uma consulta.

Consultando dados gêmeos históricos ao longo do tempo

A linguagem de consulta dos Gêmeos Digitais do Azure serve apenas para consultar o estado atual de seus gêmeos digitais e relacionamentos.

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

Próximos passos

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