Selo de estado:
Preview— catálogo de diagnóstico para conectar fontes e credenciais. Atualizado em 2026-09-08. Todos os conectores estão emPreview(nenhum é GA) — ver Conectores.
Encontre o sintoma, confirme a causa, diagnostique e corrija. Se persistir, abra um chamado (Suporte) com a fonte, o horário e a mensagem exata.
Antes de tudo: teste de conexão#
Em ETL/ELT → Conexões, use "Testar conexão" com a credencial da fonte e confirme que a descoberta lista as tabelas esperadas. É o diagnóstico mais rápido.
Catálogo#
| Sintoma | Causa provável | Diagnóstico | Solução | Prevenção |
|---|---|---|---|---|
| "Testar conexão" falha na hora | credencial inválida/expirada | reveja usuário/token no conector | atualize a credencial e teste de novo | rotacione credenciais antes do vencimento |
| Conector OAuth para de funcionar após dias | refresh token não persistido (Preview) em Bling/Conta Azul/HubSpot | erro de auth após um tempo | reconecte a fonte (novo OAuth) | reconexão periódica até GA do conector |
| Descoberta não lista tabelas esperadas | escopo/permissão da credencial insuficiente | confira os escopos concedidos no provedor | conceda o escopo de leitura necessário | documente os escopos mínimos por fonte |
| ERP/Fiscal BR recusa (Omie/Bling/Tiny/NF-e) | App Key/Secret/token/certificado errados | valide as credenciais no painel do ERP | corrija a credencial; para NF-e confira o .pfx | guarde os segredos como env, nunca no código |
| Meta Ads / Google Ads não autoriza | App Review / developer token pendente | conector em Preview (limitado) | aguarde aprovação; use no escopo suportado | acompanhe o estado em Conectores |
| Azure Blob não retoma de onde parou | retomada é por nome de blob | blob ≤ último processado é pulado | reordene/renomeie conforme a política de retomada | nomeie blobs de forma monotônica |
| Erro parece expor um token | — | nunca deveria: segredos são redigidos | se um token apareceu em log/URL, rotacione | trate vazamento como incidente Crítico |
| "Amazon S3 / puxar bucket GCS do cliente" indisponível | recurso é Roadmap (não implementado) | ver Status | use um conector disponível | não planeje integração crítica sobre Roadmap |
"Carga incremental" é por watermark, não CDC
A ingestão incremental usa watermark (marca d'água por coluna). CDC
verdadeiro (captura de mudanças) é Roadmap — ver
Ingestão incremental.
Segurança ao relatar#
- Remova segredos do exemplo antes de abrir chamado. Se um segredo vazou em log/URL, revogue/rotacione primeiro — ver Credenciais e rotação.
Relacionados#
Última revisão: 2026-09-08. Estado: conectores em Preview; S3/GCS-pull e
CDC = Roadmap. Fonte: matriz de estados do produto.