CSV-Ausgabe
Das Beispiel-JSON erzeugt dieses CSV:
name,age,email
Alice,30,alice@example.com
Bob,25,bob@example.com
Jedes Objekt im Array wird zu einer Zeile. Die Schlüssel name, age und email werden zu Spaltenüberschriften in der Reihenfolge, wie sie im ersten Objekt erscheinen.
Wie JSON-Arrays auf CSV abgebildet werden
CSV ist grundsätzlich ein tabellarisches Format. Es erfordert ein einheitliches Spaltenset über alle Zeilen hinweg, was bedeutet, dass deine JSON-Eingabe ein Array von Objekten mit einer konsistenten Struktur sein muss.
| JSON | CSV |
|---|---|
| Array von Objekten | Zeilen mit Kopfzeile |
| Objektschlüssel | Spaltenüberschriften |
| Objektwerte | Zellenwerte |
| Fehlender Schlüssel | Leere Zelle |
| Verschachteltes Objekt | Flachgedrückter Spaltenname |
| Array-Wert | Zusammengefasster String in Zelle |
Der Konverter scannt alle Objekte im Array, sammelt die Vereinigung ihrer Schlüssel und verwendet dieses Set als Spaltenüberschriften. Jedes Objekt wird zu einer Zeile mit Werten unter dem passenden Schlüssel.
Wann JSON zu CSV konvertieren
Tabellenanalyse
Excel, Google Sheets und Numbers lesen CSV nativ. Wenn deine Daten in einer JSON-API oder Datenbank-Export leben, ermöglicht die Konvertierung zu CSV, sie in einer Tabellenkalkulation zu öffnen für Sortierung, Filterung, Pivot-Tabellen und Diagramme, ohne Code zu schreiben.
Datenimport
Die meisten Datenimport-Tools akzeptieren CSV: Datenbank-Bulk-Loader, ETL-Pipelines, CRM-Systeme und Analyseplattformen. Die Konvertierung von JSON zu CSV ermöglicht das Verschieben von Daten von einer Web-API in diese Systeme über ein Standardformat.
E-Mail und Berichterstattung
Viele Geschäftstools generieren Berichte als CSV für E-Mail-Anhänge. Wenn du ein System baust, das JSON ausgibt, erzeugt die Konvertierung zu CSV eine universell lesbare Datei, die nicht-technische Stakeholder in jeder Tabellenkalkulationsanwendung öffnen können.
Datenaustausch
CSV ist die Lingua Franca des Datenaustauschs zwischen Organisationen. Wenn du strukturierte Daten mit einem Partner teilen musst, der einen anderen Tech-Stack verwendet, vermeidet CSV Formatverhandlungen, weil jede Sprache und jedes Tool es lesen kann.
Umgang mit Grenzfällen
Kommas in Werten
CSV verwendet Kommas als Trennzeichen, daher müssen Werte, die Kommas enthalten, in Anführungszeichen gesetzt werden. Der Konverter behandelt dies automatisch: Ein Wert wie "Istanbul, Turkey" wird zu "Istanbul, Turkey" in der CSV-Zelle.
Zeilenumbrüche in Werten
Mehrzeilige JSON-Strings brechen CSV-Zeilenbegrenzungen, es sei denn, der Wert ist in Anführungszeichen. Der Konverter wickelt Werte mit Zeilenumbrüchen in doppelte Anführungszeichen, was der Standard-CSV-Escape für diesen Fall ist.
Unicode und Sonderzeichen
CSV-Dateien benötigen ordentliche Kodierung. UTF-8 ist die sichere Standardoption. Der Konverter gibt UTF-8-kodiertes CSV aus, das Excel und die meisten modernen Tools korrekt verarbeiten. Ältere Excel-Versionen auf Windows müssen die Datei möglicherweise mit BOM (Byte Order Mark) speichern, um Nicht-ASCII-Zeichen korrekt anzuzeigen.
Einschränkungen von JSON zu CSV
CSV kann hierarchische Daten nicht darstellen. Wenn dein JSON tief verschachtelte Strukturen hat, verlierst du die Verschachtelungsinformation bei der Konvertierung zu CSV. Die flachgedrückten Spaltennamen bewahren den Pfad, aber der Verbraucher muss sie zurückparsen. Für wirklich hierarchische Daten bleibe bei JSON oder konvertiere zu einem Format, das Verschachtelung unterstützt wie XML oder YAML.
Eins-zu-viele-Beziehungen (wie ein Benutzer mit mehreren Adressen) sind in CSV besonders umständlich. Entweder duplizierst du die Benutzerzeile für jede Adresse oder fassen die Adressen in einer einzelnen Zelle zusammen, beides erschwert die Nachverarbeitung.