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

Uma regra do Activator pode executar uma atividade definida em um dos seguintes tipos de item do Fabric:

  • Fluxo de dados
  • Pipeline
  • Tarefa do Spark
  • Notebook
  • Function
  • Copiar tarefa
  • Publicar evento de negócios (versão prévia)

Para configurar sua regra para iniciar uma atividade de Fabric, 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 Pipeline, Dataflow, Notebook, trabalho do Spark e Publicar evento de negócios (versão prévia), selecione Adicionar parâmetro e especifique o nome do parâmetro do item do Fabric e um valor para ele. Você pode adicionar mais de um parâmetro. O tipo de trabalho Copy não aceita parâmetros.

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

Executar função

Se você selecionar Executar função, siga estas etapas para selecionar a função e especificar parâmetros para ela:

  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.

Publicar evento de negócios (versão prévia)

Se você selecionar Publicar evento de negócios (versão prévia), siga estas etapas para selecionar um esquema de eventos de negócios no registro de esquema e especifique parâmetros para ele:

  1. Ao selecionar Publicar evento de negócios (versão prévia), você verá a janela Selecionar um evento de negócios .

  2. Nesta janela, selecione um esquema de eventos de negócios na lista de esquemas registrados no registro de esquema. Você também pode pesquisar um esquema digitando seu nome na caixa de pesquisa.

    Captura de tela da janela Selecionar um evento de negócios.

  3. Para parâmetros para o evento de negócios, especifique valores para cada um dos parâmetros definidos para o esquema, conforme mostrado no exemplo a seguir:

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

  1. 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.
  2. Você vê a regra no painel Regras . Você pode selecionar a regra para exibir seus detalhes, editá-la ou excluí-la ou abri-la no Activator.

Painel de Regras

No painel Regras , você pode executar as seguintes tarefas:

  • Use o botão de alternância para iniciar ou parar a regra. Quando a regra é interrompida, ela não é executada e nenhum alerta é enviado. Depois de ver alguns alertas de exemplo, interrompa a regra para evitar o envio de muitos alertas. Você pode iniciar a regra novamente quando quiser receber alertas.

  • Use o botão Editar para editar a regra sem sair da página do editor de consultas SQL. Você pode editar os detalhes, as condições, as ações e o local de salvamento da regra.

  • Use o botão Excluir para excluir a regra.

  • Selecione Exibir no Ativador para abrir a regra no Activator. Você pode exibir os detalhes da regra, editá-la ou excluí-la no Activator. Ao exibir no Activator, você também pode ver o histórico da regra, incluindo quando ela foi disparada e os alertas que foram enviados.

    Na página Ativador, selecione o nome do evento e selecione Gerenciar origem para exibir a consulta SQL que disparou o alerta. Se você selecionar o link de consulta, navegue de volta para a página do editor de consultas SQL.

    Captura de tela da página de evento do armazém de exemplo com um link para o armazém de exemplo.

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.

Conteúdo relacionado

  • Last updated on