Criar um alerta

Esta página orienta-o na criação de um alerta do Databricks SQL do início ao fim. Cobre o editor de alertas, o tutorial de criação de alertas, como rever detalhes de avaliação e as definições avançadas e modelos de notificações que pode configurar.

Explore o editor de alertas

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: Escreve e testa a consulta para a qual queres alertar.
2. Processamento: Escolha o armazém de SQL que executa a consulta do alerta. O indicador de estado mostra se o armazém selecionado está a funcionar. Para recomendações sobre o dimensionamento do warehouse e o comportamento no momento da execução agendada, consulte Escolha um warehouse SQL para um alerta.
3. Agenda: Defina um horário periódico para o alerta ser executado.
4. Partilhar: Defina permissões que definam como os outros no seu espaço de trabalho podem trabalhar com o seu alerta.
5. Condição: Selecione o limiar de valor que deve desencadear uma notificação de alerta. Você pode executar a consulta para testar a condição nesta seção.
6. Notificações: Indique quais os utilizadores ou destinos de notificação que devem ser alertados quando o valor limiar sai do intervalo esperado. Opcionalmente, defina uma frequência de notificação para repetir notificações até que o alerta regresse a OK.
7. Avançado: Use definições avançadas para alertar sobre valores e condições especiais.

Criar um alerta

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. Clique no seletor de cálculo e depois clique num armazém da lista para especificar qual recurso de computação executa o alerta.

   

4. 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. Pode definir uma condição de alerta no primeiro valor de uma coluna no resultado da consulta, ou pode selecionar definir uma agregação em todas as linhas de uma única coluna, como SUM 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.

5. 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.

6. Na secção de Notificações , procure o seu nome de utilizador e clique nele quando aparecer.

7. 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 Guardar. Opcionalmente, marque a caixa de seleção Mostrar sintaxe cron para editar a agenda em Quartz Cron Syntax.

8. Clique em Ver alerta.

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

Detalhes do alerta de revisão

É aberta uma página para mostrar os detalhes do alerta. A página também mostra um histórico de alertas com detalhes da avaliação. Clique no botão Executar agora para executar imediatamente a consulta de alerta e devolver o resultado nesta página.

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

Configurações avançadas

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

• Notificar quando estiver em OK: Enviar uma notificação quando o alerta voltar ao estado OK.
• Estado de resultado vazio: Defina um estado especial para devolver quando a consulta não devolver resultados.
• Modelo: Configure o modelo de notificação. Consulte os modelos de notificações.

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

Modelos de notificação

As notificações usam o modelo predefinido, a menos que as personalizes. Para personalizar o tema e o corpo, selecione Personalizar modelo. Estão disponíveis dois editores: o editor padrão e o editor Markdown. Clique nos separadores abaixo para os comparar.

Editor padrão

No editor padrão, utilize variáveis de referência no assunto e no corpo com {{VARIABLE_NAME}}. As seguintes variáveis são suportadas:

• ALERT_STATUS: O estado de alerta avaliado (string).
• ALERT_CONDITION: O operador de condição de alerta (cadeia de caracteres).
• 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).

Por exemplo: Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.

O editor padrão também suporta HTML para formatação. Somente os destinos de notificação por e-mail podem renderizar HTML. As seguintes etiquetas HTML são permitidas: <a>, <b>, <blockquote>, <br>, <code>, <del>, <div>, <em>, <h1>, <h2>, <h3>, <h4>, <h5>, <h6>, <hr>, <i>, <img>, <li>, <ol>, <p>, <pre>, <span>, <table>, <thead>, <tbody>, <td>, <th>, <tr>, <u>, <ul>.

Os seguintes atributos são permitidos nas etiquetas listadas:

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

Editor de Markdown

Ative o Markdown Editor para escrever o corpo usando o Markdown. O editor Markdown tem uma barra de ferramentas de formatação e uma pré-visualização renderizada.

No editor de Markdown, faça referência às variáveis com @VARIABLE_NAME. Introduza @ no corpo para abrir o seletor de variáveis. O editor Markdown suporta ALERT_NAME, ALERT_STATUS, ALERT_CONDITION, ALERT_THRESHOLD, ALERT_COLUMN, ALERT_URL, e QUERY_RESULT_TABLE.