Partilhar via


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:

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.

    Captura de ecrã da Power Automate home page a mostrar Os meus fluxos e Novo realçados.

  3. Selecione Fluxo de cloud agendado.

    Captura de ecrã a mostrar a caixa de diálogo Novo, com a opção Agendada do zero realçada.

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

    Captura de ecrã a mostrar a página Criar um fluxo agendado, com as opções de nome do Flow realçadas.

  5. Selecione Criar>+ Novo passo.

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

    Captura de ecrã a mostrar a janela Escolher uma operação, com a caixa de pesquisa e o Azure Data Explorer realçados.

  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.

    Captura de ecrã a mostrar a lista Escolher uma ação, com a lista de ações realçada.

Ações de fluxo

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

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.

Captura de ecrã a mostrar o conector do Azure Data Explorer, com a ação Executar consulta KQL.

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.

Captura de ecrã a mostrar o conector do Azure Data Explorer, com a ação Executar consulta KQL e compor um gráfico.

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.

Captura de ecrã a mostrar o conector do Azure Data Explorer, com a ação de comando Executar gestão assíncrona.

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".

Captura de ecrã do comando Executar gestão e compor um gráfico no painel de periodicidade.

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.

Captura de ecrã a mostrar o conector do Azure Data Explorer, com a ação de comando Executar mostrar gestão.

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. Captura de ecrã da caixa de diálogo Enviar um e-mail, com o campo Corpo e BodyHtml realçados.
  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.

Captura de ecrã a mostrar a caixa de diálogo Enviar um e-mail, com o Nome dos Anexos, o Conteúdo dos Anexos e a opção Guardar realçadas.

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.

    Captura de ecrã a mostrar a ligação Data Explorer do Azure, com a opção de autenticação.

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

    Captura de ecrã a mostrar a ligação Data Explorer do Azure, com a opção de início de sessã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.

    Captura de ecrã a mostrar a ligação Data Explorer do Azure, com a caixa de diálogo de autenticação da aplicação.

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

    Captura de ecrã a mostrar a autenticação da aplicação concluída.

    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.

    Captura de ecrã do Power Automate menu principal a mostrar Os meus fluxos realçados.

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

    Captura de ecrã a mostrar o separador Os meus fluxos, com o Histórico de execuções realçado.

    Todas as execuções de fluxo são listadas, com informações sobre a hora de início, a duração e o estado. Captura de ecrã da página Resultados do histórico de execuções.

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

    Captura de ecrã a mostrar a página de resultados completos do Histórico de execuções.

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.

Captura de ecrã a mostrar a execução do fluxo, com uma mensagem de erro.

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.