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"}] diventa | Quando sceglierla |
|---|---|---|
| Espansione per indice | items.0.sku = A, items.1.sku = B — una riga, più colonne | Il numero di righe deve rimanere uguale a quello dell'input; gli array sono brevi e hanno dimensioni limitate |
| Espansione in righe | Due righe, ciascuna con items.sku — più righe, colonne stabili | I dati sono destinati a SQL o a strumenti di analisi in cui ogni elemento dell'array costituisce un record a sé |
| Mantieni come stringa JSON | items = "[{\"sku\":\"A\"},...]" — una singola cella opaca | L'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
Converti gli array JSON in formato JSONL. Ideale per preparare dati per lo streaming e l’addestramento di modelli di machine learning.
Esporta i dati JSONL in fogli di calcolo CSV. Ideale per le analisi in Excel o Google Sheets.
Converti i dati JSONL in fogli di calcolo nel formato nativo di Excel (.xlsx). Ideale per report aziendali, analisi dei dati e condivisione con interlocutori non tecnici.
Valida i file JSONL riga per riga. Individua subito errori di sintassi e problemi di codifica o di formato.
Strategie per elaborare gigabyte di dati JSONL: lettura in streaming, gestione della memoria, suddivisione dei file, compressione e strumenti online.