Alertas de SQL de Databricks

En esta página se proporcionan instrucciones paso a paso para habilitar y usar alertas sql de Databricks para automatizar la ejecución de consultas, evaluar las condiciones personalizadas y entregar notificaciones cuando se cumplan esas condiciones. Con las alertas, puede supervisar de forma proactiva los datos empresariales y recibir notificaciones oportunas cada vez que los valores notificados se encuentran fuera de los umbrales esperados. Al programar una alerta, se ejecuta su consulta asociada y se verifican los criterios de alerta, independientemente de las programaciones existentes en la consulta subyacente. Además, puede acceder a un historial de alertas para revisar los resultados de las evaluaciones de alertas anteriores.

Para obtener información sobre cómo trabajar con alertas heredadas en su lugar, consulte ¿Qué son las alertas heredadas?.

Habilitación de alertas en el área de trabajo

Los administradores del área de trabajo pueden controlar el acceso al área de trabajo a esta versión preliminar desde la página Vistas previas. La habilitación de esta versión preliminar no afecta a las alertas existentes; puede seguir usando tanto estas como las alertas heredadas en paralelo.

Ver y organizar las alertas

Haga clic en el de la barra lateral para abrir la página de lista de alertas.

• La pestaña Alertas está abierta de forma predeterminada y muestra todas las alertas del área de trabajo. Puede escribir para filtrar por nombre. Haga clic en Solo mis alertas para mostrar solo las alertas en las que es el propietario.

• En la pestaña Alertas heredadas se muestran las alertas que se crearon con el sistema de alertas anterior.

• Nombre muestra el nombre de la cadena de cada alerta.

• El estado muestra si el estado de la alerta es TRIGGERED, OKo ERROR.

• La programación muestra la última hora o fecha actualizadas.

• El propietario muestra el nombre de usuario de la persona que posee la alerta.

• Creado en muestra la fecha y hora en que se creó la alerta.

  • TRIGGERED significa que, en la ejecución más reciente, la columna Valor de la consulta de destino cumple la condición y el umbral configurados. Si la alerta comprueba si "gatos" está por encima de 1500, la alerta se desencadenará siempre y cuando "gatos" esté por encima de 1500.
  • OK significa que, en la ejecución de la consulta más reciente, la columna Valor no cumple la condición y el umbral configurados. Esto no significa que la alerta no se desencadenó anteriormente. Si el valor de "gatos" es ahora 1470, la alerta se mostrará como OK.
  • ERROR indica que se produjo un error durante la evaluación de alertas.

Crear una alerta

Los pasos de esta sección le guiarán por cómo crear la alerta que se muestra en la siguiente imagen. Use las etiquetas y explicaciones para comprender cada componente.

1. Editor de consultas: Escriba y pruebe la consulta en la que desea alertar.

2. Horario: Establezca una programación periódica para que se ejecute la alerta.

3. Condición: Seleccione el umbral de valor que debe desencadenar una notificación de alerta. Puede ejecutar la consulta para probar la condición de esta sección.

4. Notificaciones: Indique qué usuarios o destinos de notificación deben recibir alertas cuando el valor de umbral está fuera del intervalo esperado.

5. Avanzado: Use la configuración avanzada para alertar sobre valores y condiciones especiales.

Siga estos pasos para crear una alerta:

1. Haga clic en alertas en la barra lateral y haga clic en Crear alerta.

2. Copie y pegue la consulta siguiente en el editor de consultas. Haga clic en Ejecutar todo (1000). Para obtener más información sobre cómo trabajar con el editor de SQL, consulte Escritura de consultas y exploración de datos en el nuevo editor de 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. En el campo Condición , establezca las condiciones que deben desencadenar la alerta.

   

   Aplique la siguiente configuración como se muestra:

   • Seleccione Suma como valor de datos que se va a comprobar. Las condiciones de alerta pueden establecerse sobre el primer valor de una columna en el resultado de la consulta, o puede optar por establecer una agregación a través de todas las filas de una única columna, como SUM o AVERAGE.
   • Seleccione la cantidad como columna que se va a comprobar.
   • Seleccione > (mayor que) como operador lógico que se va a aplicar.
   • Establezca el valor de umbral en Static value 4000. El valor estático está seleccionado de forma predeterminada. Escriba 4000 en el campo de valor.

4. Haga clic en Condición de prueba para obtener una vista previa de la alerta y probar si la alerta se desencadenaría con los datos actuales. La configuración proporcionada debe desencadenar la alerta. Puede cambiar el valor de umbral para probar más.

