Saltar al contenido

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

Actualizado el 2026-10-04

Conector — servicio de consultas SQL en la nube

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.

En esta página (15)

Lea antes: ../conectores.md (mapa de estados) y fichas.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#

CampoEtiquetaTipoObligatorioObservación
projectIdProyecto de los datos (Project ID)textosíEl código del proyecto donde están las tablas (aparece en la parte superior del console).
billingModeCobro de las consultas (billing)selecciónnopor defecto: same; opciones: same / separate
billingProjectIdProyecto de facturación (Project ID)textonoaparece cuando billingMode = separate
datasetDatasettextono—
locationLocationtextono—
serviceAccountJson 🔒Clave de acceso (archivo JSON)contraseña/secretosísecreto (cifrado; cofre externo opcional); Abre el archivo .json de la cuenta de servicio y pega el contenido completo aquí.

Paso a paso#

  1. En el menú Datos → Conexiones, usa Nova conexão.
  2. Elige el conector de servicio de consultas SQL en la nube en el catálogo.
  3. Completa los campos del formulario (ver la tabla arriba).
  4. 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.
  5. Usa Salvar conexão. Guardar NO inicia ninguna ingestión.
  6. 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.
  7. 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):

text
# 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 el encrypt (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#


Última revisión: 2026-10-04. Ficha generada automáticamente del catálogo de conectores del producto.

Enlaces relacionados