Appiattimento JSON

Raccomandazioni correlate

Casi d'uso

• Query e aggregazioni MongoDB: converti JSON annidato in struttura piatta con punti e usalo direttamente in find, update e pipeline di aggregazione, senza scrivere i percorsi a mano
• Esportazione CSV/Excel: dopo aver appiattito un oggetto su più livelli, importalo in un DataFrame Pandas o in Excel usando le chiavi come intestazioni di colonna, mantenendo un record per riga
• Indicizzazione Elasticsearch: i documenti piatti sono più adatti all'archiviazione e all'interrogazione nei motori di ricerca, espandendo tutti i campi array nidificati in chiavi piatte
• Debug di API: confronta la struttura annidata di richiesta e risposta; dopo l'appiattimento i nomi dei campi sono più leggibili e aiutano a individuare campi mancanti o errori di tipo
• Pre-elaborazione configurazioni: appiattisci file come package.json o settings.json in variabili d'ambiente, pronte per essere iniettate in pipeline Docker o CI
• Log e monitoraggio: appiattisci eventi di log complessi e nidificati prima di scriverli in un data warehouse, per semplificare le aggregazioni e la visualizzazione per campo

Come utilizzare

1. Incolla il JSON da elaborare nella casella di input a sinistra, oppure carica un file .json locale tramite il pulsante di upload, o clicca sull'esempio per caricare un campione annidato
2. Nella barra degli strumenti passa dalla modalità "Appiattisci" a "Ripristina" e, nelle opzioni in basso, imposta separatore, gestione degli array e profondità massima di espansione
3. Lo strumento elabora in tempo reale: l'area di output a destra mostra subito il risultato insieme al conteggio delle chiavi e alla profondità massima
4. Clicca sul pulsante Copia per salvare il risultato negli appunti, oppure su Download per salvarlo come file .json sul tuo computer

Funzionalità

• Conversione bidirezionale: supporta appiattimento e de-appiattimento JSON, per passare senza perdite tra strutture annidate e piatte
• Separatore personalizzato: punto di default, ma supporta underscore, slash, doppio underscore o qualsiasi carattere, adattandosi a diversi sistemi a valle
• Gestione array configurabile: espandili in chiavi indicizzate (es. items.0.items.1) oppure mantienili come valore singolo, per coprire sia scenari tabellari sia configurativi
• Limite di profondità massima: imposta un tetto massimo di espansione per evitare chiavi troppo lunghe in strutture molto annidate
• Statistiche in tempo reale: al termine dell'elaborazione mostra immediatamente numero di chiavi e profondità massima, per valutare la dimensione dell'output
• Elaborazione locale per la privacy: parsing e trasformazioni avvengono nel browser, dati JSON mai inviati a server, ideale per API sensibili e configurazioni di produzione
• Caricamento file ed esempi: supporta file .json e offre un esempio pronto da caricare per verificare subito la conversione
• Copia e download: copia il risultato negli appunti con un clic o scaricalo come file .json standard per elaborazioni successive

Esempi di codice

function flatten(obj, prefix = '', sep = '.') {
  return Object.entries(obj).reduce((acc, [key, value]) => {
    const newKey = prefix ? `${prefix}${sep}${key}` : key;
    if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
      Object.assign(acc, flatten(value, newKey, sep));
    } else {
      acc[newKey] = value;
    }
    return acc;
  }, {});
}

flatten({ user: { name: 'Alice', contact: { email: 'a@x.com' } } });
// => { 'user.name': 'Alice', 'user.contact.email': 'a@x.com' }

def flatten(obj, parent_key='', sep='.'):
    items = {}
    for key, value in obj.items():
        new_key = f"{parent_key}{sep}{key}" if parent_key else key
        if isinstance(value, dict):
            items.update(flatten(value, new_key, sep))
        else:
            items[new_key] = value
    return items

import json
print(json.dumps(flatten({'user': {'name': 'Alice'}}), indent=2))
# => {"user.name": "Alice"}

# Converte JSON annidato in struttura piatta con punti
jq '[paths(scalars) as $p | {"key": $p | join("."), "value": getpath($p)}] | from_entries' data.json

# Per ripristinare la struttura annidata da JSON piatto
# Serve jq 1.7+ con filtri di terze parti, oppure usa la modalità "Ripristina" di questo strumento

Domande frequenti

Risoluzione dei problemi