Saltar al contenido

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

Actualizado el 2026-09-08

Troubleshooting: pipeline y esquema

Catálogo síntoma → causa → cómo verificar → solución → prevención para ingesta, pipeline medallón (bronze/silver/gold), retry/DLQ, watermark y cambios de esquema.

En esta página (4)

El pipeline sigue el patrón medallón: Bronze (bruto) → Silver (limpio) → Gold (mart publicado). La ejecución es asíncrona e idempotente, con retry/backoff y DLQ — consulta Pipeline medallón y Programación, retry y DLQ.

SíntomaCausa probableCómo verificarSoluciónPrevención
Pipeline "atascado" en runningjob colgado / dependencia lentarevisa la Auditoría (categoría Pipeline) y la hora del runespera la reconciliación; reprocesa el origenmonitorea los runs largos; divide las cargas grandes
Ejecución marcada como failedorigen no disponible o dato mal formadoexpande el detalle del run (error registrado)corrige el origen y vuelve a ejecutarvalida "Probar conexión" antes de programar
Run reprocesado sin duplicaridempotencia del pipelineesperado (retry seguro)nada que hacerconfía en el retry/backoff en lugar de volver a dispararlo manualmente
Origen "vacío" en un díael origen no tenía datos en la ventanarevisa el origen en el períodovuelve a ejecutar cuando el origen tenga datosalerta de freshness en la capa Gold
El incremental no trae filas nuevasel watermark ya avanzó más allá del datorevisa la columna de watermarkejecuta un backfill de la ventana necesariaelige una columna de watermark monótona
Esperabas CDC (updates/deletes)el CDC verdadero es Roadmapel incremental es por watermarkusa watermark + backfill; los deletes no se capturanconsulta Ingesta incremental
Una columna nueva en el origen no aparecióschema drift no propagadocompara el esquema del origen con el Bronzevuelve a ejecutar el descubrimiento/carga del origenestandariza el esquema en el origen
El tipo de columna cambió y rompió Silver/Goldcambio de tipo incompatiblerevisa el error de la transformaciónajusta la transformación/tipo esperadoevita cambiar tipos en el origen sin aviso
STRUCT/RECORD o array no sale en el feedlas columnas anidadas no se publicanrevisa el esquema de la tabla Goldpublica columnas planas en los martsmodela Gold con columnas planas
El job se cae por costoalcanzó el tope de volumen por consultarevisa el costo/error del runreduce el alcance/particiona el origenconsulta Costo y rendimiento

Verificación rápida#

  1. Abre la Auditoría, filtra por categoría Pipeline y el período.
  2. Ubica el run y expande el detalle (error/observación).
  3. Crúzalo con el origen (¿el origen tenía datos en la ventana?) y con el watermark.

Resultado esperado después de la corrección#

  • El run vuelve a success, el Bronze recibe las filas, y Silver/Gold se materializan sin error. El feed/dashboard pasa a reflejar el nuevo dato.

Relacionados#


Última revisión: 2026-09-08. El incremental es por watermark; CDC (captura de cambios) está planificado.

Enlaces relacionados