Aplanar JSON a CSV: Convertir Datos Anidados

El problema del aplanamiento

Los datos JSON de APIs reales rara vez son planos. Contienen objetos anidados dentro de objetos, arrays de elementos, y combinaciones de ambos. Convertir esta estructura jerarquica a CSV, que es inherentemente plano con filas y columnas, requiere un proceso de aplanamiento que preserve la informacion sin perder el contexto.

Un objeto JSON con un campo de direccion que contiene calle, ciudad y codigo postal necesita convertirse en tres columnas separadas en el CSV. La relacion entre estos tres campos y el objeto padre debe reflejarse en los nombres de las columnas para mantener la estructura semantica.

Los arrays anaden complejidad adicional. Un usuario con tres numeros de telefono puede representarse como tres columnas separadas telefonos_0, telefonos_1, telefonos_2, como una sola columna con los valores separados por comas, o como tres filas del CSV con los datos del usuario duplicados en cada una.

Aplanamiento con notacion de punto

La estrategia mas comun une las claves de la jerarquia con puntos. Un campo direccion.ciudad indica que el valor proviene de la propiedad ciudad dentro del objeto direccion. Esta notacion es intuitiva y permite reconstruir mentalmente la estructura original.

Para arrays, el indice numerico se incluye en la ruta: pedidos.0.producto, pedidos.0.cantidad, pedidos.1.producto, pedidos.1.cantidad. Cada elemento del array genera un conjunto de columnas con su indice en el nombre.

Los separadores alternativos al punto incluyen guiones bajos y barras. La eleccion depende de si los nombres de campo originales ya contienen puntos u otros caracteres que podrian confundirse con el separador de profundidad.

La profundidad maxima de aplanamiento puede limitarse. Si solo necesitas aplanar el primer nivel y mantener los subniveles como cadenas JSON dentro de las celdas del CSV, esto reduce el numero de columnas y simplifica el archivo resultante.

Estrategias para arrays

La indexacion crea columnas separadas para cada posicion del array. Si el array mas largo tiene 5 elementos, se crean 5 conjuntos de columnas. Los registros con arrays mas cortos tienen las columnas sobrantes vacias. Esta estrategia funciona bien cuando los arrays tienen longitudes similares y pequenas.

La desnormalizacion crea una fila por cada elemento del array, duplicando los datos del registro padre. Un usuario con 3 telefonos genera 3 filas en el CSV. Esta estrategia es ideal para analisis donde cada elemento del array necesita tratarse como un registro independiente.

La serializacion convierte el array en una cadena de texto dentro de una sola celda. Los valores se separan con un delimitador como punto y coma. Esta estrategia mantiene una fila por registro pero dificulta el analisis posterior porque los valores deben separarse de nuevo.

La eleccion entre estrategias depende del uso previsto del CSV. Para importar en una base de datos relacional, la desnormalizacion es la mas adecuada. Para revision humana en una hoja de calculo, la indexacion es mas legible. Para exportacion y backup, la serializacion preserva toda la informacion de forma compacta.

Herramientas de aplanamiento

En JavaScript, la libreria flat aplana objetos JSON con opciones de profundidad maxima y separador personalizable. Combinada con json2csv, produce archivos CSV a partir de JSON anidado con un control fino sobre el proceso.

En Python, pandas con json_normalize maneja el aplanamiento de forma declarativa. Puedes especificar que campos aplanar, como manejar los arrays y que prefijos usar para los campos anidados. El resultado es un DataFrame que se exporta a CSV directamente.

Las herramientas en linea ofrecen aplanamiento automatico con opciones visuales. Pegas el JSON, seleccionas la estrategia de aplanamiento y descargas el CSV resultante sin escribir codigo.

Usar nuestra herramienta

Nuestra herramienta Aplanar JSON a CSV convierte datos JSON anidados en CSV plano al instante. La herramienta aplana automaticamente los objetos anidados usando notacion de punto y maneja arrays con la estrategia de indexacion por defecto.

Puedes ajustar el separador, la profundidad maxima y la estrategia de manejo de arrays. Todo se procesa en tu navegador sin enviar datos a servidores externos.