Lea antes:
../conectores.md(mapa de estados) yfichas.md(índice de las fichas).
Qué es#
Ingiere archivos Parquet (formato columnar autodescriptivo), que usted envía a la zona de recepción de su entorno (modo "Você deposita"). Para leer un bucket suyo, el conector es el del propio servicio de almacenamiento.
Modos de ingestión soportados:
- Tú depositas — Usted deposita los datos en nuestra cloud.
Para qué sirve#
Traer los datos de Parquet a su datalake y disponibilizarlos a 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 agendada, con aislamiento por workspace.
Evite enviar archivos con esquema inestable sin antes verificar 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: exige workspace activo — con la suscripción en mora, suspendida o cancelada, la ejecución queda bloqueada.
- Desconexió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.
- Upload (modo "Tú depositas"): el archivo va al área de recepción de su propio workspace.
Requisitos previos#
- Los archivos que va a enviar (modo "Tú depositas").
Credenciales#
Este conector no exige secretos propios (modo de carga / sin credencial en la plataforma).
Los secretos nunca se vuelven a mostrar y pasan por la redacción en todo error/log (token en crudo, URL-encoded y en JSON).
Campos del formulario#
Modo "Tú depositas" (push)
| Campo | Rótulo | Tipo | Obligatorio | Observación |
|---|
Paso a paso#
- No menu Dados → Conexões, use Nova conexão.
- Elija Parquet en el catálogo y seleccione el modo de ingestión.
- Complete los campos del formulario (vea la tabla arriba).
- Envíe los archivos. Un formato de archivo solo acepta depósito — aquí no hay conexión que probar.
- 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 es copiada.
- 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)Resultado esperado#
El Testar conexão devuelve la lista de tablas/recursos descubiertos. Después de la primera carga, las filas aparecen en la capa Bronze de su workspace, listas para el pipeline.
Límites y costos#
- Paginación: techo duro por ejecución (por defecto 10.000 páginas / 5.000.000 filas); guarda anti-loop.
- Volumen estimado: ~0.5 GB/mes (estimación de catálogo, no medición).
- **
Seguridad#
- Alcance 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 activado por conexión; sin él, el valor cifrado queda en la base. Cambiar el valor aquí NO revoca la credencial en el origen.
- Redaction: todo 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 guardia de producción (falla explícita en vez de simular éxito).
Errores comunes#
- Delimitador/encoding (CSV) — verifique el delimitador y prefiera UTF-8; columnas pegadas suelen indicar delimitador incorrecto.
- Formato JSON — elija entre líneas (ndjson) y arreglo único según el archivo.
Solución de problemas#
- Use Testar conexão para aislar problemas de credencial/red antes de agendar.
- Acompañe las ejecuciones en la observabilidad por conector (tasa de error, p50/p95, freshness).
- Un cambio de esquema en el origen es señalado 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, techos y seguridad por workspace
Última revisión: 2026-10-04. Ficha generada automáticamente del catálogo de conectores del producto.