Documentación Experience Platform Guía del servicio de consultas

Programaciones de consultas

Última actualización: 4 de abril de 2025

Temas:
Consultas

Creado para:

Usuario
Desarrollador

Puede automatizar las ejecuciones de consultas creando programaciones de consultas. Las consultas programadas se ejecutan en una cadencia personalizada para administrar los datos en función de la frecuencia, la fecha y la hora. También puede elegir un conjunto de datos de salida para los resultados si es necesario. Las consultas que se han guardado como plantilla se pueden programar desde el Editor de consultas.

IMPORTANT

Solo puede agregar una programación a una consulta que ya se ha creado y guardado.

Todas las consultas programadas se agregan a la lista en la ficha Consultas programadas. Desde ese espacio de trabajo, puede monitorizar el estado de todos los trabajos de consulta programados a través de la interfaz de usuario. En la ficha Consultas programadas encontrará información importante acerca de las ejecuciones de consultas y la suscripción a alertas. La información disponible incluye el estado, los detalles de la programación y los mensajes/códigos de error en caso de que falle una ejecución. Consulte el documento Supervisión de consultas programadas para obtener más información.

Este flujo de trabajo cubre el proceso de programación en la interfaz de usuario del servicio de consultas. Para obtener información sobre cómo agregar programaciones mediante la API, lea la guía de extremo de consultas programadas.

Creación de una programación de consultas

Para programar una consulta, seleccione una plantilla de consulta de la ficha Plantillas o de la columna Plantilla de la ficha Consultas programadas. Al seleccionar el nombre de la plantilla, accederá al Editor de consultas.

Si accede a una consulta guardada desde el Editor de consultas, puede crear una programación para la consulta o ver la programación de la consulta desde el panel de detalles.

TIP

Seleccione Ver programación para navegar al área de trabajo de programaciones y ver cualquier consulta programada que se ejecute de un vistazo.

Se ha resaltado el editor de consultas con Ver programación y Agregar programación.

Seleccione Agregar programación para navegar a la página de detalles de programación.

También puede seleccionar la ficha Programas debajo del nombre de la consulta.

Editor de consultas con la ficha Programaciones resaltada.

Aparecerá el espacio de trabajo programaciones. La interfaz de usuario muestra una lista de las ejecuciones programadas a las que está asociada la plantilla. Seleccione Agregar programación para crear una programación.

Espacio de trabajo de programación del Editor de consultas con la opción Agregar programación resaltada.

Añadir detalles de programación

Aparecerá la página de detalles de la programación. En esta página, puede editar diversos detalles para la consulta programada. Los detalles incluyen la frecuencia y el día de la semana de la ejecución programada de la consulta, la fecha de inicio y finalización, el conjunto de datos al que exportar los resultados y alertas de estado de la consulta.

IMPORTANT

La IU del programador de consultas no admite la programación indefinida o perpetua. Se debe especificar una fecha de finalización. No hay límite superior para la fecha de finalización.

Se resaltó el panel Detalles de programación.

Frecuencia de consulta programada

Puede elegir las siguientes opciones para Frecuencia:

Cada hora: la consulta programada se ejecutará cada hora durante el período de fecha seleccionado.
Diario: la consulta programada se ejecutará cada X días a la hora y en el período de fecha que seleccionó. Tenga en cuenta que la hora seleccionada se encuentra en UTC, y no en la zona horaria local.
Semanal: la consulta seleccionada se ejecutará los días de la semana, la hora y el período de fecha que haya seleccionado. Tenga en cuenta que la hora seleccionada se encuentra en UTC, y no en la zona horaria local.
Mensual: la consulta seleccionada se ejecutará todos los meses en el día, la hora y el período de fecha que haya seleccionado. Tenga en cuenta que la hora seleccionada se encuentra en UTC, y no en la zona horaria local.
Anualmente: la consulta seleccionada se ejecutará cada año en el día, mes, hora y período de fecha que haya seleccionado. Tenga en cuenta que la hora seleccionada se encuentra en UTC, y no en la zona horaria local.

Proporcionar detalles del conjunto de datos

Administre los resultados de la consulta añadiendo los datos a un conjunto de datos existente o creando un nuevo conjunto de datos y anexándole los datos.

Seleccione Crear y anexar a nuevo conjunto de datos para crear un conjunto de datos cuando ejecute una consulta por primera vez. Las ejecuciones posteriores siguen insertando datos en ese conjunto de datos. Por último, proporcione un nombre y una descripción para el conjunto de datos.

IMPORTANT

Dado que está usando un conjunto de datos existente o creando uno nuevo, no necesita incluir INSERT INTO o CREATE TABLE AS SELECT como parte de la consulta, ya que los conjuntos de datos ya están configurados. Si incluye INSERT INTO o CREATE TABLE AS SELECT como parte de las consultas programadas, se producirá un error.

Se han resaltado las opciones del panel Detalles de programación con detalles del conjunto de datos y Crear y anexar al nuevo conjunto de datos.

