Convertitore CSV in JSONL

Come convertire CSV in JSONL

La conversione da CSV a JSONL legge la prima riga del tuo file CSV come intestazioni di colonna, poi converte ogni riga successiva in un oggetto JSON con quelle intestazioni come chiavi.

Il nostro convertitore rileva automaticamente il delimitatore (virgola, tabulazione o punto e virgola) e gestisce i campi tra virgolette, inclusi campi contenenti virgole o nuove righe. I valori vengono tipizzati automaticamente — numeri, booleani e null vengono rilevati.

L'output è in formato JSONL valido con un oggetto JSON compatto per riga, pronto per l'uso con piattaforme di apprendimento automatico, pipeline di dati e API.

Regole di inferenza dei tipi

Una cella CSV è solo testo; trasformarla in JSON utile significa indovinare i tipi. Il convertitore segue queste regole — e ti dice come scavalcarle quando l'ipotesi distruggerebbe i dati:

Cifre → numero

Celle come 42 o 3.14 diventano numeri JSON. La trappola: valori che sembrano numerici ma non lo sono — il codice postale statunitense 00501 perderebbe gli zeri iniziali diventando il numero 501. Tutto ciò in cui gli zeri iniziali o il testo esatto contano dovrebbe restare tra virgolette nella sorgente o essere mantenuto come colonna di stringhe.

true/false → booleano

true e false, senza distinzione di maiuscole, diventano booleani JSON. Le stringhe yes, no, 0 e 1 vengono lasciate intatte — indovinare l'intento in questi casi causa più bug di quanti ne risolva.

Cella vuota → null

Le celle vuote diventano null JSON anziché stringhe vuote — il codice a valle può così usare un semplice controllo su null invece di verificare "".

Campi tra virgolette, virgole e a capo incorporati

Il quoting CSV standard viene rispettato: un campo tra virgolette può contenere virgole e perfino interruzioni di riga, e le virgolette raddoppiate ("") si risolvono in un singolo carattere di virgolette. Un campo con un a capo incorporato diventa comunque una singola riga JSONL — l'a capo viene rappresentato come \n con escape dentro la stringa JSON.

Errori comuni e soluzioni

Cos'è la conversione da CSV a JSONL?

La conversione da CSV a JSONL trasforma dati tabulari da fogli di calcolo e database nel formato JSON Lines. Ogni riga del CSV diventa un oggetto JSON separato sulla propria riga, con le intestazioni delle colonne usate come nomi delle chiavi.

Questa conversione è essenziale per preparare dati di fogli di calcolo per l'addestramento di modelli di apprendimento automatico (OpenAI, Hugging Face), caricare dati in database NoSQL e alimentare dati strutturati nelle pipeline di streaming.

La stessa conversione in pandas

Se il tuo CSV vive già in una pipeline Python, pandas fa questa conversione in due chiamate — e la sua inferenza dei dtype segue la stessa intuizione descritta sopra:

import pandas as pd

df = pd.read_csv('input.csv', dtype={'zip': 'string'})  # protegge i codici postali
df.to_json('output.jsonl', orient='records', lines=True, force_ascii=False)

L'argomento dtype è la versione pandas della regola degli zeri iniziali: dichiara esplicitamente come stringhe le colonne fragili invece di fidarti dell'inferenza. force_ascii=False mantiene leggibile il testo non ASCII invece di trasformarlo in sequenze \u.

Domande frequenti