Appiattisci JSON in JSONL

Estrai oggetti e array JSON annidati e appiattiscili in formato JSONL (JSON Lines). Ogni record occupa una riga distinta. 100% lato client.

Input JSON

Trascina qui un file .json oppure fai clic per selezionarlo

Formati supportati: .json, .txt

Output JSONL

Incolla o trascina un JSON annidato per appiattirlo in JSONL

Cos'è l'appiattimento di un JSON?

Appiattire un JSON significa trasformare una struttura con molti livelli di annidamento in un formato piatto, organizzato per righe. Le chiavi degli oggetti annidati vengono convertite nella notazione a punti (ad esempio, address.city) e gli array di oggetti vengono espansi, così che ogni elemento diventi un record distinto in formato JSONL.

È particolarmente utile quando hai risposte API o esportazioni di database con strutture annidate complesse e devi convertirle in un formato tabellare piatto per l'addestramento di modelli di machine learning, la conversione in CSV o le pipeline di dati in streaming che richiedono un record per riga.

Due modi per appiattire un array: scegli in base alla destinazione dei dati

Per appiattire gli oggetti annidati c'è una soluzione evidente: unire le chiavi con i punti. Con gli array, invece, occorre scegliere come procedere. La strategia giusta dipende dalla destinazione dei dati appiattiti:

Strategia[{"sku":"A"},{"sku":"B"}] diventaQuando sceglierla
Espansione per indiceitems.0.sku = A, items.1.sku = B — una riga, più colonneIl numero di righe deve rimanere uguale a quello dell'input; gli array sono brevi e hanno dimensioni limitate
Espansione in righeDue righe, ciascuna con items.sku — più righe, colonne stabiliI dati sono destinati a SQL o a strumenti di analisi in cui ogni elemento dell'array costituisce un record a sé
Mantieni come stringa JSONitems = "[{\"sku\":\"A\"},...]" — una singola cella opacaL'array contiene metadati di cui eseguirai nuovamente il parsing in seguito, anziché dati da interrogare subito

Come appiattire JSON in JSONL

L'appiattimento da JSON a JSONL estrae i record dalle strutture annidate e li converte in righe JSONL distinte. Se il tuo JSON contiene un array di oggetti, ogni elemento dell'array diventa una riga. Le chiavi degli oggetti annidati vengono espresse con la notazione a punti.

Lo strumento funziona interamente nel tuo browser: nessun dato viene inviato a un server. Incolla il tuo JSON annidato o trascina un file per ottenere subito l'output JSONL appiattito. I campi del livello padre vengono inclusi automaticamente in ogni record.

L'output è un JSONL valido, con un oggetto JSON compatto per riga. Puoi copiare il risultato negli appunti o scaricarlo come file .jsonl, pronto per il machine learning, le pipeline di dati o l'importazione in un database.

Prima e dopo

Un esempio realistico di record annidato e della sua versione piatta con gli array espansi per indice. Nota quanto conta la scelta del separatore: usando il punto, una chiave letterale come "config.debug" nei dati di origine entrerebbe in conflitto con il percorso appiattito config.debug. Se le tue chiavi contengono punti, usa l'underscore come separatore:

// Prima — record annidato:
{"user": {"id": 7, "address": {"city": "Osaka", "zip": "530-0001"}}, "tags": ["vip", "beta"]}


// Dopo — appiattito con separatore a punto, array espansi per indice:
{"user.id": 7, "user.address.city": "Osaka", "user.address.zip": "530-0001", "tags.0": "vip", "tags.1": "beta"}

L'appiattimento è il passaggio standard di pre-elaborazione prima di esportare in CSV o Excel: sono formati tabellari e non possono rappresentare strutture annidate. Input con molti livelli di annidamento possono produrre output con moltissime colonne, quindi appiattisci prima un campione e controlla che il numero di colonne sia ragionevole prima di elaborare l'intero file.

Casi d'uso comuni

