Conector do Azure Data Explorer para a MicrosoftPower Automate

Importante

Este conector pode ser utilizado na Análise em Tempo Real no Microsoft Fabric. Utilize as instruções neste artigo com as seguintes exceções:

• Se necessário, crie bases de dados com as instruções em Criar uma base de dados KQL.
• Se necessário, crie tabelas com as instruções em Criar uma tabela vazia.
• Obtenha URIs de consulta ou ingestão com as instruções em Copiar URI.
• Executar consultas num conjunto de consultas KQL.

O conector do Azure Data Explorer para Power Automate (anteriormente Microsoft Flow) permite-lhe orquestrar e agendar fluxos, enviar notificações e alertas, como parte de uma tarefa agendada ou acionada.

Pode:

• Envie notificações e alertas com base nos resultados da consulta, como quando os limiares excedem determinados limites.
• Enviar relatórios regulares, como diários ou semanais, que contêm tabelas e gráficos.
• Agendar tarefas regulares com comandos de gestão em clusters. Por exemplo, copie dados de uma tabela para outra com o .set-or-append comando .
• Exportar e importar dados entre o Azure Data Explorer e outras bases de dados.

Para obter mais informações, veja Exemplos de utilização do conector do Azure Data ExplorerPower Automate.

Nota

Para que um Power Automate conector aceda a um cluster protegido por rede, tem de adicionar os endereços IP de saída associados à região do conector à lista de permissões da firewall. Para obter mais informações, veja Manage public access to your Azure Data Explorer cluster (Gerir o acesso público ao cluster do Azure Data Explorer).

Criar um novo fluxo com o conector do Azure Data Explorer

Para utilizar o conector, primeiro tem de adicionar um acionador. Pode definir um acionador com base num período de tempo periódico ou como resposta a uma ação de fluxo anterior.

1. Inicie sessão em Power Automate.

2. Crie um novo fluxo ou, na Power Automate home page, selecione o fluxo Os meus fluxos>+ Novo.

   

3. Selecione Fluxo de cloud agendado.

   

4. Em Criar um fluxo de cloud agendado, introduza as informações necessárias.

   

5. Selecione Criar>+ Novo passo.

6. Na caixa de pesquisa, introduza Kusto ou Azure Data Explorer e selecione Azure Data Explorer.

   

7. Selecione uma ação na lista. Para obter uma explicação de cada ação e como configurá-las, veja Ações do Flow.

   Importante

   Tem de ter uma ligação do Azure Data Explorer válida para que o fluxo seja executado. Para obter informações sobre como criar uma ligação, veja Create an Azure Data Explorer connection in Power Automate.

   

Ações de fluxo

Quando seleciona o conector do Azure Data Explorer, pode escolher uma das seguintes ações para adicionar ao fluxo:

• Executar consulta KQL
• Executar uma consulta KQL e compor um gráfico
• Executar comando de gestão assíncrona
• Executar o comando de gestão e compor um gráfico
• Executar comando de gestão de apresentação

Esta secção descreve as capacidades e parâmetros de cada ação e fornece um exemplo que mostra como adicionar uma ação de e-mail a qualquer fluxo.

Executar consulta KQL

Nota

Se a consulta começar com um ponto, é um comando de gestão. Utilize o comando Executar gestão assíncrona.

Utilize esta ação para consultar o cluster especificado. As ações que são adicionadas posteriormente iteram sobre cada linha dos resultados da consulta.

Se a execução da consulta demorar mais de 8 minutos, falhará com uma exceção "RequestTimeout". Para evitar este problema, otimize a consulta ou divida-a em partes mais pequenas. Para obter mais informações, veja Melhores práticas de consulta.

Exemplo

O fluxo seguinte aciona uma consulta a cada minuto. A consulta verifica o número de registos na tabela e, em seguida, envia um e-mail apenas se o número de registos for superior a 0.

Executar uma consulta KQL e compor um gráfico

Nota

Se a consulta começar com um ponto, é um comando de gestão. Utilize o comando Executar gestão e componione um gráfico.

Utilize esta ação para visualizar um resultado de consulta KQL como uma tabela ou gráfico. Por exemplo, utilize este fluxo para receber relatórios diários por e-mail.

Se a execução da consulta demorar mais de 8 minutos, falhará com uma exceção "RequestTimeout". Para evitar este problema, otimize a consulta ou divida-a em partes mais pequenas. Para obter mais informações, veja Melhores práticas de consulta.

Exemplo

O fluxo seguinte apresentará os resultados da consulta como um gráfico de tempo.

Executar comando de gestão assíncrona

Utilize esta ação para executar um comando de gestão de forma assíncrona, o que significa que continuará a ser executado em segundo plano. A ação devolve um ID, estado e estado. Para verificar o estado e os detalhes de um comando assíncrono, utilize o comando .show operations com o ID devolvido por esta ação.

Se o comando de gestão assíncrona demorar mais de 60 minutos a ser executado, falhará com uma exceção "RequestTimeout".

Exemplo

O fluxo seguinte aciona um comando assíncrono para copiar 10 registos da tabela "TransformedSysLogs" para a "TargetTable". Tenha em atenção que a palavra-chave "assíncrona" é necessária na consulta.

