Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer
O azure_digital_twins_query_request plug-in executa uma consulta do Azure Digital Twins como parte de uma consulta KQL (Kusto Query Language). O plugin é invocado com o operador evaluate.
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 do Azure Digital Twins.
Sintaxe
evaluate
azure_digital_twins_query_request
(
AdtInstanceEndpoint,AdtQuery)
Saiba mais sobre convenções de sintaxe.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| AdtInstanceEndpoint | string |
✔️ | O ponto de extremidade da instância do Azure Digital Twins a ser consultado. |
| AdtQuery | string |
✔️ | A consulta a ser executada no ponto de extremidade do Azure Digital Twins. Essa consulta é escrita em uma linguagem de consulta personalizada semelhante ao SQL para Gêmeos Digitais do Azure, chamada linguagem de consulta 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 de Leitor de Dados do Azure Digital Twins . Informações sobre como atribuir essa função podem ser encontradas em Segurança para soluções de Gêmeos Digitais do Azure.
Exemplos
O exemplo a seguir retorna todos os gêmeos digitais em uma instância de 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')
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
Realização
| TemperaturaInC | Humidade |
|---|---|
| 21 | 48 |
| 49 | 34 |
| 80 | 32 |
Execute análises de séries cronológicas
Você pode usar o recurso de integração do histórico de dados dos Gêmeos Digitais do Azure para historiar atualizações de propriedades de gêmeos digitais. Para saber como visualizar as atualizações gêmeas historizadas, consulte Exibir as atualizações gêmeas historizadas