Alertas SQL do Databricks

Esta página fornece orientação passo a passo para habilitar e usar alertas SQL do Databricks para automatizar a execução de consultas, avaliar condições personalizadas e entregar notificações quando essas condições forem atendidas. Com os alertas, você pode monitorar proativamente os dados da sua empresa e receber notificações oportunas sempre que os valores relatados estiverem fora dos limites esperados. Quando agendas um alerta, a consulta associada executa-se e os critérios de alerta são verificados, independentemente de quaisquer agendas existentes na consulta subjacente. Além disso, você pode acessar um histórico de alertas para revisar os resultados de avaliações de alertas anteriores.

Para saber como trabalhar com alertas herdados, consulte O que são alertas herdados?.

Ativar alertas na sua área de trabalho

Os administradores do espaço de trabalho podem controlar o acesso ao espaço de trabalho a esta pré-visualização a partir da página de Pré-visualizações. Ativar esta pré-visualização não afeta os seus alertas existentes; Pode continuar a usar estes alertas e alertas antigos em paralelo.

Ver e organizar alertas

Clique no Alertas na barra lateral para abrir a página de listagem de alertas.

• A guia Alertas é aberta por padrão e mostra todos os alertas no espaço de trabalho. Você pode digitar para filtrar por nome. Clique em Somente meus alertas para mostrar apenas os alertas onde você é o proprietário.

• O separador Alertas herdados mostra alertas que foram criados usando o sistema de alertas anterior.

• Nome mostra o nome da cadeia de cada alerta.

• Status mostra se o status do alerta é TRIGGERED, OKou ERROR.

• Agenda mostra a hora ou data da última atualização.

• Proprietário mostra o nome de usuário da pessoa que possui o alerta.

• Criado em mostra a data e a hora em que o alerta foi criado.

  • TRIGGERED significa que, na execução mais recente, a coluna Valor na consulta de destino atendeu à Condição e ao Limite que você configurou. Se o seu alerta verificar se "gatos" está acima de 1500, irá ser ativado enquanto "gatos" estiver acima de 1500.
  • OK significa que, na execução da consulta mais recente, a coluna Valor não atendeu à Condição e ao Limite que você configurou. Isto não significa que o Alerta não tenha sido ativado anteriormente. Se o seu valor "gatos" for agora 1470, o seu alerta será exibido como OK.
  • ERROR Indica que ocorreu um erro durante a avaliação do alerta.

Criar um alerta

As etapas nesta seção orientam você sobre como criar o alerta mostrado na imagem a seguir. Use os rótulos e explicações para entender cada componente.

1. Editor de consultas: Escreva e teste a consulta sobre a qual deseja alertar.

2. Horário: Defina uma programação periódica para que o alerta seja executado.

3. Condição: Selecione o limite de valor que deve disparar uma notificação de alerta. Você pode executar a consulta para testar a condição nesta seção.

4. Notificações: Indique quais os utilizadores ou destinos de notificação que devem ser alertados quando o valor limiar estiver fora do intervalo esperado.

5. Avançado: Use configurações avançadas para alertar sobre valores e condições especiais.

Use as seguintes etapas para criar um alerta:

1. Clique em Alertas na barra lateral e clique em Criar alerta.

2. Copie e cole a seguinte consulta no editor de consultas. Clique em Executar tudo (1000). Para saber mais sobre como trabalhar com o editor SQL, consulte Escrever consultas e explorar dados no novo editor SQL.

   SELECT
     to_date(tpep_pickup_datetime) as date,
     SUM(fare_amount) as amount
   FROM
     `samples`.`nyctaxi`.`trips`
   GROUP BY
     ALL
   ORDER BY
     1 DESC
   
   

3. No campo Condição , defina as condições que devem disparar o alerta.

   

   Aplique as seguintes configurações conforme mostrado:

   • Selecione Soma como o valor de dados a ser verificado. As condições de alerta podem ser definidas no primeiro valor de uma coluna no resultado da consulta ou você pode optar por definir uma agregação em todas as linhas de uma única coluna, como SOMA ou MÉDIA.
   • Selecione o valor como a coluna a ser verificada.
   • Selecione > (maior que) como o operador lógico a ser aplicado.
   • Defina o valor limite como Static value 4000. O valor estático é selecionado por padrão. Insira 4000 no campo de valor.

4. Clique em Condição de teste para visualizar o alerta e testar se o alerta seria acionado com os dados atuais. As configurações fornecidas devem disparar o alerta. Você pode alterar o valor do limite para testar mais.

5. Na seção Notificações , procure seu nome de usuário e clique nele quando ele aparecer.

