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

JSON — conector

Ingiere archivos JSON — líneas (JSONL / ndjson) o un único array — 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.

En esta página (16)

Lea antes: ../conectores.md (mapa de estados) y fichas.md (índice de las fichas).


Qué es#

Ingiere archivos JSON — líneas (JSONL / ndjson) o un único array — 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:

  • Você deposita — Usted deposita los datos en nuestra cloud.

Para qué sirve#

Traer los datos de JSON a su datalake y ponerlos a disposición en las capas Bronze/Silver/Gold, en los modelos de BI y en el asistente de preguntas en lenguaje natural.

Cuándo usar / cuándo no usar#

Usar cuando necesita consolidar esta fuente en el datalake de forma agendada, con aislamiento por workspace.

Evitar enviar archivos con esquema inestable sin antes revisar el profiling y el schema drift.

Plan y permisos#

  • Plan: núcleo del producto (los 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 atrasada, suspendida o cancelada, la ejecución queda bloqueada.
  • Desactivación: la ejecución de ingestión puede desactivarse temporalmente (mantenimiento o incidente). Cuando eso ocurre, la pantalla informa que el recurso está indisponible en este momento.
  • Upload (modo "Você deposita"): el archivo va al área de recepción de su propio workspace.

Requisitos previos#

  • Los archivos que va a enviar (modo "Você deposita").

Credenciales#

Este conector no exige secretos propios (modo de carga / sin credencial en la plataforma).

Los secretos nunca se reexhiben y son redactados en cualquier error/log (token crudo, URL-encoded y en JSON).

Campos del formulario#

Modo "Você deposita" (push)

CampoEtiquetaTipoObligatorioObservación
jsonShapeFormatoselecciónnopredeterminado: lines; opciones: lines / array

Paso a paso#

  1. En el menú Dados → Conexões, use Nova conexão.
  2. Elija JSON en el catálogo y seleccione el modo de ingestión.
  3. Complete los campos del formulario (vea la tabla arriba).
  4. Envíe los archivos. Un formato de archivo solo acepta depósito — aquí no hay conexión que probar.
  5. Use Salvar conexão. Guardar NO inicia ninguna ingestión.
  6. 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.
  7. 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#

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)

Resultado 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 (por defecto 10.000 páginas / 5.000.000 filas); protección 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 grabarse. El cofre externo de credenciales es opcional y se activa 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 simula: un camino que caería en mock activa la protección de producción (falla explícita en lugar 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 array único según el archivo.

Solución de problemas#

  • Use Testar conexão para aislar problemas de credencial/red antes de agendar.
  • Siga las ejecuciones en la observabilidade por conector (tasa de error, p50/p95, freshness).
  • Un cambio de esquema en el origen se señala con el schema drift (columna nueva = info; columna eliminada/tipo cambiado = atención).

Relacionados#


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

Enlaces relacionados