Esta página es un inventario de interfaz: el texto aquí es el texto de la pantalla, literalmente. Para aprender la tarea con capturas, ve a Primera ingesta.
Dónde está: menú ETL/ELT → Pipelines.
Un pipeline trae los datos de un sistema o archivo al datalake, donde se vuelven paneles.
Crear un pipeline — el modo guiado (/sources/new)#
Nuevo pipeline abre el modo guiado: cuatro preguntas.
| Pregunta | Qué eliges |
|---|---|
| 1 · ¿De dónde vienen los datos? | Una de Tus conexiones, Enviar archivo u hoja de cálculo (CSV, JSON, Parquet) o Conectar una base de datos (registra la conexión y vuelve) |
| 2 · ¿Qué traer? | Base de datos: marca las tablas (hay búsqueda). Archivo: envía los archivos y elige Reemplazar por el nuevo o Juntar con los anteriores |
| 3 · ¿Cuándo actualizar? | Solo cuando yo lo pida, Todos los días, a una hora (hora de Brasilia) o, para archivo, Cada vez que envíe un archivo nuevo |
| 4 · Revisar y crear | Revisas la frase de resumen y el Nombre del pipeline |
En el paso 4: Crear y ejecutar ahora (crea, activa la actualización elegida y ya hace la primera carga) o Solo crear. Al final, la pantalla ¡Pipeline creado! ofrece Seguir la ejecución, Abrir el pipeline y Volver a la lista.
El modo guiado trae la tabla entera en cada ejecución. La carga solo de lo que cambió,
las transformaciones (Silver), la partición, las columnas sensibles, las alertas y las herramientas
(Google Sheets, Meta Ads, CRM) están en el modo completo: enlace Usar el modo
completo arriba (/sources/new?modo=avancado). Nuevo informe, en la barra
de la lista, también abre el modo completo.
Registrar la conexión antes de armar el pipeline#
El pipeline apunta a una conexión guardada; no guarda contraseña. En el modo guiado, Conectar una base de datos abre el asistente de cuatro pasos (Sistema, Dirección y contraseña, Probar, Listo) y, al guardar, vuelves con la conexión ya elegida. Detalles de cada campo en Pantallas de Conexiones.
Crear un pipeline en el modo completo#
- En ETL/ELT → Pipelines, haz clic en Nuevo pipeline y después en Usar el modo completo (o en Nuevo informe).
- En ¿Qué quieres crear?, elige Empezar extracción o Crear informe Gold.
- Recorre las seis etapas — Conexiones, Datos, Carga, Transformaciones, Operación, Revisión — avanzando con Continuar a Datos, Continuar a Carga y así sucesivamente.
- En la etapa Revisión, haz clic en Publicar pipeline. Queda deshabilitado mientras la revisión liste algún problema — el enlace Corregir en "{etapa}" te lleva hasta él.
- Después, Ejecutar ahora hace la primera carga; Activar agenda activa lo automático.
Publicar no carga nada: crea la versión y deja la agenda desactivada.
Recorrer las seis etapas del armado#
Conexiones → Datos → Carga → Transformaciones → Operación → Revisión
| Etapa | Qué decides | Botón para avanzar |
|---|---|---|
| 1 · Conexiones | la conexión guardada, en Tus conexiones | Continuar a Datos |
| 2 · Datos | las tablas, archivos o endpoints | Continuar a Carga |
| 3 · Carga | Full o Append, y la Columna clave de control | Continuar a Transformaciones |
| 4 · Transformaciones | las tablas Silver y las dependencias | Continuar a Operación |
| 5 · Operación | agenda, reintentos, límites y alertas | Continuar a Revisión |
| 6 · Revisión | revisas todo | Publicar pipeline |
En cualquier etapa, Guardar borrador guarda lo que armaste — y el propio botón explica el límite: "Guarda el armado. No publica, no ejecuta, no activa la programación."
Elegir entre Full y Append (etapa 3)#
- Full — "Recarga la tabla completa en cada ejecución (reemplaza todo)."
- Append — "Incluye solo los datos nuevos en cada ejecución (incremental)." Pide una Columna clave de control: una fecha o secuencia confiable.
La tarjeta Escritura en el destino — efecto real muestra, antes de publicar, las líneas Escritura, Deduplicación, Historial fuera de la ventana, Deletes en el origen y Cambio de schema. Empieza con Full y valida el incremental después.
Configurar la agenda en el armado (etapa 5)#
En Programación del pipeline, el campo Modo tiene dos opciones: Programado ("Se ejecuta a una hora fija (diario o D-1), con ventana de reprocesamiento.") y Por llegada de archivo ("Se ejecuta en cuanto el archivo llega a la landing.").
Frecuencia es Diario o D-1 (día anterior), con Hora (Brasilia) y Días hacia atrás (este último con el sello aún no aplicado: queda registrado en la ejecución, pero hoy no cambia lo que se carga). La tarjeta Próximas cinco ejecuciones muestra los próximos disparos, en hora de Brasilia, antes de activar nada.
Límites de ejecución — valen de verdad
Desde el 03/10/2026, los cuatro campos de Límites de ejecución cambian lo que pasa en la ejecución:
| Campo | Qué pasa |
|---|---|
| Reintentar si falla | Cuántas veces se repite una ejecución automática (de la agenda) que falló. 0 = no se repite. |
| Espera entre reintentos (min) | Cuánto esperar antes de intentar de nuevo. |
| Tiempo límite (min) | Pasado esto, la ejecución se cierra como falla (se verifica cada 10 min). |
| Ejecuciones simultáneas | Cuántas ejecuciones de este pipeline pueden correr al mismo tiempo. 1 es lo recomendado para una carga que reescribe la tabla. |
Una ejecución manual no se repite sola
Los reintentos valen para la agenda. Si una ejecución que tú mandaste correr falla, usa "Intentar de nuevo" en la lista de Ejecuciones. Y con el límite de ejecuciones simultáneas alcanzado, Ejecutar ahora se rechaza con el motivo.
La tarjeta Notificaciones y responsables cierra la etapa: a quién se avisa y quién es el responsable. Publicar no envía mensajes a nadie — solo la ejecución de verdad dispara correos.
Publicar el pipeline (etapa 6)#
El botón es Publicar pipeline (mientras tanto: "Publicando..."). 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."
Publicar, programar y ejecutar son tres clics diferentes
Una vez publicado, aparece Pipeline publicado — versión {N} y, con él, tres acciones separadas:
- Ejecutar ahora — "Dispara UNA ejecución. No activa la programación."
- Activar programación — "Activa la programación. No ejecuta nada ahora."
- Abrir operación
Ejecutar la primera carga#
Usa Ejecutar ahora, en el panel que aparece justo después de publicar o en la barra de operación del pipeline. Activar agenda es otra decisión, para después — y activar la agenda no recupera el historial.
Para seguir lo que se ejecutó, ve a ETL/ELT → Ejecuciones (Pantallas de Ejecuciones).
Publicar una nueva versión de un pipeline que ya existe#
En la pantalla del pipeline, la barra de operación trae el sello Versión {N} publicada (o Versión no registrada), el estado de la agenda y el sello Cambios no publicados cuando hay algo que publicar. Las acciones:
- Revisar y publicar — "Muestra origen, destino, escritura, agenda, límites y lo que cambia". Dentro de la revisión, el botón final es Publicar versión {N+1} — o Nada que publicar, cuando no cambió nada.
- Activar agenda — se vuelve Pausar agenda después de que la actives
- Ejecutar ahora
Operar las cinco etapas de la pantalla del pipeline#
| # | Etapa | Qué muestra | Acción |
|---|---|---|---|
| 1 | Conexión | de dónde vienen los datos | Abrir conexión |
| 2 | Programación | cuándo corre el pipeline | Editar |
| 3 | Capa Bronze | el dato crudo, igual al origen | Ingerir en vivo |
| 4 | Capa Silver / Capa Gold | el dato limpio / listo para análisis | Nueva Silver · Nueva Gold · Notebook |
| 5 | Alertas y detalles | a quién se avisa cuando corre | Editar |
Todo botón de acción se vuelve Cerrar mientras la etapa está abierta.
Ingerir en vivo no es Ejecutar ahora
Ejecutar ahora dispara la ejecución por la orquestación, con historial e intentos. Ingerir en vivo ejecuta la ingesta mostrando cada paso en pantalla: es para que lo veas suceder, no para ser la operación del día a día.
Configurar tabla, watermark y alertas#
En la etapa 3, por tabla: Tipo de ingesta (Full (recarga la tabla entera) / Append (solo incluye datos nuevos)), Columna clave (watermark), Columna de partición (opcional), Clusterización (hasta 4 columnas — opcional) y Columnas técnicas (linaje).
En la etapa 5: Nombre de la fuente *, Responsable, Descripción y el bloque Alertas por correo, con Correos de éxito y Correos de FALLA separados — se graba en Guardar detalles.
Encontrar un pipeline en la lista (/sources)#
Título Pipelines, subtítulo "Cada pipeline conecta una fuente (base de datos, hoja de cálculo o plataforma) y la transforma en Bronze → Silver → Gold en tu datalake."
- Búsqueda: "Buscar pipeline por nombre…" · Filtro: Todos los tipos
- Contador: "{N} pipelines · {N} de extracción · {N} informes Gold"
- Columnas: Pipeline · Estado · Agenda · Última sincronización · Volumen del mes · meta · Acciones
Cada fila trae el sello de naturaleza — Extracción o Informe Gold — y el estado: Conectada, Pausada, Error, Sincronizando o Última ejecución con fallas. Sin ninguna carga, la fecha dice Nunca sincronizada.
Lista vacía: Ninguna fuente conectada + botón Conectar fuente. Filtro sin resultado: "Ningún pipeline coincide con este filtro."
Cambiar el horario de un pipeline que ya existe#
En la pantalla del pipeline, la tarjeta Programación del pipeline tiene el botón Editar programación. El Modo tiene tres opciones:
- Solo cuando yo lo ejecute — sin agenda; usa Ejecutar ahora
- Todos los días, a una hora — con Frecuencia (Diario o D-1 (día anterior)), Hora (Brasilia) y Días hacia atrás
- Cuando llegue un archivo nuevo — solo para fuentes de archivo
Graba en Guardar programación. La tarjeta avisa el estado del interruptor: "Programación ACTIVADA — guardar aquí cambia el horario, no desactiva nada." o "Programación DESACTIVADA — nada se ejecuta automáticamente hasta que la actives…". Activar y desactivar es siempre arriba: Activar agenda / Pausar agenda.
Micro-lote: cada 5 o 15 minutos
Con Todos los días, a una hora, el campo Cadencia elige el ritmo: Lote (una vez al día) o Micro-lote (de minutos) — este con Intervalo Cada 5 minutos o Cada 15 minutos, en los planes Business y Scale. Cada ejecución trae solo lo que cambió. Un pipeline en micro-lote que deja de ejecutarse al ritmo prometido aparece como Atrasado. Ver Micro-lote.
Etapa notebook en Silver o Gold
El botón Notebook, junto a Nueva Silver / Nueva Gold, crea una etapa que ejecuta un notebook publicado: Notebook publicado, Versión, Tabla de destino, Carga, Dónde se ejecuta y Parámetros, y se guarda con Guardar etapa. Ver Etapa notebook.
Lo que la agenda dice de sí misma#
| Sello | Cuándo aparece |
|---|---|
| Agenda activa | hay horario y el interruptor está encendido |
| Agenda pausada | hay horario y el interruptor está apagado |
| Por evento | la frecuencia es Por llegada de archivo |
| Manual | no hay frecuencia ni horario — el interruptor encendido, solo, no crea agenda |
Volver a la aplicación#
- Pipelines: ETL/ELT → Pipelines
- Armar uno: Nuevo pipeline
Próxima tarea#
- Primera ingesta — el tutorial
- Pantallas de Ejecuciones — seguir lo que se ejecutó
- Publicar y versionar