También puede seleccionar Anexar al conjunto de datos existente seguido del icono del conjunto de datos ( ).

Se resaltó el panel Detalles de programación con los detalles del conjunto de datos y la opción Anexar al conjunto de datos existente.

Aparecerá el cuadro de diálogo Seleccionar conjunto de datos de salida.

A continuación, examine los conjuntos de datos existentes o utilice el campo de búsqueda para filtrar las opciones. Seleccione la fila del conjunto de datos que desee utilizar. Los detalles del conjunto de datos se muestran en el panel de la derecha. Seleccione Listo para confirmar su elección.

Se resaltó el cuadro de diálogo Seleccionar conjunto de datos de salida con el campo de búsqueda, una fila del conjunto de datos y Listo.

Poner en cuarentena las consultas si fallan continuamente

Al crear una programación, puede inscribir la consulta en la función de cuarentena para salvaguardar los recursos del sistema y evitar posibles interrupciones. La característica de cuarentena identifica y aísla automáticamente las consultas que fallan repetidamente poniéndolas en estado En cuarentena. Al poner en cuarentena las consultas después de diez errores consecutivos, puede intervenir, revisar y corregir los problemas antes de permitir más ejecuciones. Esto contribuye a mantener la eficacia operativa y la integridad de los datos.

El área de trabajo Programaciones de consultas con Cuarentena de consultas resaltada y seleccionada como Sí.

Una vez que una consulta está inscrita para la función de cuarentena, puede suscribirse a alertas para este cambio de estado de consulta. Si una consulta programada no está inscrita en cuarentena, no aparece como una opción en el cuadro de diálogo Alertas.

También puede inscribir una consulta programada en la función de cuarentena desde las acciones en línea de la ficha Consultas programadas. Consulte la documentación de consultas de monitor para obtener más detalles.

Definir alertas para un estado de consulta programado

También puede suscribirse a alertas de consulta como parte de la configuración de consultas programadas. Puede configurar los ajustes para recibir notificaciones en diversas situaciones. Las alertas se pueden configurar para un estado en cuarentena, retrasos en el procesamiento de consultas o un cambio en el estado de la consulta. Las opciones de alerta de estado de consulta disponibles incluyen inicio, éxito y error. Las alertas se pueden recibir como notificaciones emergentes o por correo electrónico. Seleccione la casilla de verificación para suscribirse a las alertas de ese estado de consulta programada.

Panel de detalles de la programación con las opciones de alerta resaltadas.

En la tabla siguiente se explican los tipos de alertas de consulta admitidos:

Tipo de alerta

Descripción

start

Esta alerta le avisa cuando se inicia o comienza a procesarse una ejecución de consulta programada.

success

Esta alerta le informa cuando una ejecución de consulta programada se completa correctamente, lo que indica que la consulta se ejecutó sin errores.

failed

Esta alerta déclencheur cuando una ejecución de consulta programada encuentra un error o no se ejecuta correctamente. Le ayuda a identificar y abordar los problemas con prontitud.

quarantine

Esta alerta se activa cuando una ejecución de consulta programada se pone en estado de cuarentena. Una vez que una consulta está inscrita en la función de cuarentena, cualquier consulta programada que falle diez ejecuciones consecutivas se pone automáticamente en estado En cuarentena. A continuación, una consulta en cuarentena requiere su intervención para que se puedan llevar a cabo más ejecuciones. Nota: Las consultas deben estar inscritas para la función de cuarentena para que pueda suscribirse a las alertas de cuarentena.

delay

Esta alerta le notifica si hay un retraso en el resultado de una ejecución de consulta programada más allá de un umbral especificado. Puede establecer una hora personalizada que almacene en déclencheur la alerta cuando la consulta se ejecute durante ese tiempo sin completarse ni producirse errores. El comportamiento predeterminado establece una alerta durante 150 minutos después de que la consulta comience a procesarse.

NOTE

Si decide establecer una alerta Retraso en la ejecución de la consulta, debe establecer el tiempo de retraso deseado en minutos en la interfaz de usuario de Experience Platform. Introduzca la duración en minutos. El retraso máximo es de 24 horas (1440 minutos).

Para obtener una descripción general de las alertas en Adobe Experience Platform, incluida la estructura de cómo se definen las reglas de alerta, consulte la descripción general de las alertas. Para obtener instrucciones sobre la administración de alertas y reglas de alerta en la interfaz de usuario de Adobe Experience Platform, consulte la Guía de la interfaz de usuario de alertas.

Definir parámetros para una consulta parametrizada programada

Si está creando una consulta programada para una consulta parametrizada, debe establecer los valores de parámetro para estas ejecuciones de consulta.

La sección Detalles de programación del flujo de trabajo de creación de programación con la sección Parámetros de consulta resaltada.