Elaborazione delle risposte API
Appiattisci le risposte API annidate in JSONL per semplificare il parsing, il logging e le successive elaborazioni nelle pipeline di dati.
Trasformazione dei dati ETL
Estrai i record da esportazioni JSON complesse e appiattiscili in JSONL per caricarli in database o data warehouse.
Preparazione di dataset per il machine learning
Converti i dataset JSON annidati nei record JSONL piatti richiesti da OpenAI, Hugging Face e altre piattaforme per l'addestramento di modelli di machine learning.
Elaborazione di log e dati analitici
Appiattisci in JSONL i file di log strutturati con metadati annidati per analizzarli con strumenti come grep, jq o Elasticsearch.
Generazione di dati di test
Appiattisci risposte mock di API con strutture JSON complesse in singoli record JSONL da usare come fixture nelle suite di test automatici.
Migrazione di database
Appiattisci le esportazioni JSON annidate basate su documenti di MongoDB o CouchDB in record JSONL piatti da importare in database relazionali come PostgreSQL.

Errori comuni e soluzioni

Nessun record da appiattire

Questo errore si verifica quando il JSON di input è un valore primitivo (stringa, numero) oppure un oggetto o un array vuoto. Per estrarre i record, lo strumento ha bisogno di oggetti o array di oggetti. Assicurati che il tuo JSON contenga almeno un oggetto con coppie chiave-valore.

Conflitti tra chiavi nella notazione a punti

Se il tuo JSON contiene una chiave come "user.name" al primo livello e anche un oggetto annidato {"user":{"name":"value"}}, l'appiattimento produce la stessa chiave nella notazione a punti per entrambi. Il valore annidato sovrascrive quello del primo livello. Rinomina le chiavi in conflitto prima di appiattire il JSON.

Riferimenti circolari nel JSON

Il JSON standard non può contenere riferimenti circolari, ma alcuni generatori JSON possono produrre strutture con un annidamento così profondo da assomigliarvi. Lo strumento gestisce strutture annidate fino a una profondità ragionevole, ma interrompe l'appiattimento se vengono superati i limiti di sicurezza.

Domande frequenti

Come funziona l’appiattimento degli oggetti annidati?

Le chiavi degli oggetti annidati vengono convertite nella notazione a punti. Ad esempio, {"user":{"address":{"city":"NYC"}}} diventa {"user.address.city":"NYC"}. In questo modo puoi accedere ai dati con molti livelli di annidamento tramite coppie chiave-valore piatte.

Cosa succede agli array presenti nel JSON?

Se il JSON contiene un array di oggetti, ogni oggetto diventa una riga JSONL distinta. Gli array di valori primitivi (stringhe, numeri) vengono serializzati come stringhe JSON nell'output appiattito. Lo strumento individua automaticamente l'array principale da espandere.

I miei dati sono al sicuro durante l’appiattimento?

Sì. L'appiattimento avviene interamente in locale, nel tuo browser. Nessun dato viene inviato a un server. Il contenuto del tuo JSON non lascia mai il tuo dispositivo.

Posso appiattire un JSON con livelli di annidamento diversi?

Sì. Lo strumento gestisce qualsiasi livello di annidamento. I campi scalari del primo livello vengono inclusi in ogni record, gli oggetti annidati usano la notazione a punti e l'array di oggetti più grande viene espanso in righe JSONL distinte.

Come vengono gestiti i valori null e undefined durante l’appiattimento?

I valori null rimangono null nell'output appiattito. JSON non prevede il tipo undefined, quindi non troverai valori undefined. Gli oggetti vuoti non generano alcuna chiave durante l'appiattimento, mentre gli array vuoti vengono serializzati come array JSON vuoti.

Posso appiattire più file JSON contemporaneamente?

Al momento lo strumento elabora un solo input JSON alla volta. Per appiattire più file, elaborali uno alla volta. Per le operazioni batch, puoi usare strumenti da riga di comando come jq insieme a questo strumento per verificare visivamente il risultato.

Qual è la profondità massima di annidamento supportata dallo strumento?

Lo strumento supporta le profondità di annidamento che si incontrano comunemente nei dati JSON reali (in genere fino a 20+ livelli). Non è previsto un limite fisso di profondità, ma un annidamento estremamente profondo può produrre chiavi molto lunghe nella notazione a punti nell'output.

In cosa si differenzia questo strumento dalla semplice conversione da JSON a JSONL?

La conversione da JSON a JSONL si limita a disporre ogni elemento di un array di primo livello su una riga distinta. L'appiattimento da JSON a JSONL espande anche le strutture annidate, converte le chiavi annidate nella notazione a punti e include i campi del livello padre in ogni record. Usa l'appiattimento quando devi estrarre record da un JSON con molti livelli di annidamento.

Strumenti e guide correlati