La orquestación es lo que ocurre en el grupo ETL/ELT del menú (Conexiones · Pipelines · Ejecuciones). Aquí es donde un pipeline se convierte en una versión publicada, recibe (o no) una agenda, se ejecuta y, cuando falla, se recupera.
La separación importa y el producto se la toma en serio:
| Objeto | Qué es | Dónde vive |
|---|---|---|
| Conexión | El acceso autorizado a un origen: dirección, parámetros y la credencial cifrada. | ETL/ELT → Conexiones |
| Pipeline | La definición de qué leer, transformar y escribir. Apunta a una conexión; nunca copia la credencial. | ETL/ELT → Pipelines |
| Versión | La foto inmutable de la definición en el momento de la publicación. | Panel de publicación del pipeline |
| Agenda | La regla de cuándo ejecutar. Eliges la hora de Brasilia; queda desactivada hasta que la actives. | Tarjeta Programación del pipeline |
| Ejecución | Una ronda concreta de esa versión, con tareas, intentos y logs. | ETL/ELT → Ejecuciones |
Publicar no es ejecutar
La primera publicación de un pipeline crea la versión 1 y deja la agenda desactivada. En ese momento no se lee, no se escribe ni se cobra nada. Activar agenda y Ejecutar ahora son dos acciones separadas, cada una con su propio clic.
Guías de este producto#
Publicar y versionar un pipeline
La primera publicación, qué cambia al actualizar un pipeline que ya está activo y qué congela la versión.
Agenda, huso horario y pausa
Activar la agenda, ejecutar ahora, pausar — y la hora de Brasilia en que se muestra todo.
Seguir una ejecución
De la ejecución a la tarea, de la tarea al intento, del intento al log correcto.
Recuperar una falla
Los cuatro alcances de recuperación y la vista previa que corresponde al efecto real.
Operación del día a día (artículos en Datos)#
Estos temas son de orquestación, pero los artículos viven en Datos desde la primera versión de la documentación. Las direcciones siguen valiendo — no se movió nada, no se rompió nada:
- Programación, reintento y DLQ — ventanas, política de reintento y cola de mensajes muertos.
- Ingesta incremental y backfill — watermark, checkpoint y reprocesamiento de un período.
- Pipeline medallón — Bronze, Silver y Gold.
- Modos de carga — completa, incremental, agregar, fusionar, reemplazar.
- Tutoriales de pipeline — full, incremental con watermark, backfill y tratamiento de fallas.
Antes de empezar#
- Necesitas ser dueño del workspace para ver Pipelines y Ejecuciones. Quien solo consume BI no ve estas pantallas.
- Ejecutar un pipeline es una acción costosa: con la suscripción atrasada, suspendida o cancelada, la ejecución se bloquea con un mensaje explícito y un enlace a Planes. Consulta Suspensión.
- La prueba de conexión sale del servidor de la aplicación; el ejecutor de los pipelines corre en otra red, con otra IP de salida. Habilita las dos en tu red.
Si algo sale mal#
| Síntoma | Próxima acción |
|---|---|
| Publiqué y no pasó nada | Es el comportamiento esperado: usa Activar agenda o Ejecutar ahora. |
| La agenda no se disparó | Verifica que esté activa (sello Agenda activa) y la hora de Brasilia que se muestra en el pipeline. |
| La ejecución falló | Abre la tarea, luego el intento, luego el log — en ese orden. |
| Reejecuté y se duplicó | Verifica el alcance elegido en la recuperación y el modo de carga del pipeline. |
| Credencial vencida | Corrígela en la conexión, una vez. Todos los pipelines que apuntan a ella pasan a usar el nuevo valor. |
Última revisión: 2026-09-16. Los ejemplos usan el workspace ficticio Comércio
Aurora Ltda (aurora). Ningún dato de cliente aparece en esta documentación.