Pular para o conteúdo principal
Última atualização em

Tarefa de alerta SQL para jobs

Use uma tarefa de alerta SQL para avaliar um alerta do Databricks SQL como parte de um Job. As tarefas de alerta SQL permitem que você integre o monitoramento baseado em alertas em seus pipelines de dados, possibilitando verificações de condição automatizadas e notificações juntamente com outras tarefas de Job. Para saber mais sobre alertas do Databricks SQL, consulte alertas do Databricks SQL.

Requisitos​

Para usar a tarefa de alerta SQL, você deve atender aos seguintes pré-requisitos:

  • É necessário ter um alerta do Databricks SQL existente em seu workspace. Para criar um alerta, consulte Criar um alerta.
  • Você deve ter pelo menos permissão CAN RUN no alerta que você deseja usar.
  • Você deve ter acesso a um SQL warehouse serverless ou Pro.

Configure uma tarefa de alerta SQL​

A UI de jobs exibe opções dinamicamente com base em outras configurações definidas. Para configurar uma tarefa SQL Alert:

  1. No seu workspace, clique em Ícone de fluxos de trabalho. Jobs e Pipelines na barra lateral.

  2. Clique em **Criar** e, em seguida, em **Job**.

  3. Clique em **Adicionar outro tipo de tarefa**. Procure por **Alerta SQL** e clique no bloco para selecioná-lo.

  4. Insira um **Nome da Tarefa**.

  5. No menu suspenso **Alerta**, selecione o alerta do Databricks SQL que deseja avaliar.

  6. (Opcional) No menu suspenso SQL warehouse , selecione o SQL warehouse a ser usado para executar a query do alerta. Se não for definido, o warehouse interno do alerta será usado. É necessário usar um SQL Warehouse Pro ou serverless para tarefas de alerta SQL.

  7. (Opcional) No menu suspenso de **Assinantes**, escolha os usuários e destinos de notificação que devem receber notificações com os resultados do alerta. Se não for definido, os assinantes internos do alerta (se aplicável) recebem notificações. Para personalizar o assunto e o corpo da notificação, incluindo os resultados da consulta, configure o padrão de notificação no alerta do Databricks SQL subjacente. Consulte Padrões de notificação.

  8. (Opcional) Use as Notificações para notificar endereços de email ou webhooks quando as execuções desta tarefa começarem, terminarem ou falharem:

    1. Clique Ícone de mais. em **Adicionar** para abrir a caixa de diálogo **Notificações de tarefas**.
    2. Clique em **Adicionar notificação** para adicionar uma nova notificação ou editar uma existente.
    3. No menu suspenso Destino , escolha um destino. Se o destino desejado não estiver disponível e você tiver as permissões apropriadas, clique em Ícone de mais. Adicionar novo destino do sistema para configurar um novo. Você deve ser um administrador do workspace para adicionar um destino do sistema. Consulte Gerenciar destinos de notificação.
    4. Clique em Salvar para aplicar suas configurações.

  9. (Opcional) Para configurar Limite de duração ou Repetições , consulte Configurações avançadas de tarefa.

  10. Clique em Salvar tarefa .

Para editar, clonar, desabilitar ou excluir esta tarefa, consulte Configurar e editar tarefas em Jobs do Lakeflow.

Comportamento da tarefa de alerta SQL​

Quando um Job executa uma tarefa de alerta SQL, ocorre o seguinte:

  1. A consulta do alerta é executada no SQL warehouse especificado.
  2. A condição do alerta é avaliada em relação aos resultados da consulta.
  3. Assinantes configurados na tarefa recebem notificações com base no resultado do alerta.

A tarefa de alerta SQL relata um dos seguintes status:

  • Bem-sucedido : O alerta foi avaliado com sucesso, independentemente de a condição do alerta ter sido acionada ou não.
  • Falha: Ocorreu um erro durante a avaliação do alerta, como um problema de conectividade do SQL warehouse ou um erro de query.
nota

A tarefa de alerta SQL avalia o alerta independentemente de qualquer programação configurada no próprio alerta. As programações no alerta subjacente não são afetadas pela execução do Job.

Limitações​

  • Tarefas de alerta SQL não oferecem suporte a parâmetros. Se você precisar usar consultas parametrizadas, considere usar uma tarefa SQL em vez disso.
  • As tarefas de alerta SQL dão suporte apenas a alertas do Databricks SQL. Alertas legados não são compatíveis.
Nesta página