Partilhar via

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 grafo 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 do Azure Digital Twins para recuperar gêmeos digitais de acordo com...

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

Para enviar uma consulta ao serviço a partir de uma aplicação cliente, irá usar a API de Consulta de Gêmeos Digitais do Azure. Uma forma de usar a API é através 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 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:

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 com a capitalização incorreta, o conjunto de resultados estará vazio sem retorno de erros.

  • 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:

    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 historizados 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 arquivará automaticamente as atualizações de gráficos no Azure Data Explorer, onde elas podem ser consultadas usando o plugin Azure Digital Twins 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.