Executar o comando de gestão e compor um gráfico

Utilize esta ação para executar um comando de gestão e apresentar o resultado como um gráfico. As opções de gráfico incluem uma tabela HTML, um gráfico circular, um gráfico de horas e um gráfico de barras.

Se o comando de gestão demorar mais de 8 minutos a ser executado, falhará com uma exceção "RequestTimeout".

Executar comando de gestão de apresentação

Esta ação executa o comando mostrar gestão e devolve o resultado que pode ser utilizado nos seguintes conectores.

Se o comando de gestão demorar mais de 8 minutos a ser executado, falhará com uma exceção "RequestTimeout".

Exemplo

O fluxo seguinte executa o comando de operação .show para encontrar o estado de um comando assíncrono com um ID de operação devolvido por uma execução de comandos assíncrona.

Email resultados da consulta Kusto

Pode incluir um passo em qualquer fluxo para enviar relatórios por e-mail, para qualquer endereço de e-mail.

1. Selecione + Novo Passo para adicionar um novo passo ao fluxo.
2. Na caixa de pesquisa, introduza Office 365 e selecione Office 365 Outlook.
3. Selecione Enviar um e-mail (V2).
4. Introduza o endereço de e-mail para o qual pretende que o relatório de e-mail seja enviado.
5. Introduza o assunto do e-mail.
6. Selecione Vista de código.
7. Coloque o cursor no campo Corpo e selecione Adicionar conteúdo dinâmico.
8. Selecione BodyHtml.
9. Selecione Mostrar opções avançadas.
10. Em Nome dos Anexos -1, selecione Nome do Anexo.
11. Em Conteúdo de Anexos, selecione Conteúdo do Anexo.
12. Se necessário, adicione mais anexos.
13. Se necessário, defina o nível de importância.
14. Selecione Guardar.

Criar uma ligação do Azure Data Explorer

Para executar um fluxo que contenha um conector do Azure Data Explorer, tem de utilizar uma ligação do Azure Data Explorer válida. Pode criar e autenticar uma nova ligação a Power Automate partir do painel esquerdo, selecionarLigações de Dados> ou a partir do fluxo ao selecionar o menu > do conector do Azure Data Explorer Adicionar nova ligação.

Os passos seguintes mostram como criar uma ligação a partir de um fluxo.

1. Em Executar consulta KQL, selecione as reticências no canto superior direito do conector do power automate.

   

2. Selecione Adicionar nova ligação. Quando se liga pela primeira vez, é-lhe pedido para iniciar sessão para autenticar a ligação.

   

Autenticação

Pode autenticar com credenciais de utilizador ou com uma aplicação Microsoft Entra. Para autenticar com credenciais, selecione Iniciar sessão e introduza as suas credenciais.

Para autenticar com um Principal de Serviço:

1. Selecione Ligar ao Principal de Serviço.

2. Preencha o formulário com as informações seguintes:

   • Nome da Ligação: um nome descritivo e significativo para a nova ligação. Neste exemplo, utilizámos "MyApplication".
   • ID de Cliente: o ID da aplicação.
   • Segredo do Cliente: a sua chave de aplicação.
   • Inquilino: o ID do diretório Microsoft Entra no qual criou a aplicação.

   Nota

   Certifique-se de que a aplicação é uma aplicação Microsoft Entra e está autorizada a executar consultas no cluster.

   

   Quando a autenticação estiver concluída, verifique se o fluxo utiliza a nova ligação.

   

   Assim que a ligação estiver definida, o fluxo é executado com as credenciais da aplicação.

Testar o fluxo

Para verificar se o fluxo funciona, verifique o histórico de execuções do fluxo:

1. Aceda à Power Automate home page.

2. No menu principal, selecione Os meus fluxos.

   

3. Na linha do fluxo que pretende investigar, selecione o ícone mais comandos e, em seguida, selecione Histórico de execuções.

   

   Todas as execuções de fluxo são listadas, com informações sobre a hora de início, a duração e o estado.

   Para obter detalhes completos sobre o fluxo, em Os meus fluxos, selecione o fluxo que pretende investigar.

   

Para ver por que motivo uma execução falhou, selecione a hora de início da execução. O fluxo é apresentado e o passo do fluxo que falhou é indicado por um ponto de exclamação vermelho. Expanda o passo com falha para ver os detalhes. O painel Detalhes à direita contém informações sobre a falha para que possa resolvê-la.

Limitações

• O número máximo de registos por pedido é de 50 000 e o tamanho máximo de dados por pedido é de 32 MB. Estes limites não podem ser alterados.
• Os pedidos síncronos têm um tempo limite de 8 minutos.
• Os pedidos assíncronos têm um tempo limite de 60 minutos.
• O conector não suporta operadores que não são suportados pelo getschema operador. Por exemplo, os operadores de bifurcação, faceta e avaliação não são suportados.
• Os fluxos funcionam melhor no Microsoft Edge e no Google Chrome.

Conteúdo relacionado

• Utilize o conector do Azure Kusto Logic App para executar consultas e comandos do Kusto como parte de uma tarefa agendada ou acionada.