Una ejecución no es una lista de tareas: es un grafo. La Bronze lee el origen; la Silver lee la Bronze; la Gold lee la Silver (o varias). Declarar esas dependencias es lo que le permite al producto ordenar las tareas y — más importante — no fingir éxito cuando algo se rompió antes.
Dónde se declara la dependencia#
En la etapa Transformaciones del asistente de pipeline,
cada etapa Silver/Gold dice de quién depende (depende de). La referencia es la
tabla de destino de la tarea anterior (ej.: bronze:tb_vendas), no el nombre del
archivo ni de la tabla de origen.
En la página de la ejecución, la pestaña Grafo muestra las tareas y las flechas entre ellas (seguir una ejecución).
La puerta de dependencia (lo que cambia en la práctica)#
La capa siguiente NO se ejecuta cuando el origen falló
Si la Bronze de vendas falló en esta ejecución, la Silver que depende de ella no
se ejecuta — incluso si la tabla Bronze existe en el datalake con la carga del día
anterior. Antes de esta regla, la Silver "pasaba" leyendo dato viejo y reportaba un
número que no correspondía a la carga del día. Ahora aparece como
bloqueada por dependencia, con el motivo.
Esto vale para los dos ejecutores (la ejecución programada y la ejecución manual): la regla vive en un único módulo y es la misma en los dos caminos.
Cómo se resuelve el nombre#
Para decidir si una tarea depende de una Bronze que falló, el producto compara la referencia declarada con las Bronze de la versión ejecutada, en este orden:
| Respuesta | Cuándo | Qué pasa |
|---|---|---|
| Identidad | la referencia es exactamente la tabla de destino de la Bronze (sin acento, sin distinguir mayúsculas) | es la dependencia; falló → bloquea |
| Alias | la referencia coincide con una forma derivada del origen (el nombre del archivo, con o sin extensión) y apunta a una única Bronze | es la dependencia; falló → bloquea |
| Ambiguo | el mismo alias coincide con dos Bronze (ej.: clientes.csv y clientes.json) | el producto no elige: bloquea si cualquiera de ellas falló y registra la ambigüedad |
| Inexistente | ninguna Bronze coincide | la tarea no se bloquea (no hay origen fallado), pero la ejecución registra que la dependencia declarada no existe — corrige la declaración |
El alias nunca se superpone a la identidad. Si quieres previsibilidad total, declara siempre por la tabla de destino.
Buenas prácticas#
- Nombra los destinos sin colisión. Dos orígenes con el mismo nombre base
(
clientes.csvyclientes.json) generan alias ambiguos; dales destinos distintos (tb_clientes_crm,tb_clientes_erp). - Una Gold que lee dos Silver declara las dos. El orden de ejecución sigue el grafo; la puerta considera todos los orígenes declarados.
- Una falla aguas arriba es la falla del día. Cuando una Bronze falla, trata la recuperación a partir de ella; reejecutar solo la Gold no trae dato nuevo.
Relacionado: Seguir una ejecución · Recuperar una falla · Publicar y versionar · Pipeline y medallón.