Plug-in azure_digital_twins_query_request

Artigo
11/23/2024

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer

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

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

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

Sintaxe

evaluateazure_digital_twins_query_request ( AdtInstanceEndpoint , AdtQuery )

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Digitar	Obrigatória	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 de 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 do Microsoft Entra do usuário que executa a consulta para autenticar. Para executar uma consulta, um usuário deve receber pelo menos a função de 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 Kusto adicionais.

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')

Captura de tela dos gêmeos presentes na instância dos Gêmeos Digitais do Azure.

Projeção de propriedades gêmeas como colunas junto com expressões Kusto adicionais

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

TemperaturaInC	Umidade
21	48
49	34
80	32

Executar análises de séries temporais

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

Compartilhar via