Saltar al contenido

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

Actualizado el 2026-10-04

Dependencias entre capas y pipelines

Cómo declarar que una transformación Silver/Gold depende de otra tarea, cómo el producto resuelve esa referencia y por qué la capa siguiente no se ejecuta cuando el origen falló en la misma ejecución.

En esta página (4)

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:

RespuestaCuándoQué pasa
Identidadla referencia es exactamente la tabla de destino de la Bronze (sin acento, sin distinguir mayúsculas)es la dependencia; falló → bloquea
Aliasla referencia coincide con una forma derivada del origen (el nombre del archivo, con o sin extensión) y apunta a una única Bronzees la dependencia; falló → bloquea
Ambiguoel 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
Inexistenteninguna Bronze coincidela 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.csv y clientes.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.

Enlaces relacionados