6. Clique no o ícone de calendário para abrir a caixa de diálogo Editar agenda. Use os menus suspensos para definir o alerta para que ele seja executado a cada 5minutos a partir de 0 minutos após a hora. Clique em Salvar. Opcionalmente, marque a caixa de seleção Mostrar sintaxe cron para editar a agenda em Quartz Cron Syntax.

7. Clique em Ver alerta.

O seu alerta é guardado e corre no horário que forneceu. Os dados usados neste exemplo são estáticos, portanto, se a sua condição de teste retornou como Acionada, ela será novamente na próxima vez que for executada. Recebe uma notificação por email como alerta. Se a condição de teste retornou OK, nenhuma notificação será enviada.

Rever os detalhes do alerta

É aberta uma página para mostrar os detalhes do alerta. Além disso, um histórico de alertas é mostrado com detalhes do histórico de avaliação. Clique no botão Executar agora para executar imediatamente a consulta de alerta e devolver o resultado neste ecrã.

Clique em Editar no canto superior direito da página para continuar editando o alerta.

Configurações avançadas

Clique em Configurações avançadas para aplicar as seguintes configurações:

• Notifique em ok: Envie uma notificação quando o alerta retornar como OK.

• Frequência de notificação: Envie periodicamente notificações em um alerta até que o status retorne para OK.

• Estado de resultado vazio: Defina um status especial para retornar quando a consulta não retornar nenhum resultado.

• Modelo: Você pode optar por enviar notificações usando o modelo padrão ou um modelo personalizado. A lista a seguir explica cada tipo de modelo:

  • Usar modelo padrão: a notificação de alerta é uma mensagem com links para a tela de configuração do Alerta e para a tela Consulta.

  • Usar modelo personalizado: a notificação de alerta inclui informações mais específicas sobre o alerta.

    1. Uma caixa é exibida, consistindo em campos de entrada para assunto e corpo. Qualquer conteúdo estático é válido e você pode incorporar variáveis de modelo internas:

       • ALERT_STATUS: O status de alerta avaliado (string).
       • ALERT_CONDITION: O operador de condição de alerta (string).
       • ALERT_THRESHOLD: O limiar de alerta (cadeia de caracteres ou número).
       • ALERT_COLUMN: O nome da coluna de alerta (string).
       • ALERT_NAME: O nome do alerta (string).
       • ALERT_URL: O URL da página de alerta (string).
       • QUERY_RESULT_TABLE: A tabela HTML do resultado da consulta (string). Os resultados são limitados às primeiras 100 linhas. Somente os destinos de notificação por e-mail podem renderizar HTML.
       • QUERY_RESULT_VALUE: O valor do resultado da consulta (cadeia de caracteres ou número).
       • QUERY_RESULT_ROWS: As linhas de resultado da consulta (matriz de valores).
       • QUERY_RESULT_COLS: As colunas de resultado da consulta (matriz de cadeia de caracteres).

       Um exemplo de assunto, por exemplo, poderia ser: Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.

    2. Você pode usar HTML para formatar mensagens em um modelo personalizado. Somente os destinos de notificação por e-mail podem renderizar HTML. As seguintes tags e atributos são permitidos em modelos:

       • Tags permitidas: <a>, <b>, <blockquote>, <br>, <code>, <del>, <div>, <em>, <h1>, <h2>, <h3>, <h4>, <h5>, <h6>, <hr>, <i>, <img>, <li>, <ol>, <p>, <pre>, <span>, <table>, <thread>, <tbody>, <td>, <th>, <tr>, <u>, <ul>

       • Atributos permitidos:

         Atributo	Tags suportadas
         href	<a>
         title	<img>
         target	<a>
         alt	<img>
         src	<img>
         start	<b>, <blockquote>, <code>, <del>, <em><hr>, <i>, <pre>, <u>

    3. Clique no botão de alternância Visualizar para visualizar o resultado renderizado.

       Importante

       A visualização é útil para verificar se as variáveis de modelo são renderizadas corretamente. Não é uma representação precisa do eventual conteúdo da notificação, pois cada destino de notificação pode exibir notificações de forma diferente.

Os administradores do espaço de trabalho podem configurar novos destinos de notificação. Consulte Gerenciar destinos de notificação.

Agregações de alertas

Uma agregação em um alerta funciona modificando o SQL original da consulta SQL do Databricks anexada ao alerta. O alerta envolve o texto da consulta original numa expressão de tabela comum (CTE) e executa uma consulta de agregação de contorno para agregar o resultado da consulta.

