Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Actualizado el 2026-10-03

Primera ingesta (crear, publicar y ejecutar el pipeline)

Las seis etapas del armado del pipeline, la publicación de la versión 1 con la agenda desactivada, la ejecución explícita y la verificación del resultado — con la captura de cada pantalla.

En esta página (15)

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.

Lista de pipelines, con el tipo de cada uno, el conector, la situación, la agenda y la última ejecución

Crear el pipeline — el modo guiado (el camino más simple)#

Nuevo pipeline abre cuatro preguntas:

#PreguntaQué 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
4Revisar y crearCrear y ejecutar ahora o Solo crear
Nuevo pipeline en modo guiado, pregunta 1 de 4: conexiones guardadas, enviar archivo o conectar una base

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:

#EtapaQué decides en ella
1ConexionesQué conexión guardada va a referenciar el pipeline. La credencial no se copia.
2DatosQué tablas, archivos o endpoints entran, con campos, tipos y muestra cuando está autorizada.
3CargaEl modo de carga y el efecto en el destino: reemplazar, combinar y agregar no son lo mismo.
4TransformacionesLas etapas Silver/Gold compatibles con la tarea, y las dependencias en el grafo.
5OperaciónAgenda, límites, reintentos y alertas.
6RevisiónDestino, escritura, etapas de la ejecución, agenda, límites y alertas antes de publicar.
Armado del pipeline en el modo completo, etapa 1 de 6 (Conexiones): la regla única Conexiones · Datos · Carga · Transformaciones · Operación · Revisión, sobre el catálogo de orígenes

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.

Pipeline justo después de la primera publicación: el sello Versión 1 publicada, la agenda desactivada, las acciones Revisar y publicar, Activar agenda y Ejecutar ahora, y la respuesta del producto diciendo que no se disparó ninguna carga

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.

Lista de ejecuciones, con los contadores En ejecución, Falla en la última ejecución, Fallas en el período y Agendas pausadas, y la tabla de pipelines

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.

Detalle de una ejecución con falla: la grilla a la izquierda, el selector de ejecución y de intento, la tarea seleccionada y el log de ese intento

La pestaña Grafo muestra las dependencias entre las tareas de la versión ejecutada.

Grafo de una ejecución, con las tareas y sus dependencias

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).

Pipeline heredado: el panel de publicación y programación declarando “Versión no registrada”, la agenda Manual y el aviso de que la expresión cron del registro antiguo no se despacha

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íntomaQué revisarPróxima acción
Publicación bloqueadaLa validación señalada en la revisiónCorrige el elemento; no inventes una dependencia o credencial para avanzar
Publiqué y no se ejecutó nadaEl estado de la agendaComportamiento esperado — usa Ejecutar ahora o Activar agenda
No se inicióSituación de la suscripción, límite de concurrencia, permisoRevisa el mensaje en pantalla; regulariza en Planes si es un tema de cobro
Falla de autenticaciónLa conexión referenciadaCorrige en la conexión; no vuelvas a registrar la contraseña en el pipeline
Falla de schema o de escrituraContrato de entrada, mapeo, efecto en el destinoConsulta pipeline y schema
Nuevo intento pendienteLímite y horario del intentoNo dispares cargas paralelas sin necesidad
Éxito, pero panel vacíoDestino, materialización, vínculo del BI, filtros y actualización del panelConsulta Consultar un dashboard
Volví a ejecutar y se duplicóModo de carga y alcance de la recuperaciónConsulta Recuperar una falla
La ejecución histórica no muestra versiónEjecuciones anteriores al versionadoLa 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#

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.

Enlaces relacionados