Monitorización de consultas programadas
Adobe Experience Platform proporciona una visibilidad mejorada para el estado de todos los trabajos de consulta a través de la IU. Desde la ficha Consultas programadas, ahora puede encontrar información importante acerca de las ejecuciones de consultas que incluye el estado, los detalles de la programación y los mensajes/códigos de error en caso de que se produzcan errores. También puede suscribirse a alertas para consultas en función de su estado a través de la interfaz de usuario para cualquiera de estas consultas a través de la pestaña Consultas programadas.
Consultas programadas
La ficha Consultas programadas proporciona una descripción general de todas sus consultas de CTAS e ITAS programadas. Se pueden encontrar detalles de ejecución para todas las consultas programadas, así como códigos de error y mensajes para cualquier consulta fallida.
Para ir a la ficha Consultas programadas, seleccione Consultas en la barra de navegación izquierda seguida de Consultas programadas
La siguiente tabla describe cada columna disponible.
![Un icono de suscripciones de alerta.](./media_14a1234e77b172e1190057570809adec5ade968be.png?width=750&format=png&optimize=medium)
Run once
y Scheduled
.Success
, Failed
, In progress
y No runs
.El estado actual de la consulta programada. Hay seis valores potenciales, Registrando, Activo, Inactivo, Eliminado, un guión y En cuarentena.
- El estado Registrando indica que el sistema sigue procesando la creación de la nueva programación para la consulta. Tenga en cuenta que no puede deshabilitar ni eliminar una consulta programada mientras se esté registrando.
- El estado Activo indica que la consulta programada aún no ha pasado su fecha y hora de finalización.
- El estado Inactivo indica que la consulta programada ha pasado su fecha y hora de finalización o que un usuario la ha marcado para que esté en estado inactivo.
- El estado Eliminado indica que la programación de consultas se ha eliminado.
- El guión indica que la consulta programada es una consulta única y no recurrente.
- El estado En cuarentena indica que la consulta ha fallado diez ejecuciones consecutivas y requiere su intervención antes de que se puedan llevar a cabo más ejecuciones.
Personalizar la configuración de tablas para consultas programadas customize-table
Puede ajustar las columnas de la ficha Consultas programadas según sus necesidades. Para abrir el cuadro de diálogo Personalizar la tabla y editar las columnas disponibles, seleccione el icono de configuración (
Active las casillas de verificación correspondientes para quitar o agregar una columna de tabla. A continuación, selecciona Aplicar para confirmar tus opciones.
Administración de consultas programadas con acciones en línea inline-actions
La vista Consultas programadas ofrece varias acciones en línea para administrar todas las consultas programadas desde una ubicación. Las acciones en línea se indican en cada fila con puntos suspensivos. Seleccione los puntos suspensivos de una consulta programada que desee administrar para ver las opciones disponibles en un menú emergente. Las opciones disponibles incluyen Deshabilitar programación o Habilitar programación, Eliminar programación, Suscribirse a alertas de consulta y Habilitar o Deshabilitar cuarentena.
Deshabilitar o habilitar una consulta programada disable
Para deshabilitar una consulta programada, seleccione los puntos suspensivos de la consulta programada que desee administrar y, a continuación, seleccione Deshabilitar programación en las opciones del menú emergente. Aparecerá un cuadro de diálogo para confirmar la acción. Seleccione Deshabilitar para confirmar la configuración.
Una vez deshabilitada una consulta programada, puede habilitar la programación a través del mismo proceso. Seleccione los puntos suspensivos y, a continuación, seleccione Habilitar programación de las opciones disponibles.
Eliminar una consulta programada delete
Para eliminar una consulta programada, seleccione los puntos suspensivos de la consulta programada que desee administrar y, a continuación, seleccione Eliminar programación en las opciones del menú emergente. Aparecerá un cuadro de diálogo para confirmar la acción. Seleccione Eliminar para confirmar la configuración.
Una vez que se elimina una consulta programada, no se elimina de la lista de consultas programadas. Las acciones en línea proporcionadas por los puntos suspensivos se eliminan y reemplazan por el icono de suscripción de alerta de adición atenuado. No puede suscribirse a alertas para la programación eliminada. La fila permanece en la interfaz de usuario para proporcionar información sobre las ejecuciones realizadas como parte de la consulta programada.
Si desea programar ejecuciones para esa plantilla de consulta, seleccione el nombre de la plantilla en la fila adecuada para navegar hasta el Editor de consultas y, a continuación, siga las instrucciones para agregar una programación a una consulta como se describe en la documentación.
Suscribirse a alertas alert-subscription
Para suscribirse a alertas para ejecuciones de consultas programadas, seleccione el icono ...
(elipsis) o el icono de suscripción de alerta (
Se abre el cuadro de diálogo Alertas. El cuadro de diálogo Alertas le suscribe tanto a las notificaciones de la interfaz de usuario como a las alertas por correo electrónico. Hay varias opciones de suscripción a alertas disponibles: start
, success
, failure
, quarantine
y delay
. Marque las casillas correspondientes y seleccione Guardar para suscribirse.
En la tabla siguiente se explican los tipos de alertas de consulta admitidos:
start
success
failed
quarantine
delay
Consulte la documentación de API de suscripciones de alerta para obtener más información.
Ver los detalles de la consulta query-details
Seleccione el icono de información (
Consultas en cuarentena quarantined-queries
Cuando se inscribe en la función de cuarentena, cualquier consulta programada que falle diez ejecuciones consecutivas se pone automáticamente en estado En cuarentena. Una consulta con este estado se vuelve inactiva y no se ejecuta a su cadencia programada. Luego requiere su intervención antes de que se puedan llevar a cabo más ejecuciones. Esto protege los recursos del sistema, ya que debe revisar y corregir los problemas con su SQL antes de que se produzcan más ejecuciones.
Para habilitar una consulta programada para la característica de cuarentena, seleccione los puntos suspensivos (...
) seguidos de Habilitar cuarentena en el menú desplegable que aparece.
Las consultas también se pueden inscribir en la función de cuarentena durante el proceso de creación de la programación. Consulte la documentación de programaciones de consultas para obtener más información.
Retraso de ejecución de consulta query-run-delay
Mantenga el control de las horas del equipo mediante la configuración de alertas para los retrasos de las consultas. Puede supervisar el rendimiento de la consulta y recibir notificaciones si el estado de una consulta permanece sin cambios después de un período específico. Utilice la alerta 'Retraso en la ejecución de la consulta' para recibir una notificación si una consulta continúa procesándose después de un período de tiempo específico sin completarse.
Cuando se suscribe a alertas para ejecuciones de consultas programadas, una de las alertas disponibles es Retraso en la ejecución de consultas. Esta alerta requiere que establezca un umbral para el tiempo empleado en la ejecución, momento en el que se le notifica del retraso en el procesamiento.
Para seleccionar una duración de umbral que almacene en déclencheur la notificación, introduzca un número en el campo de entrada de texto o utilice las flechas arriba y abajo para aumentar en incrementos de un minuto. Dado que el umbral se establece en minutos, la duración máxima para observar un retraso de ejecución de consulta es de 1440 minutos (24 horas). El período de tiempo predeterminado para un retraso de ejecución es de 150 minutos.
Consulte la sección Suscribirse a alertas para obtener información sobre cómo suscribirse a Retraso en la ejecución de consultas alertas.
Filtrar consultas filter
Puede filtrar las consultas en función de la frecuencia de ejecución. En la ficha Consultas programadas, seleccione el icono de filtro (
Para filtrar la lista de consultas según su frecuencia de ejecución, active las casillas de verificación de filtro Programado o Ejecutar una vez.
Una vez que haya habilitado los criterios de filtro, seleccione Ocultar filtros para cerrar el panel de filtro.
La consulta ejecuta detalles de programación query-runs
Para abrir la página de detalles de la programación, seleccione un nombre de consulta en la ficha Consultas programadas. Esta vista proporciona una lista de todas las ejecuciones ejecutadas como parte de esa consulta programada. La información proporcionada incluye la hora de inicio y finalización, el estado y el conjunto de datos utilizado.
Esta información se proporciona en una tabla de cinco columnas. Cada fila indica una ejecución de consulta.
Success
, Failed
, In progress
o Quarantined
.Los detalles de la consulta que se está programando se pueden ver en el panel Propiedades. Este panel incluye el ID de consulta inicial, el tipo de cliente, el nombre de la plantilla, el SQL de consulta y la cadencia de la programación.
Seleccione un ID de ejecución de consulta para navegar a la página de detalles de ejecución y ver la información de la consulta.
Resumen de ejecución de consultas query-run-overview
La descripción general de la ejecución de la consulta proporciona información sobre ejecuciones individuales para esta consulta programada y un desglose más detallado del estado de ejecución. Esta página también incluye la información del cliente y los detalles de cualquier error que pueda haber causado un error en la consulta.
La sección de estado de la consulta proporciona el código de error y el mensaje de error en caso de que la consulta haya fallado.
Puede copiar la consulta SQL en el portapapeles desde esta vista. Para copiar la consulta, seleccione el icono Copiar en la parte superior derecha del fragmento SQL. Un mensaje emergente confirma que el código se ha copiado.
Ejecutar detalles para consultas con bloque anónimo anonymous-block-queries
Las consultas que utilizan bloques anónimos para comprender sus instrucciones SQL se separan en sus subconsultas individuales. La separación en subconsultas permite inspeccionar los detalles de ejecución de cada bloque de consulta individualmente.
Los bloques anónimos se identifican mediante el uso de un prefijo $$
antes de la consulta. Para obtener más información sobre los bloques anónimos en el servicio de consultas, consulte documento de bloques anónimos.
Las subconsultas de bloque anónimas tienen pestañas a la izquierda del estado de ejecución. Seleccione una pestaña para mostrar los detalles de la ejecución.
En el caso de que falle una consulta de bloque anónimo, puede encontrar el código de error de ese bloque en particular a través de esta interfaz de usuario.
Seleccione Consulta para volver a la pantalla de detalles de la programación o Consultas programadas para volver a la pestaña Consultas programadas.