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: conexión y credenciales

Catálogo síntoma → causa → cómo verificar → solución → prevención para conectores, prueba de conexión y credenciales de origen.

En esta página (4)

Encuentra el síntoma, confirma la causa, verifica y corrige. Si persiste, abre un ticket (Soporte) con el origen, la hora y el mensaje exacto.

Antes que nada: la prueba de conexión#

En ETL/ELT → Conexiones, usa "Probar conexión" con la credencial del origen y confirma que el descubrimiento lista las tablas esperadas. Es la verificación más rápida.

SíntomaCausa probableCómo verificarSoluciónPrevención
"Probar conexión" falla de inmediatocredencial inválida/vencidarevisa usuario/token en el conectoractualiza la credencial y prueba de nuevorota las credenciales antes del vencimiento
El conector OAuth deja de funcionar después de unos díasrefresh token no persistido en Bling/Conta Azul/HubSpoterror de auth después de un tiempovuelve a conectar el origen (nuevo OAuth)reconexión periódica por ahora
El descubrimiento no lista las tablas esperadasalcance/permiso de la credencial insuficienterevisa los alcances concedidos en el proveedorconcede el alcance de lectura necesariodocumenta los alcances mínimos por origen
ERP/sistema fiscal de Brasil rechaza (Omie/Bling/Tiny/NF-e)App Key/Secret/token/certificado incorrectosvalida las credenciales en el panel del ERPcorrige la credencial; para NF-e revisa el .pfxguarda los secretos como variables de entorno, nunca en el código
Meta Ads / Google Ads no autorizaApp Review / developer token pendienteconector en acceso limitadoespera la aprobación; úsalo dentro del alcance soportadosigue el estado en Conectores
Azure Blob no retoma desde donde se quedóla reanudación es por nombre de blobel blob ≤ último procesado se omitereordena/renombra según la política de reanudaciónnombra los blobs de forma monótona
El error parece exponer un token—nunca debería: los secretos se ocultansi un token apareció en un log/URL, rótalotrata la filtración como incidente Crítico
"Amazon S3 / traer bucket GCS del cliente" no disponibleel recurso es Roadmap (no implementado)consulta Estadousa un conector disponibleno planifiques una integración crítica sobre el Roadmap

La "carga incremental" es por watermark, no CDC

La ingesta incremental usa watermark (marca de agua por columna). El CDC verdadero (captura de cambios) es Roadmap — consulta Ingesta incremental.

Seguridad al reportar#

  • Elimina los secretos del ejemplo antes de abrir un ticket. Si un secreto se filtró en un log/URL, revócalo/rótalo primero — consulta Credenciales y rotación.

Relacionados#


Última revisión: 2026-09-08. CDC (captura de cambios) está planificado.

Enlaces relacionados