Criar uma regra de alerta em uma consulta SQL do Fabric Warehouse

Este artigo mostra como criar um alerta em uma consulta SQL do Warehouse. Quando você cria um alerta em uma consulta SQL, um alerta é gerado quando a consulta retorna resultados. Se a consulta não retornar nenhum valor, nenhum alerta será gerado.

Criar uma regra de alerta

No editor de consultas SQL de uma consulta SQL do Warehouse, insira e execute uma consulta SQL e selecione Criar regra na faixa de opções.

Captura de tela do botão Definir alerta na faixa de opções.

Observação

A consulta SQL deve ser uma consulta SELECT.

Continue para a próxima seção para começar a criar uma regra.

Seção Detalhes

Na página Adicionar regra , na seção Detalhes , para o nome da regra, insira um nome para a regra.

Captura de tela que mostra o painel Adicionar regra com o nome da regra preenchido.

Seção de Monitoramento

  1. Na seção Monitor, em Origem, confirme se a origem está definida como a tabela na qual você executou a consulta.
  2. Para Consulta, confirme que você vê a consulta que executou no editor de consultas SQL. Para ver a consulta completa, selecione Mostrar mais.
  3. Para o campo Executar consulta a cada, selecione a frequência com que a consulta deve ser executada para verificar a condição.

Captura de tela da janela Adicionar regra com as seções Detalhes, Monitor e Condição.

Seção Condição

Para o campo Verificação, confirme se Em cada evento está selecionado. Essa configuração significa que o alerta é avaliado sempre que a consulta é executada.

Seção Ação

Na seção Ação , selecione uma das seguintes ações:

Email

Para configurar o alerta para enviar um email quando a condição for atendida, siga estas etapas:

  1. Para selecionar a ação, selecione Enviar email.

  2. Para To, insira o endereço de email do receptor ou use a lista suspensa para selecionar uma propriedade cujo valor é um endereço de email.

  3. Para Assunto, insira um assunto para o email.

  4. Para o Título, insira uma manchete para o email.

  5. Para Anotações, insira anotações para os emails.

    Observação

    Ao inserir assunto, título ou anotações, você pode consultar as propriedades nos dados digitando @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @BikepointID.

  6. Para Contexto, selecione valores na lista suspensa que você deseja incluir no contexto.

    Captura de tela do painel Adicionar regra com a ação Enviar email selecionada.

Mensagem do Teams

Para configurar o alerta para enviar uma mensagem do Teams para um indivíduo ou um chat em grupo ou um canal quando a condição for atendida, siga estas etapas:

  1. Para selecionar a ação, selecione Teams ->Mensagem para indivíduos ou Mensagem de chat de grupo ou postagem de canal.

  2. Siga uma destas etapas, dependendo da opção selecionada na etapa anterior:

    • Se você selecionou a opção Mensagem para indivíduos, insira os endereços de email dos destinatários ou use a lista suspensa para selecionar uma propriedade cujo valor é um endereço de email. Quando a condição é atendida, uma mensagem do Teams é enviada para indivíduos especificados.
    • Se você selecionou a opção Mensagem de chat em grupo, selecione um chat em grupo na lista suspensa. Quando a condição é atendida, uma mensagem é postada no chat do grupo.
    • Se você selecionou a opção de postagem do Canal , selecione uma equipe e um canal. Quando a condição é atendida, uma mensagem é postada no canal.
  3. Para o Título, insira uma manchete para a mensagem do Teams.

  4. Para anotações, insira anotações para a mensagem do Teams.

    Observação

    Ao inserir título ou anotações, você pode consultar as propriedades nos dados digitando @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @BikepointID.

  5. Para Contexto, selecione valores na lista suspensa que você deseja incluir no contexto.

    Captura de tela do painel Adicionar regra com a opção Enviar mensagem do Teams selecionada.

Executar atividades do Fabric

Para configurar o alerta para iniciar um pipeline do Fabric, um fluxo de dados (versão prévia), um notebook ou um trabalho Spark quando a condição for atendida, siga estas etapas:

  1. Para selecionar a ação, selecione o tipo de item do Fabric apropriado na seção "Executar Atividades do Fabric"

    Captura de tela da opção Executar itens do Fabric.

  2. No Selecionar item de Fabric para executar, selecione o item Fabric na lista.

  3. Para os tipos de trabalho Pipeline, Fluxo de Dados, Notebook e Spark, selecione Adicionar parâmetro e especifique o nome do parâmetro para o item Fabric e um valor para ele. Você pode adicionar mais de um parâmetro.

    Captura de tela do painel Adicionar regra com parâmetros para um item do Fabric especificado.

    Se você selecionou a opção Executar função , siga estas etapas:

    1. Para a Função, selecione uma função na lista.

    2. Para parâmetros para a função, especifique valores para cada um dos parâmetros definidos para a função, conforme mostrado no exemplo a seguir:

      Captura de tela do painel Adicionar regra com parâmetros para uma função especificada.

      Você pode usar propriedades dos dados digitando @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @BikepointID.

Ação personalizada

Para configurar o alerta para chamar uma ação personalizada quando a condição for atendida, siga estas etapas:

  1. Para selecionar a ação, selecione Criar ação personalizada.

    Captura de tela da seção Ação com a ação personalizada selecionada.

  2. Conforme mencionado na seção Ação , crie a regra primeiro e conclua a configuração da ação personalizada seguindo as etapas de Disparar ações personalizadas (fluxos do Power Automate).

    Captura de tela da ação personalizada selecionada.

  3. Depois de criar a ação personalizada, no painel Definição da regra, selecione a ação personalizada na lista suspensa Ação .

    Captura de tela da ação personalizada selecionada na lista suspensa Selecione ação.

Seção Salvar localização

  1. Na seção Salvar local , para Workspace, selecione o workspace no qual você deseja que o item do ativador do Fabric seja criado ou que já exista.

  2. Para Item, selecione um item de ativador existente ou crie um novo. Para criar um novo item de ativador, selecione Criar um novo item e, em seguida, insira um nome para o item do ativador.

    Captura de tela que mostra o painel Adicionar regra com o local do item Fabric Activator selecionado.

Criar a regra

Na página Adicionar regra , selecione Criar para criar a regra. Depois que a criação da regra for bem-sucedida, ela será executada com base na frequência definida no campo Executar consulta a cada. Se a consulta retornar resultados, a regra disparará as ações definidas.

Painel de Regras

Depois que a criação da regra for bem-sucedida, você verá o painel Regras com a lista de regras. No painel Regras, você pode executar as seguintes tarefas:

  • Use o botão de alternância para parar ou executar a regra.

  • Selecione ..., e selecione Editar para editar a regra, Excluir para excluir a regra e Abrir no Fabric Activator para abrir o item Fabric Activator com a regra que foi criada.

    Captura de tela que mostra o painel Regras com a lista de regras.

Alerta de exemplo

Aqui está uma mensagem de alerta de exemplo do Teams que você recebe quando o alerta é disparado:

Captura de tela da mensagem de alerta de exemplo do Teams.