Conversione fra CSV e JSON Lines (JSONL)

Converte in entrambi i sensi fra i file CSV e il formato JSON Lines, cioè JSONL, con un oggetto per riga. Il carattere separatore è a scelta e le righe con chiavi disallineate sono gestite automaticamente. La conversione avviene interamente nel navigatore e nulla viene trasmesso ad alcun servente.

Corrispondenza fra le righe del CSV e quelle del JSONL

Riga d'intestazione e riga di dati del CSV	`name,age,city` `Alice,30,Tokyo`
JSONL risultante (un oggetto per riga)	`{"name": "Alice", "age": "30", "city": "Tokyo"}`

Usando come chiavi i nomi delle colonne dell'intestazione, ogni riga di dati del CSV diventa un oggetto JSON scritto su una sola riga di JSONL. Nel verso opposto, da JSONL a CSV, l'intestazione è formata dall'unione di tutte le chiavi comparse nelle righe e i valori mancanti restano vuoti.

Che cos'è la conversione fra CSV e JSON Lines

La conversione fra CSV e JSON Lines (JSONL) trasforma dati tabulari in formato CSV in un formato con un oggetto JSON per riga, e viceversa. Questo strumento analizza il CSV con un analizzatore conforme alla norma RFC 4180, così anche un CSV complesso con virgole o ritorni a capo dentro celle fra virgolette viene letto correttamente.

Sono supportati entrambi i versi: nella conversione da CSV a JSONL i nomi delle colonne dell'intestazione diventano le chiavi, mentre nella conversione da JSONL a CSV l'intestazione è costruita dall'unione di tutte le chiavi comparse in tutte le righe. Poiché le colonne si allineano automaticamente anche quando le righe hanno un numero diverso di chiavi, lo strumento è utile sia per preparare insiemi di dati per l'apprendimento automatico sia per mettere ordine nei file di registro.

Come convertire fra CSV e JSON Lines

Scegliete il verso della conversione Usate le schede per scegliere «Da CSV a JSONL» oppure «Da JSONL a CSV», a seconda del verso desiderato.
Inserite i dati Incollate nell'area di testo il CSV o il JSON Lines da convertire. Senza dati a disposizione, fate clic su «Carica un esempio» per vederne uno.
Scegliete il carattere separatore Scegliete se il lato CSV usa virgole o tabulazioni. Scegliete la tabulazione se lavorate con un file TSV.
Controllate l'esito della conversione Il risultato compare automaticamente man mano che digitate, e il numero di elementi viene mostrato nel campo «Elementi».
Copiate il risultato Usate il pulsante «Copia» per mettere il risultato convertito negli appunti e incollarlo in un altro strumento o sistema.

Consigli per sfruttarlo al meglio

Nella conversione da JSONL a CSV, anche se il numero e l'ordine delle chiavi variano da riga a riga, l'intestazione è costruita con l'unione di tutte le chiavi comparse e le colonne vengono allineate automaticamente.
Le colonne con intestazione vuota o ripetuta prendono automaticamente una chiave nella forma col seguito dal numero di colonna, oppure con il suffisso _2, così da evitare valori perduti o sovrascritti.
Anche quando il valore è un numero, un valore logico, un oggetto annidato o un vettore, nella cella del CSV viene scritto come testo: il file si apre quindi senz'altro in Excel dopo la conversione.
Usandolo insieme agli strumenti affini di conversione da CSV a JSON e fra JSONL e vettori JSON potete muovervi liberamente fra i tre formati.
L'analizzatore è conforme alla norma RFC 4180 e gestisce virgole e ritorni a capo nelle celle racchiuse fra virgolette doppie: anche i file CSV più complessi prodotti da Excel si convertono correttamente.

Quando torna utile convertire fra CSV e JSON Lines

Preparare insiemi di dati per l'apprendimento automatico

Dati di addestramento organizzati in un foglio di calcolo possono essere convertiti in JSONL e usati direttamente come insieme per la messa a punto.

Esaminare file di registro in un foglio di calcolo

