Monitorización de consultas programadas

Última actualización: 2024-01-30
  • Temas:
  • Queries
    Ver más sobre este tema
  • Creado para:
  • User
    Developer

Adobe Experience Platform proporciona una visibilidad mejorada para el estado de todos los trabajos de consulta a través de la IU. Desde el 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 fallen. 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 mediante Consultas programadas pestaña.

Consultas programadas

El Consultas programadas proporciona una visió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 Consultas programadas pestaña, seleccione Consultas desde la barra de navegación izquierda seguida de Consultas programadas

La ficha Consultas programadas del área de trabajo Consultas con Consultas programadas y Consultas resaltadas.

La siguiente tabla describe cada columna disponible.

NOTA

El icono de suscripciones de alerta está contenido en cada fila de una columna sin título. Consulte la suscripciones de alerta para obtener más información.

Columna Descripción
Nombre El campo de nombre es el nombre de la plantilla o los primeros caracteres de la consulta SQL. Cualquier consulta creada a través de la interfaz de usuario con el Editor de consultas recibe el nombre al principio. Si la consulta se creó mediante la API, su nombre se convierte en un fragmento del SQL inicial utilizado para crear la consulta. Para ver una lista de todas las ejecuciones asociadas con la consulta, seleccione un elemento de la Nombre columna. Para obtener más información, consulte la query ejecuta detalles de programación sección.
Plantilla Nombre de plantilla de la consulta. Seleccione un nombre de plantilla para navegar hasta el Editor de consultas. La plantilla de consulta se muestra en el Editor de consultas para mayor comodidad. Si no hay ningún nombre de plantilla, la fila se marca con un guión y no se puede redirigir al Editor de consultas para ver la consulta.
SQL Un fragmento de la consulta SQL.
Frecuencia de ejecución La cadencia con la que se configurará la consulta para ejecutarse. Los valores disponibles son Run once y Scheduled. Las consultas se pueden filtrar según su frecuencia de ejecución.
Creado por El nombre del usuario que creó la consulta.
Creado La marca de tiempo cuando se creó la consulta, en formato UTC.
Marca de tiempo de última ejecución La marca de tiempo más reciente cuando se ejecutó la consulta. Esta columna resalta si una consulta se ha ejecutado según su programación actual.
Último estado de ejecución El estado de la ejecución de consulta más reciente. Los valores de estado son: Success, Failed, In progress, y No runs.
Estado de horario El estado actual de la consulta programada. Hay cinco valores potenciales, Registro, Activo, Inactivo, Eliminadoy un guión.
  • El guión indica que la consulta programada es una consulta única y no recurrente.
  • El Registro El estado 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 Activo El estado indica que la consulta programada tiene aún no se ha aprobado su fecha y hora de finalización.
  • El Inactivo El estado indica que la consulta programada tiene aprobado su fecha y hora de finalización.
  • El Eliminado El estado indica que se ha eliminado la programación de consultas.
SUGERENCIA

Si va al Editor de consultas, puede seleccionar Consultas para volver a la Plantillas pestaña.

Personalizar la configuración de tablas para consultas programadas

Puede ajustar las columnas en la Consultas programadas a sus necesidades. Para abrir Personalizar tabla configuración diálogo y editar columnas disponibles, seleccione el icono configuración (Un icono de configuración.), en la parte superior derecha de la pantalla.

NOTA

El Creado La columna que hace referencia a la fecha en la que se creó la programación está oculta de forma predeterminada.

La pestaña Consultas programadas con el icono Personalizar configuración de tabla resaltado.

Active las casillas de verificación correspondientes para quitar o agregar una columna de tabla. A continuación, seleccione Aplicar para confirmar sus opciones.

NOTA

Cualquier consulta creada a través de la interfaz de usuario de se convierte en una plantilla con nombre como parte del proceso de creación. El nombre de la plantilla se ve en la columna de plantilla. Si la consulta se creó mediante la API, la columna de plantilla está en blanco.

Cuadro de diálogo Personalizar configuración de tabla.

Administración de consultas programadas con acciones en línea

El Consultas programadas view 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 Desactivar programación o Habilitar programación, Eliminar programación, y Suscribirse para consultar alertas.

La pestaña Consultas programadas con los puntos suspensivos de acción en línea y el menú emergente resaltados.

Deshabilitar o habilitar una consulta programada

Para desactivar una consulta programada, seleccione los puntos suspensivos de una consulta programada que desee administrar y, a continuación, seleccione Desactivar programación en las opciones del menú emergente. Aparecerá un cuadro de diálogo para confirmar la acción. Seleccionar 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 luego seleccione Habilitar programación en las opciones disponibles.

Eliminar una consulta programada

Para eliminar una consulta programada, seleccione los puntos suspensivos de una 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. Seleccionar Eliminar para confirmar la configuración.

