Programaciones de consultas
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.
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 create-schedule
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.
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.
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.
Añadir detalles de programación schedule-details
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.
Frecuencia de consulta programada scheduled-query-frequency
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 dataset-details
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.
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.
También puede seleccionar Anexar al conjunto de datos existente seguido del icono del conjunto de datos ( ).
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.
Poner en cuarentena las consultas si fallan continuamente quarantine
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.
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 alerts-for-query-status
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.
En la tabla siguiente se explican los tipos de alertas de consulta admitidos:
start
success
failed
quarantine
delay
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 set-parameters
Si está creando una consulta programada para una consulta parametrizada, debe establecer los valores de parámetro para estas ejecuciones de consulta.
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 scheduled-query-runs
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.
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.
Aparecerá la lista de ejecuciones de consulta para esa consulta programada.
Calcular horas en el nivel de trabajo compute-hours
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.
En la tabla siguiente se describen las columnas disponibles en la sección de detalles que enumera las ejecuciones de consultas programadas.
Completed,
Running,
o Failed,
para evaluar el resultado rápidamente.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 delete-schedule
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
Aparecerá un cuadro de diálogo de confirmación. Seleccione Deshabilitar para confirmar la acción.
Seleccione Eliminar una programación para eliminar la programación deshabilitada.
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.