Después de confirmar los detalles de la programación, selecciona Guardar para crear una programación. Volverá a la pestaña de programaciones de la plantilla. Esta área de trabajo muestra detalles de la programación recién creada, incluido el ID de programación, la propia programación y el conjunto de datos de salida de la programación.

Ver ejecuciones de consulta programadas

En la ficha Programaciones de la plantilla, seleccione el identificador de programación para ir a la lista de ejecuciones de consulta de la consulta recién programada.

Espacio de trabajo de programaciones con la programación recién creada resaltada.

Como alternativa, para ver una lista de las ejecuciones programadas de una plantilla de consulta, vaya a la pestaña Consultas programadas y seleccione un nombre de plantilla en la lista disponible.

La ficha Consultas programadas con una plantilla con nombre resaltada.

Aparecerá la lista de ejecuciones de consulta para esa consulta programada.

Calcular horas en el nivel de trabajo

Rastree las horas calculadas consumidas en el nivel de ejecución de consultas para sus consultas por lotes CTAS/ITAS. Esta función ofrece perspectivas sobre el uso de computación, lo que le ayuda a optimizar la asignación de recursos y mejorar el rendimiento de las consultas.

AVAILABILITY

La funcionalidad Calcular horas es exclusiva para los usuarios que hayan adquirido el SKU de Distiller de datos. Póngase en contacto con su representante de Adobe para obtener más información.

La sección de detalles del área de trabajo Consultas programadas con una lista de ejecuciones de consulta resaltada para una consulta programada.

En la tabla siguiente se describen las columnas disponibles en la sección de detalles que enumera las ejecuciones de consultas programadas.

Título de columna

Descripción

ID de ejecución de consulta

Muestra un identificador único para cada ejecución de consulta, lo que permite realizar un seguimiento y hacer referencia a ejecuciones individuales de consultas programadas.

Inicio de ejecución de consulta

Indica la fecha y hora de inicio de la ejecución de la consulta para ayudarle a monitorizar cuándo comenzó cada ejecución.

Ejecución de consulta completa

Muestra la fecha y hora de finalización de la ejecución de la consulta para proporcionar a insight la duración y el estado de ejecución.

Estado

Muestra el estado actual de la ejecución de la consulta, como Completed, Running, o Failed, para evaluar el resultado rápidamente.

Conjuntos de datos

Enumera los conjuntos de datos utilizados en la ejecución de la consulta para mostrar qué fuentes de datos participaron en la ejecución.

Calcular horas

Muestra el tiempo de cálculo utilizado para cada ejecución de consulta, medido en horas. Esto ayuda a realizar un seguimiento del uso de los recursos y optimizar el rendimiento de las consultas.

NOTE

Los datos de horas calculadas están disponibles a partir del 15/08/2024. Los datos anteriores a esta fecha aparecen como "No disponible".

Consulte la guía de consulta programada de monitor para obtener información completa sobre cómo supervisar el estado de todos los trabajos de consulta a través de la interfaz de usuario.

Seleccione un ID de ejecución de consulta de la lista para navegar a la descripción general de ejecución de consulta. Para obtener un desglose completo de la información disponible en la descripción general de la ejecución de consultas, consulte la documentación de supervisión de consultas programadas.

Para supervisar las consultas programadas mediante la API del servicio de consultas, consulte la guía de extremos de ejecución de consultas programadas.

Habilitar, deshabilitar o eliminar una programación

Puede habilitar, deshabilitar o eliminar una programación del área de trabajo de programaciones de una consulta concreta o del área de trabajo Consultas programadas que enumera todas las consultas programadas.

Para obtener acceso a la ficha Programaciones de la consulta elegida, debe seleccionar el nombre de una plantilla de consulta en la ficha Plantillas o en la ficha Consultas programadas. Se desplaza al Editor de consultas de esa consulta. En el Editor de consultas, seleccione Horarios para tener acceso al área de trabajo de programaciones.

Seleccione una programación de las filas de programaciones disponibles para rellenar el panel de detalles. Utilice el conmutador para desactivar (o activar) la consulta programada.

Eliminar consultas deshabilitadas

IMPORTANT

Debe deshabilitar la programación para poder eliminar una programación de una consulta.

Lista de programaciones de una plantilla con el panel de detalles resaltado.

Aparecerá un cuadro de diálogo de confirmación. Seleccione Deshabilitar para confirmar la acción.

Cuadro de diálogo Deshabilitar confirmación de programación.

Seleccione Eliminar una programación para eliminar la programación deshabilitada.

Espacio de trabajo de programaciones con la opción Eliminar programación resaltada.

Como alternativa, la pestaña Consultas programadas ofrece una colección de acciones en línea para cada consulta programada. Las acciones en línea disponibles incluyen Deshabilitar programación o Habilitar programación, Eliminar programación y Suscribirse a alertas para la consulta programada. Para obtener instrucciones completas sobre cómo eliminar o deshabilitar una consulta programada a través de la ficha Consultas programadas, consulte la guía de supervisión de consultas programadas.

recommendation-more-help