Lea antes:
../conectores.md(mapa de estados) yfichas.md(índice de las fichas).
Qué es#
Conecta tu MariaDB mediante el driver MySQL y extrae tablas a nuestra cloud, según la programación. Soporta carga incremental por watermark.
Modos de ingestión soportados:
- Nós buscamos — Nosotros buscamos los datos en su fuente.
Para qué sirve#
Traer los datos de MariaDB a su datalake y ponerlos a disposición en las capas Bronze/Silver/Gold, a los modelos de BI y al wizard de preguntas en lenguaje natural.
Cuándo usar / cuándo no usar#
Use cuando necesita consolidar esta fuente en el datalake de forma programada, con aislamiento por workspace.
Evite cargas completas innecesarias en tablas grandes: prefiera la carga incremental por watermark (vea Límites y la guía de incremental).
Plan y permisos#
- Plano: núcleo del producto (los conectores forman parte de todos los planes; el límite es el número de fuentes del plan).
- Acesso: requiere workspace activo — con la suscripción en atraso, suspendida o cancelada, la ejecución queda bloqueada.
- Desligamento: la ejecución de la ingestión puede ser desactivada temporalmente (mantenimiento o incidente). Cuando esto sucede, la pantalla informa que el recurso no está disponible en este momento.
Requisitos previos#
- Un usuario somente leitura en la base, con acceso al schema/tablas deseadas.
- Rede: elija cómo llegamos a 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 o 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.
- Senha (
password) — Guardada cifrada. Después de guardarla, nadie puede verla de nuevo — ni usted. - Chave privada SSH (
sshPrivateKey)
Los secretos nunca se reexponen y pasan por la redacción en todo error/log (token crudo, URL-encoded y en JSON).
Campos del formulario#
| Campo | Rótulo | Tipo | Obrigatório | Observación |
|---|---|---|---|---|
host | Dirección del servidor | texto | sim | Nombre o IP del servidor de la base. Quien administra su sistema (TI o proveedor del ERP) sabe informarlo. |
port | Puerto | número | sim | predeterminado: 3306; Ya viene con el puerto predeterminado (3306). Cambie solo si su TI indica otro. |
database | Nombre de la base | texto | sim | El nombre de la base de datos dentro del servidor. |
schema | Schema | texto | não | Opcional. Déjelo vacío para ver todas las tablas que el usuario ve. |
user | Usuario | texto | sim | Prefiera un usuario solo de LEITURA, creado para el BI. |
password 🔒 | Senha | senha/segredo | sim | secreto (cifrado; cofre externo opcional); Guardada cifrada. Después de guardarla, nadie puede verla de nuevo — ni usted. |
oracleConnectBy | Identificar la base por | selección | não | predeterminado: service; opciones: service / sid; Su TI sabe si la base Oracle usa Service Name (más común) o SID. |
serviceName | Service Name | texto | não | aparece cuando oracleConnectBy = service |
sid | SID | texto | não | aparece cuando oracleConnectBy = sid |
network | Cómo llegamos a la base | selección | não | predeterminado: direct; opciones: direct / ssh / cloudsql / vpn; En la mayoría de los casos es “directo por internet”. Use túnel SSH si la base solo acepta acceso por la red interna. |
sshHost | Host del bastion (SSH) | texto | não | aparece cuando network = ssh |
sshPort | Puerto del bastion | número | não | predeterminado: 22; aparece cuando network = ssh |
sshUser | Usuario del bastion | texto | não | aparece cuando network = ssh |
sshPrivateKey 🔒 | Chave privada SSH | senha/segredo | não | secreto (cifrado; cofre externo opcional); aparece cuando network = ssh |
Paso a paso#
- No menu Dados → Conexões, use Nova conexão.
- Escolha MariaDB no catálogo.
- Preencha os campos do formulário (veja a tabela acima).
- 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. Una capacidad sin prueba propia para este conector aparece como No aplica, y No aplica nunca cuenta como éxito.
- Use Salvar conexão. Guardar NO inicia ninguna ingestión.
- En la tarjeta de la conexión, use Montar extração (o vaya a Orquestração → Pipelines y use 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. Después, Ativar agenda y Executar agora son acciones separadas.
Ejemplo — prueba de conexión#
Configuração de exemplo (todos os valores são fictícios; segredos aparecem mascarados):
# Exemplo sintético (valores fictícios — não são credenciais reais)
host = db.exemplo.invalid
port = 3306
database = vendas
schema = public
user = leitura_bi
password = •••••• (cifrado — nunca exibido)
oracleConnectBy = service
network = directResultado esperado#
El Testar conexão devuelve la lista de tablas/recursos descubiertos. Tras la primera carga, las filas aparecen en la capa Bronze de su workspace, listas para el pipeline.
Límites y costos#
- Paginación: tope duro por ejecución (predeterminado 10.000 páginas / 5.000.000 filas); protección anti-loop.
- Incremental por watermark: append/keyset por columna-clave. No es CDC — no captura deletes ni UPDATEs fuera de la ventana del watermark. CDC verdadero (WAL/redo/binlog) está en el Roadmap.
- Volumen estimado: ~5 GB/mes (estimación de catálogo, no medición).
- **
Seguridad#
- Escopo por workspace: cada cliente lee y escribe solo en su propio datalake (
<prefixo>_bronze/_silver/_gold); nunca hay fuga entre workspaces. - Segredos cifrados: material sensible se cifra con AES-256-GCM antes de ser almacenado. El cofre externo de credenciales es opcional y se enlaza 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: todo error/log pasa por la redacción de secretos (crudo, URL-encoded y en JSON).
- Producción no finge: un camino que caería en mock activa la guarda de producción (falla explícita en lugar de simular éxito).
Errores comunes#
- Conexión recusada / timeout — host, puerto o regla de red (allowlist/SSH/VPN) incorrectos. Revise el modo de red elegido en Cómo conectamos.
- Autenticação falhou — usuario/contraseña inválidos o usuario sin permiso de lectura en el schema.
- SSL/handshake — ajuste 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/filas; use carga incremental por watermark para reducir el volumen.
Solución de problemas#
- Use Testar conexão para aislar problemas de credencial/red antes de programar.
- Acompañe las ejecuciones en la observabilidade por conector (tasa de error, p50/p95, freshness).
- Un cambio de esquema en el origen 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— programación, 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.