Por exemplo, uma SUM agregação em um alerta anexado a uma consulta com texto SELECT 1 AS column_name significa que, sempre que o alerta for atualizado, o SQL modificado executado será: WITH q AS (SELECT 1 AS column_name) SELECT SUM(column_name) FROM q.

Isso significa que o resultado da consulta original (pré-agregado) não pode ser mostrado em um corpo personalizado de alerta (com parâmetros como QUERY_RESULT_ROWS e QUERY_RESULT_COLS) sempre que houver uma agregação em um alerta. Em vez disso, essas variáveis exibirão apenas o resultado final da consulta pós-agregação.

Alerta em várias colunas

Para definir um alerta com base em várias colunas de uma consulta, sua consulta pode implementar a lógica de alerta e retornar um valor booleano para o alerta ser acionado. Por exemplo:

SELECT CASE WHEN drafts_count > 10000 AND archived_count > 5000 THEN 1 ELSE 0 END
FROM (
SELECT sum(CASE WHEN is_archived THEN 1 ELSE 0 END) AS archived_count,
sum(CASE WHEN is_draft THEN 1 ELSE 0 END) AS drafts_count
FROM queries) data

Esta consulta retorna 1 quando drafts_count > 10000 and archived_count > 5000. Em seguida, você pode configurar o alerta para disparar quando o valor for 1.

Alerta sobre visualizações métricas

Como as visualizações de métricas são projetadas para acompanhar e medir as principais métricas de negócios, elas combinam bem com alertas para que você possa ser notificado automaticamente quando uma métrica estiver fora de um intervalo esperado. Os alertas em visualizações métricas funcionam da mesma forma que um alerta em qualquer outro conjunto de dados. Ao escrever a consulta para configurá-la, use o nome totalmente qualificado da exibição de métrica que deseja monitorar.

Como funciona a integração do Git com alertas

Você pode usar as pastas do Databricks Git para controlar e gerenciar alterações em alertas. Para rastrear alertas com o Git, coloque-os em uma pasta Databricks Git. Os alertas recém-clonados só aparecem na página de listagem de alertas ou na API depois que um usuário interage com eles. Eles têm horários pausados e precisam ser explicitamente retomados pelos usuários.

As pastas Databricks Git fornecem uma maneira centralizada de gerenciar operações comuns do Git para alertas e outros objetos de espaço de trabalho. Para obter mais detalhes, consulte Pastas Git do Azure Databricks.

Diferenças em relação aos alertas antigos

A versão mais recente dos alertas SQL do Databricks comporta-se de forma diferente dos alertas legados em alguns aspetos fundamentais:

• Integração de Jobs: A versão mais recente ainda não suporta referenciar diretamente um alerta no pipeline de Jobs. Esta funcionalidade está a chegar em breve. Os alertas antigos suportam o tipo de tarefa dos alertas em Jobs.
• Reutilização de consultas: Uma consulta SQL guardada existente não pode ser reutilizada ao criar um alerta. Cada alerta possui a sua definição de consulta, que pode ser criada diretamente no novo editor de alertas.
• Valores de estado de alerta: Os estados de alerta são simplificados e os alertas já não suportam o UNKNOWN estado dos alertas antigos. As avaliações resolvem-se para OK, TRIGGERED, ou ERROR.

Podes continuar a usar os alertas mais recentes e os alertas antigos lado a lado enquanto fazes a transição.

Configurar permissões de alerta e transferir a propriedade do alerta

Para obter os níveis de permissão de alerta, consulte ACLs de alerta.

1. Na barra lateral, clique em Alertas.

2. Clique em um alerta.

3. Clique em Compartilhar no canto superior direito da página de detalhes do alerta para abrir a caixa de diálogo Compartilhamento .

   

4. Pesquise e selecione os grupos e usuários e atribua o nível de permissão.

5. Clique em Adicionar.

Transferir a propriedade de um alerta

Ao salvar um alerta, você se torna o proprietário do alerta. Se o proprietário de um alerta for removido de um espaço de trabalho, o alerta não terá mais um proprietário. Um usuário administrador de espaço de trabalho pode transferir a propriedade de um alerta para um usuário diferente. Você também pode transferir a propriedade usando a API de Permissões.

1. Como administrador do espaço de trabalho, faça logon no seu espaço de trabalho do Azure Databricks.

2. Na barra lateral, clique em Alertas.

3. Clique em um alerta.

4. Clique no botão Compartilhar no canto superior direito para abrir a caixa de diálogo Compartilhamento .

5. Clique no ícone de engrenagem no canto superior direito e clique em Atribuir novo proprietário.

   

6. Selecione o usuário ao qual atribuir a propriedade.

7. Clique em Confirmar.