Crie uma regra de alerta numa consulta SQL no Fabric Warehouse

Este artigo mostra-lhe como criar um alerta numa consulta SQL no Warehouse. Quando crias um alerta numa consulta SQL, surge um alerta quando a consulta devolve resultados. Se a consulta não devolver qualquer valor, não é emitido qualquer alerta.

Criar uma regra de alerta

No editor de consultas SQL de uma consulta do Warehouse, introduza e execute uma consulta SQL e, em seguida, selecione Criar regra na barra de ferramentas.

Captura de ecrã do botão Definir alerta na fita.

Observação

A consulta SQL deve ser uma consulta SELECT.

Continue para a secção seguinte para começar a criar uma regra.

Secção de detalhes

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

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

Secção Monitor

  1. Na secção Monitor , para Fonte, confirme que a fonte está definida para a tabela onde executou a consulta.
  2. Para Query, confirma que vês a consulta que executaste 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 ecrã da janela de Adicionar regra com as secções Detalhes, Monitor e Condição.

Seção de Condições

No campo Verificar , confirme que está selecionado Em cada evento . Esta configuração significa que o alerta é avaliado sempre que a consulta é executada.

Secção Ação

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

Email

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

  1. Para Selecionar ação, selecione Enviar e-mail.

  2. Em Para, insira o endereço de e-mail do destinatário ou use a lista suspensa para selecionar uma propriedade cujo valor seja um endereço de e-mail.

  3. Em Assunto, insira um assunto para o e-mail.

  4. Em Título, insira um título para o e-mail.

  5. Em Notas, insira notas para os e-mails.

    Observação

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

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

    Captura de ecrã do painel de regras Adicionar com a ação Enviar email selecionada.

Mensagem das equipas

Para configurar o alerta para enviar uma mensagem do Teams para um bate-papo individual ou em grupo ou um canal quando a condição for atendida, siga estas etapas:

  1. Para Selecionar ação, selecione Teams ->Mensagem para indivíduos ou Mensagem de chat de grupo ou Publicação do 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 e-mail dos destinatários ou use a lista suspensa para selecionar uma propriedade cujo valor seja um endereço de e-mail. Quando a condição é cumprida, uma mensagem do Teams é enviada para indivíduos especificados.
    • Se você selecionou a opção Mensagem de chat de grupo , selecione um bate-papo em grupo na lista suspensa. Quando a condição é atendida, uma mensagem é postada no chat de grupo.
    • Se você selecionou a opção Postagem do canal , selecione uma equipe e um canal. Quando a condição é cumprida, uma mensagem é postada no canal.
  3. Para Título, introduza um título para a mensagem da equipa Teams.

  4. Em Notas, insira notas para a mensagem do Teams.

    Observação

    Ao inserir o título ou as notas, pode consultar propriedades nos dados escrevendo @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @BikepointID.

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

    Captura de ecrã do painel de regras Adicionar com a opção Enviar uma mensagem do Teams selecionada.

Executar atividades do Fabric

Uma regra de ativação pode executar uma atividade Fabric definida num dos seguintes tipos de item Fabric:

  • Fluxo de dados
  • Gasoduto
  • Trabalho de faísca
  • Computador portátil
  • Função
  • Trabalho de cópia
  • Publicar evento empresarial (pré-visualização)

Para configurar a sua regra para iniciar uma atividade Fabric, siga estes passos:

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

    Captura de ecrã da opção de itens Run Fabric.

  2. Ao selecionar item Fabric para executar, selecione o item Fabric da lista.

  3. Para os tipos Pipeline, Dataflow, Notebook, Tarefa do Spark e Publicar evento de negócio (pré-visualização), selecione Adicionar parâmetro e especifique o nome do parâmetro do item Fabric e o respetivo valor. Você pode adicionar mais de um parâmetro. O tipo de trabalho Copy não aceita parâmetros.

    Captura de ecrã do painel Adicionar regra com parâmetros para um item Fabric especificados.