Convertire in CSV registri applicativi esportati come JSONL permette di aprirli in Excel o in un foglio di calcolo per filtrare e riepilogare i dati.

Unire dati con chiavi disallineate

Anche dati JSONL in cui ogni riga ha un numero diverso di campi vedono le proprie colonne allineate automaticamente durante la conversione in CSV, senza bisogno di sistemazioni manuali.

Preparare dati per un'interfaccia o una base di dati

I dati CSV possono essere convertiti in JSONL e immessi direttamente in un processo di importazione che legge un elemento per riga.

Termini usati in questo strumento

CSV: Sigla di Comma-Separated Values, un formato di solo testo che rappresenta dati tabulari separando i valori con virgole.
JSON Lines (JSONL): Un formato che scrive un oggetto JSON per riga. Poiché ogni riga può essere letta e scritta in modo indipendente, si presta a elaborare grandi quantità di dati in flusso continuo.
RFC 4180: La norma che definisce il formato comune di un file CSV, stabilendo come vengono trattati virgole, ritorni a capo e virgolette dentro le celle racchiuse fra virgolette doppie.
Unione delle chiavi: L'insieme completo di tutte le chiavi (nomi di colonna) comparse in più righe, senza ometterne alcuna. Nella conversione da JSONL a CSV, questa unione diventa la riga d'intestazione.
Elaborazione in flusso continuo: Elaborare i dati un elemento (una riga) alla volta, in sequenza, invece di caricare tutto in memoria in una sola volta. JSON Lines è un formato ben adatto a questo tipo di elaborazione.

Domande frequenti

Il CSV si presta a essere aperto in un foglio di calcolo per conteggi e verifiche, mentre il JSONL, elaborabile riga per riga in flusso continuo, è adatto agli insiemi di dati per l'apprendimento automatico e all'acquisizione da parte degli strumenti di raccolta dei registri. Questo strumento fa da tramite fra i due formati.

Una riga di dati, esclusa l'intestazione, corrisponde a una riga di JSONL, cioè a un oggetto JSON. I nomi delle colonne dell'intestazione diventano direttamente le chiavi dell'oggetto.

Sì. Nella conversione da JSONL a CSV si raccolgono tutte le chiavi comparse in tutte le righe e la loro unione forma l'intestazione. I valori delle chiavi assenti in una riga compaiono nel CSV come celle vuote.

Sì. Scegliendo la tabulazione come carattere separatore, lettura e scrittura avvengono direttamente in formato TSV anziché CSV.

No. La conversione avviene interamente nel JavaScript del navigatore e quanto inserite non viene mai trasmesso ad alcun servente.

A proposito — perché JSON Lines è diventato la lingua franca dell'apprendimento automatico e dei registri

Una delle ragioni principali della diffusione di JSON Lines è la distribuzione degli insiemi di dati per l'apprendimento automatico. I dati per la messa a punto dei grandi modelli linguistici constano spesso di milioni di coppie di ingresso e uscita: raccogliendoli in un unico vettore JSON non se ne potrebbe estrarre nemmeno uno prima di aver letto in memoria e analizzato l'intero file. Con JSONL, invece, ogni riga è un elemento leggibile e scrivibile in modo indipendente, e anche gli insiemi di dati enormi si possono elaborare in flusso continuo.

Anche nel mondo dei registri il formato si adatta bene. Le piattaforme di raccolta come Elasticsearch e Logstash sono progettate per acquisire via via gli eventi che le applicazioni emettono uno alla volta, e un formato in cui ciascuna riga si aggiunge e si analizza da sé si sposa con quel modello assai meglio di un vettore JSON, che costituisce un'unica struttura complessiva.

Il CSV, d'altra parte, resta tuttora molto richiesto per lo scambio di dati aziendali e per le verifiche nel foglio di calcolo. Facendo da ponte diretto fra due formati di natura tanto diversa, questo strumento risolve in un solo passaggio le situazioni in cui occorre passare dall'uno all'altro mondo: immettere in una catena di apprendimento automatico dati ricevuti in CSV, oppure esaminare in Excel registri prodotti in JSONL.

Vedi tutte le curiosità