Plug-in azure_digital_twins_query_request

O azure_digital_twins_query_request plug-in executa uma consulta dos Gêmeos Digitais do Azure como parte de uma consulta de Linguagem de Consulta Kusto (KQL). O plug-in é invocado com o evaluate operador .

Usando o plug-in, você pode consultar os dados nos Gêmeos Digitais do Azure e em qualquer fonte de dados acessível por meio do KQL. Por exemplo, você pode executar a análise de série temporal.

Para obter mais informações sobre o plug-in, consulte Plug-in de consulta dos Gêmeos Digitais do Azure para a Data Explorer do Azure.

Syntax

evaluateazure_digital_twins_query_request(AdtInstanceEndpoint,AdtQuery)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
AdtInstanceEndpoint	string	✔️	O ponto de extremidade da instância dos Gêmeos Digitais do Azure a ser consultado.
AdtQuery	string	✔️	A consulta a ser executada no ponto de extremidade dos Gêmeos Digitais do Azure. Essa consulta é escrita em uma linguagem de consulta personalizada semelhante a SQL para os Gêmeos Digitais do Azure, chamada linguagem de consulta dos Gêmeos Digitais do Azure. Para obter mais informações, consulte Linguagem de consulta para Gêmeos Digitais do Azure.

Autenticação e autorização

O azure_digital_twins_query_request plug-in usa a conta Microsoft Entra do usuário que executa a consulta para autenticar. Para executar uma consulta, um usuário deve pelo menos receber a função leitor de dados dos Gêmeos Digitais do Azure . Informações sobre como atribuir essa função podem ser encontradas em Segurança para soluções dos Gêmeos Digitais do Azure.

Exemplos

Os exemplos a seguir mostram como você pode executar várias consultas dos Gêmeos Digitais do Azure, incluindo consultas que usam expressões Adicionais do Kusto.

Recuperação de todos os gêmeos em uma instância dos Gêmeos Digitais do Azure

O exemplo a seguir retorna todos os gêmeos digitais em uma instância dos Gêmeos Digitais do Azure.

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T AS Twins FROM DIGITALTWINS T')

Projeção de propriedades de gêmeos como colunas, juntamente com expressões Adicionais do Kusto

O exemplo a seguir retorna o resultado do plug-in como colunas separadas e, em seguida, executa operações adicionais usando expressões Kusto.

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T.Temperature, T.Humidity FROM DIGITALTWINS T WHERE IS_PRIMITIVE(T.Temperature) AND IS_PRIMITIVE(T.Humidity)')
| where Temperature > 20
| project TemperatureInC = Temperature, Humidity

Saída

TemperatureInC	Umidade
21	48
49	34
80	32

Executar análise de série temporal

Você pode usar o recurso de integração de histórico de dados dos Gêmeos Digitais do Azure para historizar atualizações de propriedade de gêmeo digital. Para saber como exibir as atualizações de gêmeos historizados, confira Exibir as atualizações de gêmeos historizados no Azure Data Explorer