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.

Requisitos de cuenta para consultas programadas technical-account-user-requirements

Para que las consultas programadas se ejecuten de forma fiable, Adobe recomienda que los administradores proporcionen una cuenta técnica (con credenciales de servidor a servidor de OAuth) para crear consultas programadas. Las consultas programadas también se pueden crear con una cuenta de usuario personal, pero las consultas creadas de esta manera dejarán de ejecutarse si se elimina o deshabilita el acceso de ese usuario.

Para obtener más información sobre cómo configurar cuentas técnicas y asignar los permisos necesarios, consulte los requisitos previos de la guía de credenciales y la autenticación de API.

Para obtener instrucciones adicionales sobre la creación y configuración de una cuenta técnica, consulte:

Si solo utiliza la interfaz de usuario del servicio de consultas, asegúrese de que tiene los permisos necesarios o coordínelo con un administrador que administre cuentas técnicas. Todas las consultas programadas se agregan a la lista de la ficha Consultas programadas, donde puede supervisar el estado, programar detalles y mensajes de error para todos los trabajos de consulta programados, así como suscribirse a alertas. Para obtener más información sobre la supervisión y administración de las consultas, consulte el documento de supervisión de consultas programadas.

Este flujo de trabajo cubre el proceso de programación en la interfaz de usuario del servicio de consultas. Para aprender a agregar programaciones mediante la API, consulte 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:

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.

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:

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.

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.