Lea antes:
../conectores.md(mapa de estados) yfichas.md(índice de las fichas).
Qué es#
Extrae datos de un proyecto de servicio de consultas SQL en la nube tuyo (vía SQL, con proyecto de facturación opcional) y los carga en nuestra cloud.
Modos de ingestión soportados:
- Nós buscamos — Nós buscamos los datos en tu fuente.
Para qué sirve#
Traer los datos del servicio de consultas SQL en la nube a tu datalake y ponerlos a disposición de las capas Bronze/Silver/Gold, de los modelos de BI y del asistente de preguntas en lenguaje natural.
Cuándo usar / cuándo no usar#
Usa cuando necesitas consolidar esta fuente en el datalake de forma programada, con aislamiento por workspace.
Evita enviar archivos con esquema inestable sin antes revisar el profiling y el schema drift.
Plan y permisos#
- Plan: núcleo del producto (conectores forman parte de todos los planes; el límite es el número de fuentes del plan).
- Acceso: requiere workspace activo — con la suscripción en mora, suspendida o cancelada, la ejecución queda bloqueada.
- Desactivación: la ejecución de ingestión puede ser desactivada temporalmente (mantenimiento o incidente). Cuando esto ocurre, la pantalla informa que el recurso está indisponible en este momento.
Prerrequisitos#
- Un usuario solo lectura en la base, con acceso al schema/tablas deseadas.
- Red: elige cómo llegamos hasta la base — IP pública + allowlist, túnel SSH (bastion), Cloud SQL o VPN.
Credenciales#
Campos sensibles. Están cifrados (AES-256-GCM) y nunca quedan en el config de la conexión, en la definición del pipeline, en el export ni en la DAG. Por defecto el valor cifrado queda en la base; mover la credencial de esta conexión al cofre externo de credenciales es una elección explícita, hecha por conexión después de guardar — ver ../../administracao/credenciais-e-rotacao.md.
- Clave de acceso (archivo JSON) (
serviceAccountJson) — Abre el archivo .json de la cuenta de servicio y pega el contenido completo aquí.
Los secretos nunca se vuelven a mostrar y pasan por redacción en cualquier error/log (token crudo, URL-encoded y en JSON).
Campos del formulario#
| Campo | Etiqueta | Tipo | Obligatorio | Observación |
|---|---|---|---|---|
projectId | Proyecto de los datos (Project ID) | texto | sí | El código del proyecto donde están las tablas (aparece en la parte superior del console). |
billingMode | Cobro de las consultas (billing) | selección | no | por defecto: same; opciones: same / separate |
billingProjectId | Proyecto de facturación (Project ID) | texto | no | aparece cuando billingMode = separate |
dataset | Dataset | texto | no | — |
location | Location | texto | no | — |
serviceAccountJson 🔒 | Clave de acceso (archivo JSON) | contraseña/secreto | sí | secreto (cifrado; cofre externo opcional); Abre el archivo .json de la cuenta de servicio y pega el contenido completo aquí. |
Paso a paso#
- En el menú Datos → Conexiones, usa Nova conexão.
- Elige el conector de servicio de consultas SQL en la nube en el catálogo.
- Completa los campos del formulario (ver la tabla arriba).
- Use Testar conexão. El resultado viene separado en Conectividade, Autenticação y Listagem/leitura — cada uno con OK, Falló, No aplica o No probado. Aquí la Conectividade aparece como No aplica: BigQuery es HTTPS con la API de Google, no un host:puerto — el OK viene de Listagem/leitura.
- Usa Salvar conexão. Guardar NO inicia ninguna ingestión.
- En la tarjeta de la conexión, usa Montar extração (o ve a Orquestração → Pipelines y usa Conectar fonte). El pipeline apunta a la conexión guardada — la credencial no se copia.
- En la revisión, Publicar (agenda desligada) crea la versión 1 sin ejecutar nada. Luego, Ativar agenda y Executar agora son acciones separadas.
Ejemplo — prueba de conexión#
Configuración de ejemplo (todos los valores son ficticios; los secretos aparecen enmascarados):
# Exemplo sintético (valores fictícios — não são credenciais reais)
projectId = meu-projeto-exemplo
billingMode = same
dataset = vendas
location = southamerica-east1
serviceAccountJson = •••••• (cifrado — nunca exibido)Resultado esperado#
Testar conexão devuelve la lista de tablas/recursos descubiertos. Tras la primera carga, las filas aparecen en la capa Bronze de tu workspace, listas para el pipeline.
Límites y costos#
- Paginación: tope duro por ejecución (default 10.000 páginas / 5.000.000 líneas); protección anti-loop.
- Volumen estimado: ~5 GB/mes (estimación de catálogo, no medición).
- **
Seguridad#
- Ámbito por workspace: cada cliente lee y escribe solo en su propio datalake (
<prefixo>_bronze/_silver/_gold); nunca hay fuga entre workspaces. - Secretos cifrados: material sensible se cifra con AES-256-GCM antes de guardarse. El cofre externo de credenciales es opcional y se conecta por conexión; sin él, el valor cifrado queda en la base. Cambiar el valor aquí NO revoca la credencial en el origen.
- Redacción: cualquier error/log pasa por la redacción de secretos (crudo, URL-encoded y en JSON).
- Producción no simula: un camino que caería en mock activa la protección de producción (fallo explícito en vez de simular éxito).
Errores comunes#
- Conexión recusada / timeout — host, puerto o regla de red (allowlist/SSH/VPN) incorrectos. Revisa el modo de red elegido en Como conectamos.
- Autenticação falhou — usuario/contraseña inválidos o usuario sin permiso de lectura en el schema.
- SSL/handshake — ajusta el
sslmode(PostgreSQL) o elencrypt(SQL Server) según la exigencia del servidor. - Tabela/consulta grande — la extracción respeta el tope de páginas/líneas; usa carga incremental por watermark para reducir el volumen.
Solución de problemas#
- Usa Testar conexão para aislar problemas de credencial/red antes de programar.
- Sigue las ejecuciones en la observabilidad por conector (tasa de error, p50/p95, freshness).
- Un cambio de esquema en la fuente se señala por el schema drift (columna nueva = info; columna removida/tipo cambiado = atención).
Relacionados#
../conectores.md— catálogo de conectores por estado../ingestao-incremental-backfill.md— full, incremental por watermark, backfill y checkpoint../pipeline-medalhao.md— capas Bronze/Silver/Gold y calidad../agendamento-retry-dlq.md— agendamiento, retry/backoff y DLQ../custo-limites-seguranca.md— costo, topes y seguridad por workspace
Última revisión: 2026-10-04. Ficha generada automáticamente del catálogo de conectores del producto.