Selo de estado:
Preview— catálogo de diagnóstico para ingestão, pipeline medalhão e schema. Atualizado em 2026-09-08.
O pipeline segue o padrão medalhão: Bronze (bruto) → Silver (limpo) → Gold (mart publicado). A execução é assíncrona, idempotente, com retry/backoff e DLQ — ver Pipeline medalhão e Agendamento, retry e DLQ.
Catálogo#
| Sintoma | Causa provável | Diagnóstico | Solução | Prevenção |
|---|---|---|---|---|
Pipeline "preso" em running | job travado / dependência lenta | veja a Auditoria (categoria Pipeline) e o horário do run | aguarde a reconciliação; reprocesse a fonte | monitore runs longos; divida cargas grandes |
Execução marcada como failed | fonte indisponível ou dado malformado | expanda o detalhe do run (erro registrado) | corrija a fonte e reexecute | valide "Testar conexão" antes de agendar |
| Run reprocessado sem duplicar | idempotência do pipeline | esperado (retry seguro) | nada a fazer | confie no retry/backoff em vez de re-disparar manualmente |
| Fonte "vazia" num dia | origem sem dados na janela | confira a origem no período | reexecute quando a origem tiver dados | alerta de freshness na camada Gold |
| Incremental não traz linhas novas | watermark já avançou além do dado | confira a coluna de watermark | rode backfill da janela necessária | escolha uma coluna de watermark monotônica |
| Esperava CDC (updates/deletes) | CDC verdadeiro é Roadmap | incremental é por watermark | use watermark + backfill; deletes não são capturados | ver Ingestão incremental |
| Coluna nova na origem não apareceu | schema drift não propagado | compare o schema da fonte com o Bronze | reexecute a descoberta/carga da fonte | padronize o schema na origem |
| Tipo de coluna mudou e quebrou Silver/Gold | mudança de tipo incompatível | veja o erro da transformação | ajuste a transformação/tipo esperado | evite mudar tipos na origem sem aviso |
STRUCT/RECORD ou array não sai no feed | colunas aninhadas não publicadas | confira o schema da tabela Gold | publique colunas planas nos marts | modele Gold com colunas planas |
| Job cai por custo | atingiu o teto de volume por consulta | veja o custo/erro do run | reduza o escopo/particione a fonte | ver Custo e performance |
Diagnóstico rápido#
- Abra a Auditoria, filtre categoria Pipeline e o período.
- Localize o run e expanda o detalhe (erro/observação).
- Cruze com a fonte (a origem tinha dados na janela?) e com o watermark.
Resultado esperado após a correção#
- O run volta a
success, o Bronze recebe as linhas, e Silver/Gold materializam sem erro. O feed/dashboard passa a refletir o novo dado.
Relacionados#
- Pipeline medalhão
- Ingestão incremental e backfill
- Agendamento, retry e DLQ
- Troubleshooting: conexão e credenciais
Última revisão: 2026-09-08. Estado: ingestão/pipeline em Preview; CDC =
Roadmap (incremental por watermark). Fonte: matriz de estados do produto.