Qué vas a hacer#
Definir una carga, revisar sus etapas, publicar una versión y ejecutar la primera carga de forma explícita.
Publicar la definición y ejecutar los datos son acciones diferentes
La primera publicación crea la versión 1 y deja la agenda desactivada. No se lee ni se escribe nada en ese momento. Activar agenda y Ejecutar ahora son otras dos decisiones, cada una con su botón.
La transformación sigue la arquitectura medallón:
- Bronze — dato crudo, tal como llegó del origen.
- Silver — dato limpio y estandarizado (tipos, fechas, columnas, condicionales).
- Gold — datamart listo para BI (agregaciones, joins, modelo de negocio).
Antes de empezar#
- Una conexión autorizada (consulta Conectar la primera fuente) o un archivo en el flujo de importación soportado.
- Ser dueño del workspace: Pipelines y Ejecuciones son áreas del dueño.
- Saber qué se puede leer en el origen y dónde se puede grabar.
- Para el tutorial, usa un conjunto pequeño y sintético, con claves y valores que conozcas de antemano.
- Suscripción al día. Ejecutar es una acción cara: con atraso, suspensión o cancelación, la ejecución se bloquea con un mensaje explícito y un enlace a Planes.
- La primera carga consume recursos de nube, cobrados en créditos.
Dónde viven los pipelines#
En ETL/ELT → Pipelines. La lista muestra, por pipeline, el conector de origen, la agenda y la última ejecución — y el botón Nuevo pipeline abre el armado.
Crear el pipeline — el modo guiado (el camino más simple)#
Nuevo pipeline abre cuatro preguntas:
| # | Pregunta | Qué eliges |
|---|---|---|
| 1 | ¿De dónde vienen los datos? | Una conexión guardada, Enviar archivo u hoja de cálculo o Conectar una base de datos |
| 2 | ¿Qué traer? | Las tablas (base de datos) o los archivos — y, para archivo, si el nuevo reemplaza o se junta con los anteriores |
| 3 | ¿Cuándo actualizar? | Solo cuando yo lo pida, Todos los días, a una hora (Brasilia) o Cada vez que envíe un archivo nuevo |
| 4 | Revisar y crear | Crear y ejecutar ahora o Solo crear |
El modo guiado trae la tabla entera en cada ejecución. Para cargar solo lo que cambió, transformaciones, partición, alertas o herramientas (Google Sheets, Ads, CRM), usa Usar el modo completo, descrito más abajo.
Armar el pipeline en el modo completo — las seis etapas#
El modo completo (Usar el modo completo, o Nuevo informe en la lista) tiene una regla única de seis etapas, la misma para extracción y para informe Gold:
| # | Etapa | Qué decides en ella |
|---|---|---|
| 1 | Conexiones | Qué conexión guardada va a referenciar el pipeline. La credencial no se copia. |
| 2 | Datos | Qué tablas, archivos o endpoints entran, con campos, tipos y muestra cuando está autorizada. |
| 3 | Carga | El modo de carga y el efecto en el destino: reemplazar, combinar y agregar no son lo mismo. |
| 4 | Transformaciones | Las etapas Silver/Gold compatibles con la tarea, y las dependencias en el grafo. |
| 5 | Operación | Agenda, límites, reintentos y alertas. |
| 6 | Revisión | Destino, escritura, etapas de la ejecución, agenda, límites y alertas antes de publicar. |
Partiendo de una conexión ya guardada, el atajo equivalente es Usar en un pipeline nuevo, en el menú de la conexión en ETL/ELT → Conexiones — y, si abres el asistente de conexión desde dentro del armado, al guardar vuelves al mismo borrador con la conexión nueva ya seleccionada.
Sobre la etapa 1
La opción "— informar credenciales sueltas —" existe para casos puntuales, pero pierde la ventaja de cambiar la contraseña en un solo lugar. Prefiere referenciar una conexión.
Publicar la versión 1#
La publicación ocurre en la etapa Revisión, en el botón Publicar pipeline. A su lado, antes del clic, la pantalla dice lo que va a pasar: "Publicar crea la versión del pipeline. La agenda quedará desactivada y no se iniciará ninguna carga."
Una vez publicado, el asistente responde "Pipeline publicado — versión 1", con el sello Programación desactivada y la frase "La versión 1 de la definición está congelada. No se creó ninguna ejecución, no corrió ninguna carga y no se recuperó ningún intervalo anterior." Las tres acciones siguientes — Ejecutar ahora, Activar programación y Abrir operación — aparecen separadas, cada una con su botón.
En la pantalla del pipeline, el panel Publicación y programación muestra el mismo estado: el sello Versión 1 publicada, el estado de la agenda y tres acciones — Revisar y publicar, Activar agenda y Ejecutar ahora. El botón del medio es Activar agenda justamente porque la agenda está desactivada; solo se vuelve Pausar agenda después de que la actives.
Vocabulario de la agenda en esta pantalla
El sello de estado usa "Programación en pausa" cuando hay un horario configurado y el interruptor está apagado; la tarjeta de programación, justo debajo, usa "Programación DESACTIVADA". Son lo mismo: no se despacha nada hasta que la actives.
Ejecutar la primera carga#
Usa Ejecutar ahora. Revisa contexto, versión y destino antes de confirmar. Activar agenda es una acción separada, para después — y activar la agenda no dispara recuperación histórica.
Seguir la ejecución#
En ETL/ELT → Ejecuciones. La lista separa falla en la última ejecución (lo que pide acción ahora) de fallas en el período (historial), muestra la agenda por pipeline y muestra los horarios en hora de Brasilia.
Abre la ejecución creada y baja de Ejecución a Tarea, de Tarea a Intento y solo entonces a la pestaña Logs. El log mostrado es el de ese intento — el selector de intento está arriba, al lado del selector de ejecución.
La pestaña Grafo muestra las dependencias entre las tareas de la versión ejecutada.
Verificar el resultado en los datos#
Un estado "éxito" no sustituye la verificación. Abre Datos → Consola de datos y valida: las tablas existen, el conteo coincide con el conjunto de prueba, las claves y los valores conocidos están ahí.
Pipelines heredados (creados antes de la publicación con versiones)#
No todos los pipelines de tu workspace pasaron por este flujo. Los que se crearon antes de la publicación con versiones no tienen versión registrada, y la pantalla lo dice en vez de fingir una versión 1 retroactiva:
- el sello es "Versión no registrada", no "Versión 1 publicada";
- la agenda aparece como Manual cuando no hay frecuencia/horario definidos — aunque el interruptor de la agenda esté encendido, porque el interruptor solo no crea agenda;
- si el registro antiguo guardó una expresión cron, la pantalla declara que no se despacha: solo la programación del pipeline (frecuencia y horario) dispara la ejecución automática.
La captura de abajo es de un pipeline heredado del entorno de demostración. Está aquí para que reconozcas ese estado — no es la pantalla de una primera publicación (esa es la de la sección Publicar la versión 1).
Para llevar un pipeline heredado al versionado, usa Revisar y publicar: la publicación crea la versión a partir de la definición actual. En este camino la agenda se mantiene como está — actualizar un pipeline nunca apaga la agenda como efecto colateral.
Resultado esperado#
- Una definición publicada, identificable por versión.
- Una ejecución rastreable, con tareas, intentos y logs.
- Datos verificados en el destino, no solo un sello verde.
- La agenda permanece como la dejaste: desactivada, si no la activaste.
El fin de la ejecución no actualiza todos los paneles automáticamente
La actualización del dashboard es una etapa propia. Consulta Consultar un dashboard.
Si algo sale mal#
| Síntoma | Qué revisar | Próxima acción |
|---|---|---|
| Publicación bloqueada | La validación señalada en la revisión | Corrige el elemento; no inventes una dependencia o credencial para avanzar |
| Publiqué y no se ejecutó nada | El estado de la agenda | Comportamiento esperado — usa Ejecutar ahora o Activar agenda |
| No se inició | Situación de la suscripción, límite de concurrencia, permiso | Revisa el mensaje en pantalla; regulariza en Planes si es un tema de cobro |
| Falla de autenticación | La conexión referenciada | Corrige en la conexión; no vuelvas a registrar la contraseña en el pipeline |
| Falla de schema o de escritura | Contrato de entrada, mapeo, efecto en el destino | Consulta pipeline y schema |
| Nuevo intento pendiente | Límite y horario del intento | No dispares cargas paralelas sin necesidad |
| Éxito, pero panel vacío | Destino, materialización, vínculo del BI, filtros y actualización del panel | Consulta Consultar un dashboard |
| Volví a ejecutar y se duplicó | Modo de carga y alcance de la recuperación | Consulta Recuperar una falla |
| La ejecución histórica no muestra versión | Ejecuciones anteriores al versionado | La pantalla avisa; no trates una fecha posterior como prueba de contenido |
Límites y costos#
- Crear y publicar: R$ 0. Ejecutar consume recursos de nube (créditos).
- No publicamos tiempos de ejecución: dependen del volumen de tus datos, del origen y de la cola. No hay medición publicada.
Volver a la aplicación#
- Armar un pipeline: ETL/ELT → Pipelines
- Seguir ejecuciones: Ejecuciones
Próxima tarea#
Última revisión: 2026-09-17. Las capturas de esta página salieron de la versión
entregada, en un entorno de demostración con datos ficticios (workspace sintético
del seed del proyecto), viewport 1366×768; la ejecución con falla mostrada es una
falla provocada en la fixture, no un incidente de cliente. La procedencia de
cada imagen está en el manifiesto de capturas e2e/baseline/galeria-v3.json. Una
captura de entorno local documenta la interfaz; no comprueba la ejecución en la
nube.