- Inicio
- Herramientas
- Aplanar JSON a JSONL
Aplanar JSON a JSONL
Extrae y aplana objetos y arrays JSON anidados para convertirlos al formato JSONL (JSON Lines). Cada registro ocupa una línea independiente. Procesamiento 100% en el navegador.
JSON de entrada
Suelta aquí un archivo .json o haz clic para seleccionarlo
Admite .json y .txt
JSONL de salida
Pega o suelta un JSON anidado para aplanarlo y convertirlo a JSONL
¿Qué es el aplanamiento de JSON?
Aplanar JSON consiste en transformar una estructura JSON con muchos niveles de anidamiento en un formato plano, organizado por líneas. Las claves de los objetos anidados se expresan mediante notación de puntos (por ejemplo, address.city), y los arrays de objetos se expanden para que cada elemento tenga su propio registro en formato JSONL.
Esto resulta especialmente útil si tienes respuestas de API o exportaciones de bases de datos con estructuras anidadas complejas y necesitas convertirlas a un formato tabular plano para entrenar modelos de aprendizaje automático, convertir datos a CSV o alimentar pipelines de datos en streaming que esperan un registro por línea.
Dos formas de aplanar un array: elige según el destino de los datos
Los objetos anidados tienen una forma clara de aplanarse: unir las claves con puntos. Con los arrays, en cambio, hay que elegir una estrategia. La más adecuada depende de dónde vayas a usar los datos aplanados:
| Estrategia | [{"sku":"A"},{"sku":"B"}] se convierte en | Cuándo elegirla |
|---|---|---|
| Expansión por índice | items.0.sku = A, items.1.sku = B — una fila, más columnas | Cuando necesitas mantener el mismo número de filas que en la entrada y los arrays son cortos y de tamaño limitado |
| Expandir en filas | Dos filas, cada una con items.sku — más filas, columnas fijas | Cuando los datos van a usarse en SQL o en herramientas de análisis y cada elemento del array representa un registro independiente |
| Conservar como cadena JSON | items = "[{\"sku\":\"A\"},...]" — una celda cuyo contenido no se desglosa | Cuando el array contiene metadatos que volverás a parsear más adelante y no necesitas consultar ahora |
Cómo aplanar JSON a JSONL
Al aplanar JSON a JSONL, se extraen los registros de las estructuras anidadas y se coloca cada uno en una línea independiente de JSONL. Si tu JSON contiene un array de objetos, cada elemento ocupa una línea. Las claves de los objetos anidados se expresan mediante notación de puntos.
La herramienta funciona íntegramente en tu navegador. No se envían datos a ningún servidor. Pega tu JSON anidado o arrastra y suelta un archivo: el resultado aplanado en JSONL aparece al instante. Los campos del nivel padre se incorporan automáticamente a cada registro.
El resultado es JSONL válido, con un objeto JSON compacto por línea. Puedes copiarlo al portapapeles o descargarlo como archivo .jsonl, listo para usar en aprendizaje automático, pipelines de datos o importaciones a bases de datos.
Antes y después
Un ejemplo realista de un registro anidado y su versión plana con los arrays expandidos por índice. Fíjate en la importancia de elegir bien el separador: si usas puntos, una clave literal como "config.debug" en el JSON de origen entraría en conflicto con la ruta aplanada config.debug. Si tus claves contienen puntos, usa un guion bajo como separador:
// Antes — registro anidado:
{"user": {"id": 7, "address": {"city": "Osaka", "zip": "530-0001"}}, "tags": ["vip", "beta"]}
// Después — aplanado con separador de punto, arrays expandidos por índice:
{"user.id": 7, "user.address.city": "Osaka", "user.address.zip": "530-0001", "tags.0": "vip", "tags.1": "beta"}Aplanar los datos es el paso de preprocesamiento habitual antes de exportarlos a CSV o Excel, ya que estos formatos son tabulares y no permiten representar estructuras anidadas. Un JSON con muchos niveles de anidamiento puede generar un resultado con muchísimas columnas. Aplana primero una muestra y comprueba que el número de columnas sea razonable antes de procesar el archivo completo.
Casos de uso comunes
- Procesamiento de respuestas de API
- Aplana respuestas de API anidadas y conviértelas a JSONL para facilitar el parseo, el registro de logs y el procesamiento posterior en pipelines de datos.
- Transformación de datos ETL
- Extrae registros de exportaciones JSON complejas y aplánalos en formato JSONL para cargarlos en bases de datos o data warehouses.
- Preparación de datasets para ML
- Convierte datasets JSON anidados en los registros JSONL planos que requieren OpenAI, Hugging Face y otras plataformas de entrenamiento de ML.
- Procesamiento y análisis de logs
- Aplana archivos de logs estructurados con metadatos anidados y conviértelos a JSONL para analizarlos con herramientas como grep, jq o Elasticsearch.
- Generación de datos de prueba
- Aplana respuestas JSON simuladas de API con estructuras complejas para obtener registros JSONL individuales que puedas usar como fixtures en suites de pruebas automatizadas.
- Migración de bases de datos
- Aplana exportaciones JSON de documentos anidados de MongoDB o CouchDB para obtener registros JSONL planos e importarlos en bases de datos relacionales como PostgreSQL.
Errores comunes y soluciones
No se han encontrado registros para aplanar
Este error aparece cuando el JSON de entrada es un valor primitivo (cadena o número), un objeto vacío o un array vacío. La herramienta necesita objetos o arrays de objetos para extraer registros. Asegúrate de que tu JSON contenga al menos un objeto con pares clave-valor.
Conflictos entre claves en notación de puntos
Si tu JSON contiene una clave como "user.name" en el nivel superior y también un objeto anidado como {"user":{"name":"value"}}, ambos generan la misma clave en notación de puntos al aplanarse. El valor anidado sobrescribirá el del nivel superior. Cambia el nombre de las claves en conflicto antes de aplanar el JSON.
Referencias circulares en JSON
Aunque el formato JSON estándar no admite referencias circulares, algunos generadores de JSON pueden producir estructuras con tantos niveles de anidamiento que se les asemejan. La herramienta admite estructuras anidadas hasta una profundidad razonable, pero detiene el aplanamiento si se superan los límites de seguridad.
Preguntas frecuentes
¿Cómo se aplanan los objetos anidados?
Las claves de los objetos anidados se expresan mediante notación de puntos. Por ejemplo, {"user":{"address":{"city":"NYC"}}} se convierte en {"user.address.city":"NYC"}. Así puedes acceder a datos con muchos niveles de anidamiento como pares clave-valor planos.
¿Qué ocurre con los arrays del JSON?
Si el JSON contiene un array de objetos, cada objeto ocupa una línea independiente de JSONL. Los arrays de valores primitivos (cadenas o números) se serializan como cadenas JSON en el resultado aplanado. La herramienta detecta automáticamente el array principal que debe expandir.
¿Están seguros mis datos al aplanar el JSON?
Sí. Todo el aplanamiento se realiza localmente en tu navegador. No se envían datos a ningún servidor. El contenido de tu JSON nunca sale de tu dispositivo.
¿Puedo aplanar un JSON con distintos niveles de anidamiento?
Sí. La herramienta admite cualquier nivel de anidamiento. Los campos escalares del nivel superior se incorporan a cada registro, los objetos anidados usan notación de puntos y el array de objetos más grande se expande en líneas JSONL individuales.
¿Cómo se tratan los valores null y undefined al aplanar el JSON?
Los valores null se conservan como null en el resultado aplanado. JSON no tiene un tipo undefined, por lo que no encontrarás valores undefined. Los objetos vacíos no generan ninguna clave al aplanarse, y los arrays vacíos se serializan como arrays JSON vacíos.
¿Puedo aplanar varios archivos JSON a la vez?
Por ahora, la herramienta procesa una entrada JSON cada vez. Para aplanar varios archivos, procésalos uno a uno. Si necesitas trabajar por lotes, puedes combinar herramientas de línea de comandos como jq con esta herramienta para comprobar visualmente el resultado.
¿Cuál es la profundidad máxima de anidamiento que admite la herramienta?
La herramienta admite las profundidades de anidamiento habituales en datos JSON reales (normalmente hasta 20+ niveles). No hay un límite de profundidad fijado en el código, pero un anidamiento extremo puede generar claves muy largas en notación de puntos.
¿En qué se diferencia esta herramienta de una conversión de JSON a JSONL?
La conversión de JSON a JSONL toma cada elemento de un array del nivel superior y lo coloca en una línea independiente. Al aplanar JSON a JSONL, además se expanden las estructuras anidadas, se expresan las claves anidadas mediante notación de puntos y se incorporan los campos del nivel padre a cada registro. Usa el aplanamiento cuando necesites extraer registros de un JSON con muchos niveles de anidamiento.
Herramientas y guías relacionadas
Convierte arrays JSON al formato JSONL. Ideal para preparar datos para streaming y entrenamiento de modelos de ML.
Exporta datos JSONL a hojas de cálculo CSV para analizarlos en Excel o Google Sheets.
Convierte datos JSONL a hojas de cálculo en el formato nativo de Excel (.xlsx). Ideal para elaborar informes empresariales, analizar datos y compartirlos con personas sin perfil técnico.
Valida archivos JSONL línea por línea. Detecta al instante errores de sintaxis, problemas de codificación y fallos de formato.
Estrategias para procesar gigabytes de datos JSONL: lectura en streaming, gestión de memoria, división de archivos, compresión y herramientas online.