Executar função

Se selecionar Executar função, siga estes passos para selecionar a função e especificar os parâmetros para ela:

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

  2. Para os parâmetros da função, especifique valores para cada um dos parâmetros definidos para a função, como mostrado no seguinte exemplo:

    Captura de ecrã do painel de regras de Adicionar com parâmetros para uma Função especificados.

    Pode usar propriedades dos dados escrevendo @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @BikepointID.

Publicar evento empresarial (pré-visualização)

Se selecionar Publicar evento de negócio (pré-visualização), siga estes passos para selecionar um esquema de evento de negócio no registo de esquemas e especifique os parâmetros para ele:

  1. Quando seleciona Publicar evento empresarial (pré-visualização), vê a janela Selecionar um evento empresarial .

  2. Nesta janela, selecione um esquema de evento empresarial da lista de esquemas registados no registo de esquemas. Também pode procurar um esquema escrevendo o seu nome na caixa de pesquisa.

    Captura de ecrã da janela Selecionar um evento empresarial.

  3. Para os parâmetros do evento de negócio, especifique valores para cada um dos parâmetros definidos para o esquema, como mostrado no seguinte exemplo:

Ação personalizada

Para configurar o alerta para chamar uma ação personalizada quando a condição for cumprida, siga estes passos:

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

    Captura de ecrã da secção de Ação com a ação personalizada selecionada.

  2. Como mencionado na secção Ação, crie primeiro a regra e depois complete a configuração personalizada das ações seguindo os passos de Acionar ações personalizadas (fluxos do Power Automate).

    Captura de ecrã da ação personalizada selecionada.

  3. Depois de criares a ação personalizada, no painel de Definição da regra, seleciona a ação personalizada na lista suspensa de Ações .

    Captura de ecrã da ação personalizada selecionada na lista suspensa Selecionar ação.

Secção Guardar localização

  1. Na secção local de gravação, para Espaço de Trabalho, selecione o espaço de trabalho onde pretende que o item ativador do Fabric seja criado ou já exista.

  2. Para Item, selecione um item ativador existente ou crie um novo. Para criar um novo item ativador, selecione Criar um novo item e depois introduza um nome para o item ativador.

    Captura de tela que mostra o painel Adicionar regra com o local do item ativador de malha selecionado.

Criar a regra

  1. Na página Adicionar regra , selecione Criar para criar a regra. Depois de a criação da regra ser bem-sucedida, ela é executada com base na frequência que definiste no campo Executar consulta a cada. Se a consulta devolver resultados, a regra desencadeia as ações que definiste.
  2. Vê a regra no painel de Regras . Podes selecionar a regra para ver os seus detalhes, editá-la, apagá-la ou abri-la no Activator.

Painel de regras

No painel de Regras , pode realizar as seguintes tarefas:

  • Utilize o botão de ativação para ativar ou desativar a regra. Quando a regra é interrompida, não é executada e não são enviados alertas. Quando vires alguns alertas de exemplo, desativa a regra para evitar o envio de demasiados alertas. Podes recomeçar a regra quando quiseres receber alertas.

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

  • Usa o botão Apagar para eliminar a regra.

  • Selecione Visualizar no Ativador para abrir a regra no Ativador. Podes ver os detalhes da regra, editá-la ou apagá-la no Activator. Quando vês no Activator, também podes ver o histórico da regra, incluindo quando foi ativada e os alertas enviados.

    Na página do Ativador, selecione o nome do evento e selecione Gerir a fonte para visualizar a consulta SQL que desencadeou o alerta. Se selecionares o link da consulta, voltas à página do editor de consultas SQL.

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

Alerta de exemplo

Aqui está um exemplo de mensagem de alerta do Teams que recebe quando o alerta é ativado:

Captura de ecrã da mensagem de alerta de exemplo do Teams.