5. En la sección Notificaciones , busque el nombre de usuario y haga clic en él cuando aparezca.

6. Haga clic en para abrir el cuadro de diálogo Editar horario. Use los menús desplegables para establecer la alerta para que se ejecute cada 5minutos a partir de 0 minutos más allá de la hora. Haz clic en Guardar. Opcionalmente, active la casilla Mostrar sintaxis de cron para editar la programación en Sintaxis Quartz de cron.

7. Haga clic en Ver alerta.

La alerta se guarda y se ejecuta según la programación proporcionada. Los datos usados en este ejemplo son estáticos, por lo que si la condición de prueba se devuelve como Desencadenada, seguirá igual la próxima vez que se ejecute. Recibirá una notificación por correo electrónico como alerta. Si la condición Test devolvió OK, no se envía ninguna notificación.

Revisión de los detalles de las alertas

Se abre una página para mostrar los detalles de la alerta. Además, se muestra un historial de alertas con los detalles del historial de evaluación. Haga clic en el botón Ejecutar ahora para ejecutar la consulta de alerta inmediatamente y devolver el resultado en esta pantalla.

Haga clic en Editar en la esquina superior derecha de la página para continuar editando la alerta.

Configuración avanzada

Haga clic en Configuración avanzada para aplicar la siguiente configuración:

• Notificar cuando es correcto: envía una notificación cuando la alerta se devuelva como OK.

• Frecuencia de notificación: Envíe periódicamente notificaciones en una alerta hasta que el estado vuelva a OK.

• Estado de resultado vacío: Establezca un estado especial para devolver cuando la consulta no devuelve ningún resultado.

• Plantilla: Puede optar por enviar notificaciones mediante la plantilla predeterminada o una plantilla personalizada. En la lista siguiente se explica cada tipo de plantilla:

  • Usar plantilla predeterminada : la notificación de alerta es un mensaje con vínculos a la pantalla Configuración de alertas y a la pantalla Consulta.

  • Usar plantilla personalizada: la notificación de alerta incluye información más específica sobre la alerta.

    1. Se muestra un cuadro que consta de campos de entrada para el asunto y el cuerpo. Cualquier contenido estático es válido y puede incorporar variables de plantilla integradas:

       • ALERT_STATUS: estado de alerta evaluado (cadena).
       • ALERT_CONDITION: operador de condición de alerta (cadena).
       • ALERT_THRESHOLD: umbral de alerta (cadena o número).
       • ALERT_COLUMN: nombre de columna de alerta (cadena).
       • ALERT_NAME: nombre de la alerta (cadena).
       • ALERT_URL: dirección URL de página de alerta (cadena).
       • QUERY_RESULT_TABLE: la tabla HTML del resultado de la consulta (cadena). Los resultados se limitan a las primeras 100 filas. Solo los destinos de notificación por correo electrónico pueden representar HTML.
       • QUERY_RESULT_VALUE: valor del resultado de la consulta (cadena o número).
       • QUERY_RESULT_ROWS: filas de resultados de la consulta (matriz de valores).
       • QUERY_RESULT_COLS: columnas de resultados de la consulta (matriz de valores).

       Un asunto de ejemplo, por ejemplo, podría ser: Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.

    2. Puede usar HTML para dar formato a los mensajes en una plantilla personalizada. Solo los destinos de notificación por correo electrónico pueden representar HTML. En las plantillas se permiten las siguientes etiquetas y atributos:

       • Etiquetas 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	Etiquetas admitidas
         href	<a>
         title	<img>
         target	<a>
         alt	<img>
         src	<img>
         start	<b>, <blockquote>, <code>, <del>, <em>, <hr>, <i>, <pre><u>

    3. Haga clic en el botón de alternancia Vista previa para obtener una vista previa del resultado representado.

       Importante

       La vista previa es útil para comprobar que las variables de plantilla se representan correctamente. No es una representación precisa del contenido de la notificación final, ya que cada destino de notificación puede mostrar las notificaciones de forma diferente.

Los administradores del área de trabajo pueden configurar nuevos destinos de notificación. Consulte Administración de destinos de notificaciones.

Agregaciones de alertas

Una agregación en una alerta funciona mediante la modificación del SQL original de la consulta SQL de Databricks adjunta a la alerta. La alerta envuelve el texto de la consulta original en una expresión de tabla común (CTE) y realiza una consulta de agregación envolvente sobre ella para agregar el resultado de la consulta.

