Appiattire JSON annidato in tabella con chiavi a punti

Ogni proprietà annidata riceve un percorso con notazione a punti e le posizioni degli array diventano segmenti numerici, così un identificativo d’ordine può essere richiamato sempre come orders.0.id. Il risultato è adatto a fogli di calcolo, tabelle di staging per database, log, strumenti di mappatura e qualsiasi flusso che richieda percorsi prevedibili invece di strutture annidate. L’elaborazione è deterministica, conserva i tipi JSON e rifiuta con un errore chiaro JSON non valido o una radice scalare.

Converta la struttura annidata in percorsi prevedibili

Il JSON annidato è ideale per le API perché mantiene uniti i valori correlati, ma molti strumenti di reporting e importazione richiedono una sequenza piatta di campi. Questa capacità attraversa ogni proprietà degli oggetti e ogni elemento degli array, unendo ciascun segmento con un punto. Un valore memorizzato in un oggetto customer e poi nella proprietà name diventa customer.name. Il primo elemento di un array orders viene indicato tramite orders.0, quindi il suo identificativo diventa orders.0.id. Ogni foglia viene restituita come riga con una chiave e un valore, rendendo semplice visualizzare, filtrare o trasformare l’output in colonne. L’attraversamento segue l’ordine presente nel JSON analizzato e fornisce risultati stabili per lo stesso input. Le stringhe restano stringhe, i numeri restano numeri, i booleani restano booleani e null rimane null. Oggetti e array vuoti vengono emessi come valori invece di scomparire silenziosamente, affinché l’output appiattito registri comunque che quei percorsi esistevano nel documento originale.

Prepari l’input e interpreti l’output

Fornisca il documento JSON completo come testo nel campo json. La radice deve essere un oggetto o un array. Questo requisito evita una chiave vuota ambigua per stringhe, numeri, booleani o null isolati. I nomi delle proprietà vengono usati esattamente come forniti, mentre gli indici degli array sono scritti come segmenti numerici a base zero. La risposta contiene pairs, un array le cui voci presentano i campi key e value e possono quindi essere trattate direttamente come righe di tabella. Se la radice stessa è un oggetto o array vuoto, la chiave restituita è una stringa vuota e il valore conserva quel contenitore. I punti già presenti nel nome originale di una proprietà non vengono sottoposti a escape. Per esempio, una proprietà letterale chiamata user.name produce lo stesso percorso visibile di un oggetto user annidato che contiene name. Se i dati usano nomi con punti e l’identità del percorso deve essere reversibile, rinomini tali proprietà prima dell’appiattimento oppure conservi il JSON originale insieme al risultato appiattito.

Usi le coppie piatte nei flussi di dati

Le coppie appiattite sono efficaci come rappresentazione intermedia. Un’automazione per fogli di calcolo può inserire le chiavi in una colonna e i valori in un’altra; un processo di acquisizione può ruotare percorsi selezionati nelle colonne di una riga ampia; uno strumento di confronto può indicizzare le coppie per chiave prima di verificare due documenti. I segmenti numerici degli array rendono inoltre espliciti i record ripetuti senza mescolare valori di elementi diversi. Poiché l’operazione non effettua richieste di rete e non usa valori casuali, timestamp o inferenza di modelli, testi JSON identici producono sempre output identici. Un JSON non valido genera un errore senza risultati parziali; anche un JSON scalare valido fallisce perché non rispetta il contratto oggetto-o-array. Il prezzo API è $0.002 per elemento, mentre l’esecutore nel browser può applicare localmente la stessa logica deterministica. Per documenti molto grandi, valuti un flusso in streaming o specifico per lo schema, poiché l’appiattimento crea una riga per ogni foglia primitiva o contenitore vuoto.