Una vez eliminada una consulta programada, se no se ha eliminado de la lista de consultas programadas. Las acciones dentro de la línea proporcionadas por los puntos suspensivos se eliminan y reemplazan por el icono 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.

La pestaña Consultas programadas con una consulta programada eliminada y el icono de alerta atenuado resaltado.

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 tal como se describe en la documentación.

Suscribirse a alertas

Para suscribirse a alertas para ejecuciones de consultas programadas, seleccione los puntos suspensivos de una consulta programada que desee administrar y, a continuación, seleccione Suscribirse en las opciones del menú emergente.

El Alertas se abre. El Alertas Este cuadro de diálogo le suscribe tanto a las notificaciones de IU como a las alertas de correo electrónico. Las alertas se basan en el estado de la consulta. Hay tres opciones disponibles: start, success, y failure. Marque las casillas correspondientes y seleccione Guardar para suscribirse. Puede suscribirse a las alertas siempre que no tengan un Marca de tiempo de última ejecución valor.

Cuadro de diálogo de suscripciones de alerta.

Consulte la documentación de API de suscripciones de alerta para obtener más información.

Ver los detalles de la consulta

Seleccione el icono de información (Un icono de información.) para ver el panel de detalles de la consulta. El panel de detalles contiene toda la información relevante sobre la consulta más allá de los hechos incluidos en la tabla de consultas programadas. La información adicional incluye el ID de consulta, la fecha de última modificación, el SQL de la consulta, el ID de programación y la programación definida actual.

La pestaña Consultas programadas con el icono de información y el panel de detalles resaltados.

Filtrar consultas

Puede filtrar las consultas en función de la frecuencia de ejecución. Desde el Consultas programadas pestaña, seleccione el icono de filtro (Un icono de filtro) para abrir la barra lateral del filtro.

La pestaña Consultas programadas con el icono de filtro resaltado.

Para filtrar la lista de consultas según su frecuencia de ejecución, seleccione la opción Programado o Ejecutar una vez filtrar casillas.

NOTA

Cualquier consulta que se haya ejecutado pero no programada cumple los requisitos para Ejecutar una vez.

La pestaña Consultas programadas con la barra lateral de filtro resaltada.

Una vez activados los criterios de filtro, seleccione Ocultar filtros para cerrar el panel de filtro.

La consulta ejecuta detalles de programación

Para abrir la página de detalles de la programación, seleccione un nombre de consulta en la Consultas programadas pestaña. 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.

La página de detalles de programación.

Esta información se proporciona en una tabla de cinco columnas. Cada fila indica una ejecución de consulta.

El nombre de la columna Descripción
ID de ejecución de consulta ID de ejecución de consulta para la ejecución diaria. Seleccione el ID de ejecución de consulta para ir al Resumen de ejecución de consultas.
Inicio de ejecución de consulta La marca de tiempo cuando se ejecutó la consulta. La marca de tiempo está en formato UTC.
Ejecución de consulta completa La marca de tiempo cuando se completó la consulta. La marca de tiempo está en formato UTC.
Estado El estado de la ejecución de consulta más reciente. Los tres valores de estado son: successful failed o in progress.
Conjunto de datos El conjunto de datos involucrado en la ejecución.

Los detalles de la consulta que se está programando se pueden ver en la Propiedades panel. 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.

La página de detalles de la programación con el panel de propiedades resaltado.

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.

Pantalla de detalles de la programación con un ID de ejecución resaltado.

Resumen de ejecución de consultas

El Resumen de ejecución de consultas 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 pantalla de detalles de ejecución con la sección de información general resaltada.

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.

La pantalla de detalles de ejecución con la sección de errores resaltada.

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.

Pantalla de detalles de ejecución con el icono de copia SQL resaltado.

Ejecutar detalles para consultas con bloque anónimo

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.

NOTA

Los detalles de ejecución de un bloque anónimo que utiliza el comando DROP no como una subconsulta independiente. Hay disponibles detalles de ejecución independientes para consultas CTAS, consultas ITAS e instrucciones COPY utilizadas como subconsultas de bloque anónimas. Actualmente no se admiten los detalles de ejecución del comando DROP.

Los bloques anónimos se identifican mediante el uso de una $$ prefijo antes de la consulta. Para obtener más información sobre los bloques anónimos en el servicio de consultas, consulte la documento de bloque anónimo.

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.

Información general sobre la ejecución de consultas que muestra una consulta de bloque anónima. Se resaltan las distintas pestañas de consulta.

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.

La descripción general de la ejecución de la consulta muestra una consulta de bloque anónima con el código de error de un solo bloque resaltado.

Seleccionar Consulta para volver a la pantalla de detalles de la programación, o Consultas programadas para volver a la Consultas programadas pestaña.

La pantalla de detalles de ejecución con la consulta resaltada.

En esta página