Como ejemplo, una agregación SUM en una alerta adjunta a una consulta con texto SELECT 1 AS column_name significa que cada vez que se actualiza la alerta, el SQL modificado que se ejecuta sería: WITH q AS (SELECT 1 AS column_name) SELECT SUM(column_name) FROM q.

Esto significa que el resultado original de la consulta (pre-agregado) no puede mostrarse en un cuerpo personalizado de alerta (con parámetros como QUERY_RESULT_ROWS y QUERY_RESULT_COLS) siempre que haya una agregación en una alerta. En su lugar, esas variables solo mostrarán el resultado final de la consulta después de la agregación.

Alerta en varias columnas

Para establecer una alerta basada en varias columnas de una consulta, la consulta puede implementar la lógica de alerta y devolver un valor booleano para que se desencadene la alerta. Por ejemplo:

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 devuelve 1 cuando se dé la condición de que drafts_count > 10000 and archived_count > 5000. A continuación, puede configurar la alerta para que se desencadene cuando el valor sea 1.

Alerta en vistas de métricas

Dado que las vistas de métricas están diseñadas para realizar un seguimiento y medir las métricas empresariales principales, se emparejan bien con alertas para que se pueda recibir una notificación automática cuando una métrica se encuentra fuera de un intervalo esperado. Las alertas de las vistas de métricas funcionan de la misma manera que una alerta en cualquier otro conjunto de datos. Al escribir la consulta para configurarla, use el nombre completo de la vista de métrica que desea supervisar.

Funcionamiento de la integración de Git con alertas

Puede usar carpetas de Git de Databricks para realizar un seguimiento y administrar los cambios en las alertas. Para realizar un seguimiento de las alertas con Git, colóquelas en una carpeta de Git de Databricks. Las alertas recién clonadas solo aparecen en la página de lista de alertas o la API después de que un usuario interactúe con ellas. Las programaciones se han pausado y los usuarios deben reanudarlas explícitamente.

Las carpetas de Git de Databricks proporcionan una manera centralizada de administrar las operaciones comunes de Git para las alertas y otros objetos del área de trabajo. Para más información, consulte Carpetas de Git de Azure Databricks.

Diferencias con las alertas heredadas

La versión más reciente de las alertas de SQL de Databricks se comporta de forma diferente a las alertas heredadas de varias maneras clave:

• Integración de trabajos: La versión más reciente aún no admite la referencia directa a una alerta en el pipeline de Jobs. Esta característica estará disponible próximamente. Las alertas heredadas admiten el tipo de tarea de Alertas en Jobs.
• Reutilización de consultas: No se puede reutilizar una consulta SQL guardada existente al crear una alerta. Cada alerta posee su definición de consulta, que se puede crear directamente en el nuevo editor de alertas.
• Valores de estado de alerta: Los estados de alerta se simplifican y las alertas ya no admiten el UNKNOWN estado de las alertas heredadas. Las evaluaciones se resuelven en OK, TRIGGEREDo ERROR.

Puede seguir usando las alertas más recientes y las alertas heredadas en paralelo mientras realiza la transición.

Configurar permisos de alerta y transferir la propiedad de alertas

Para conocer los niveles de permisos de alerta, consulte ACL de alertas.

1. En la barra lateral, haga clic en Alertas.

2. Haga clic en una alerta.

3. Haga clic en Compartir en la esquina superior derecha de la página de detalles de la alerta para abrir el cuadro de diálogo Compartir .

   

4. Busque y seleccione los grupos o usuarios, y asigne el nivel de permisos.

5. Haga clic en Agregar.

Transferir la propiedad de una alerta

Al guardar una alerta, se convierte en el propietario de la alerta. Si se elimina al propietario de una alerta desde un área de trabajo, la alerta ya no tendrá propietario. Un usuario administrador de área de trabajo puede transferir la propiedad de una alerta a otro usuario. También puede transferir la propiedad mediante la API de permisos.

1. Como administrador del área de trabajo, inicie sesión en tu área de trabajo de Azure Databricks.

2. En la barra lateral, haga clic en Alertas.

3. Haga clic en una alerta.

4. Haga clic en el botón Compartir de la parte superior derecha para abrir el cuadro de diálogo Uso compartido.

5. Haga clic en el icono de engranaje en la parte superior derecha y haga clic en Asignar nuevo propietario.

   

6. Seleccione el usuario al que asignar la propiedad.

7. Haga clic en Confirmar.