KI auf dem Gerät – professionell und privat.

Dokumente

JSON-Dateien online zusammenführen (und was bei Schlüsselkonflikten passiert)

Mehrere JSON-Dateien zu einer zusammenführen: tief oder flach, vier Wege für Arrays und ein Bericht über jeden überschriebenen Wert. Kostenlos bis 5 Dateien.

Aktualisiert am 8. November 20269 Min. Lesezeit

Um JSON-Dateien zusammenzuführen, fügen Sie sie der JSON-Zusammenführung in der Reihenfolge hinzu, in der sie angewendet werden sollen, wählen Tiefe Zusammenführung oder Flache Zusammenführung, legen fest, was mit Arrays geschehen soll, und klicken auf JSON zusammenführen. Das Ergebnis wird als eine Datei heruntergeladen. Die Reihenfolge ist die Regel für Konflikte: Wenn zwei Dateien denselben Schlüssel setzen, gewinnt die spätere, und der Tab Konflikte listet jeden überschriebenen Wert mit altem und neuem Wert auf. Der kostenlose Tarif nimmt bis zu 5 Dokumente, je 10 MB und insgesamt 30 MB, und alles läuft auf Ihrem Gerät, nicht auf unseren Servern. Der Rest dieser Anleitung erklärt, welche Einstellungen zu welcher Aufgabe passen, denn „zusammenführen“ bedeutet je nach Inhalt Ihrer Dateien drei recht unterschiedliche Dinge.

JSON-Dateien zusammenführen: drei verschiedene Aufgaben

Bevor Sie Einstellungen wählen, sehen Sie sich die äußersten Klammern Ihrer Dateien an. Eine Datei, die mit { beginnt, ist ein Objekt (benannte Schlüssel); eine, die mit [ beginnt, ist ein Array (eine Liste). Was Sie von der Zusammenführung brauchen, hängt davon ab und davon, ob die Dateien dieselben Dinge beschreiben oder verschiedene.

Ihre DateienWas Sie möchtenEinstellungen
Objekte: eine Basiskonfiguration plus ÜberschreibungenÜberschreibungen ändern nur die Schlüssel, die sie nennenTiefe Zusammenführung, Arrays: Ersetzen
Arrays: mehrere Listen von Datensätzen oder LogeinträgenEine lange Liste mit allemArrays: Aneinanderhängen
Arrays mit Tags oder Werten, die sich wiederholenEine Liste, jeder Wert nur einmalArrays: Vereinigung
Zwei Exporte derselben Datensätze mit unterschiedlichen FeldernEin Datensatz pro id mit allen FeldernArrays: Nach Schlüssel, Schlüsselfeld: id
Objekte, deren verschachtelte Abschnitte komplett ausgetauscht werden sollenEin späterer Abschnitt ersetzt den früheren vollständigFlache Zusammenführung

Das Werkzeug akzeptiert jede JSON-Wurzel, Sie können also Objekte mit Objekten, Arrays mit Arrays oder beides gemischt zusammenführen. Wenn die zwei Werte an derselben Stelle unterschiedliche Typen haben (ein Objekt trifft auf ein Array, eine Zahl auf einen Text), lassen sie sich nicht kombinieren: Der spätere ersetzt den früheren, und die Ersetzung wird als Konflikt festgehalten.

JSON-Dateien zu einer kombinieren, Schritt für Schritt

1

Die Dokumente hinzufügen

Ziehen Sie bis zu fünf Dateien im Format .json, .jsonc, .jsonl oder .ndjson in das Werkzeug zum Zusammenführen von JSON, oder klicken Sie auf JSON einfügen, um ein Dokument einzutippen oder einzufügen. Dateien und eingefügter Text lassen sich mischen.

2

Die Reihenfolge festlegen

Das erste Dokument ist die Basis, und jedes weitere wird darübergelegt. Verschieben Sie die Zeilen mit den Pfeilen nach oben oder unten, sodass die Datei, deren Werte gewinnen sollen, ganz unten steht.

3

Festlegen, wie Objekte kombiniert werden

Unter Objekte kombiniert Tiefe Zusammenführung verschachtelte Objekte Schlüssel für Schlüssel; Flache Zusammenführung kombiniert nur die Schlüssel der obersten Ebene und ersetzt verschachtelte Objekte als Ganzes. Tief ist die Voreinstellung.

4

Festlegen, wie Arrays kombiniert werden

Wählen Sie unter Arrays Ersetzen, Aneinanderhängen, Vereinigung oder Nach Schlüssel. Für Nach Schlüssel geben Sie das Schlüsselfeld ein, das einen Datensatz kennzeichnet (Standard: id). Stellen Sie null-Werte auf Ignorieren, wenn ein null in einer späteren Datei nie einen Wert löschen darf.

5

Zusammenführen und prüfen

Klicken Sie auf JSON zusammenführen. Im Tab Konflikte sehen Sie, was überschrieben wurde, im Tab Eingaben doppelte Schlüssel oder Präzisionswarnungen aus jeder Quelle.

6

Herunterladen oder kopieren

Wählen Sie eine Einrückung (Minimiert, 2 Leerzeichen, 4 Leerzeichen oder Tabulator) und ein Format (JSON, oder NDJSON, wenn das Ergebnis ein Array ist), und klicken Sie dann auf JSON herunterladen oder Kopieren.

Tiefe oder flache Zusammenführung, vier Array-Strategien, eine Regel für null und ein Konfliktbericht, alles kostenlos. Kostenlos: bis zu 5 Dokumente, je 10 MB und insgesamt 30 MB. Pro: bis zu 100 Dokumente, begrenzt nur durch Ihr Gerät, dazu Auslieferung als ZIP.

JSON-Dateien zusammenführen

Tiefe oder flache Zusammenführung

Nehmen Sie eine Basisdatei {"server": {"host": "localhost", "port": 8080}} und eine Überschreibung {"server": {"port": 9090}}. Mit Tiefer Zusammenführung ist das Ergebnis {"server": {"host": "localhost", "port": 9090}}: Das Werkzeug geht in server hinein und ändert nur den Schlüssel, den die Überschreibung nennt. Mit Flacher Zusammenführung ist das Ergebnis {"server": {"port": 9090}}: Das ganze server-Objekt der späteren Datei ersetzt das frühere, und host ist weg.

Tief ist das Richtige für geschichtete Konfigurationen (Basis, dann Produktion, dann lokale Überschreibungen), für Übersetzungsdateien, die auf mehrere Teams verteilt sind, und für Testdaten, bei denen jeder Fall nur wenige Felder ändert. Flach passt, wenn jeder Abschnitt der obersten Ebene eine abgeschlossene Einheit ist und eine spätere Datei einen vollständigen Ersatz liefern soll, etwa einen ganzen database-Block für eine andere Umgebung.

JSON-Arrays kombinieren: ersetzen, aneinanderhängen, vereinigen oder nach Schlüssel

Es gibt nicht den einen richtigen Weg, zwei Listen zusammenzuführen, deshalb fragt das Werkzeug nach. Die Einstellung gilt überall, wo zwei Arrays aufeinandertreffen: an der Wurzel der Datei und an jedem verschachtelten Pfad im tiefen Modus (oder an einem Schlüssel der obersten Ebene im flachen Modus).

  • Ersetzen (Voreinstellung): Das spätere Array gewinnt vollständig. [1, 2] und [3] ergeben [3].
  • Aneinanderhängen: alle Elemente beider Arrays, in Reihenfolge, Duplikate eingeschlossen. [1, 2] und [2, 3] ergeben [1, 2, 2, 3]. Geeignet für Logs, Ereignisse und Datensatz-Exporte, die sich nicht überschneiden.
  • Vereinigung: beide Arrays verbunden, danach wiederholte Elemente entfernt. [1, 2] und [2, 3] ergeben [1, 2, 3]. Objekte werden nach Inhalt verglichen, sodass {"a":1,"b":2} und {"b":2,"a":1} als dasselbe Element gelten.
  • Nach Schlüssel: Datensätze mit demselben Wert im Schlüsselfeld werden Feld für Feld kombiniert; Datensätze mit einem neuen Schlüssel werden am Ende angehängt; Elemente, die keine Objekte sind oder den Schlüssel nicht haben, werden unverändert angehängt.

Nach Schlüssel vergleicht den Typ ebenso wie den Wert. Ein Datensatz mit "id": 1 und einer mit "id": "1" sind verschiedene Datensätze und werden nicht verbunden. Wenn Ihre beiden Exporte uneins sind, ob ids Zahlen oder Texte sind, korrigieren Sie zuerst einen davon, sonst enthält das Ergebnis beide Versionen nebeneinander.

Was bei einem Schlüsselkonflikt genau passiert

Ein Konflikt ist jede Stelle, an der ein späteres Dokument einen Wert ersetzt hat, statt mit ihm zusammengeführt zu werden. Das sind die Regeln, denen das Werkzeug folgt, vollständig:

  1. 1Ein Schlüssel, der nur in einem Dokument vorkommt, wird unverändert übernommen. Nichts geht verloren, nichts wird gemeldet.
  2. 2Zwei Objekte am selben Pfad werden Schlüssel für Schlüssel zusammengeführt (im flachen Modus nur auf der obersten Ebene).
  3. 3Zwei Arrays am selben Pfad folgen der Einstellung Arrays.
  4. 4Alles andere, etwa zwei verschiedene Zahlen, ein Text, der auf ein Objekt trifft, oder ein Objekt, das bei flacher Zusammenführung auf ein Objekt trifft, wird durch den späteren Wert ersetzt und als Konflikt festgehalten.
  5. 5Ein späteres Dokument, das genau denselben Wert schreibt, ist kein Konflikt; der Bericht zeigt also nur echte Änderungen.
  6. 6Ein ausdrückliches null in einer späteren Datei überschreibt standardmäßig, denn null ist ein echter JSON-Wert. Mit null-Werte auf Ignorieren wird es übersprungen, und der Bericht zählt, wie viele null ignoriert wurden.

Der Tab Konflikte zeigt jeden als eine Zeile: den Pfad (etwa $.server.port), den bisherigen Wert, den neuen Wert und das Dokument, aus dem er stammt. Die ersten 500 Konflikte werden vollständig aufgelistet, der Zähler läuft darüber hinaus weiter. Meldet der Tab, dass nichts überschrieben wurde, steckt jeder Wert aus jedem Dokument im Ergebnis.

Die Schlüsselreihenfolge folgt standardmäßig dem Basisdokument; Schlüssel, die nur in späteren Dateien vorkommen, werden am Ende ergänzt, was den Diff in der Versionsverwaltung klein hält. Wählen Sie Schlüsselreihenfolge: A-Z, wenn Sie unabhängig von der Schreibweise der Eingaben immer dieselbe Ausgabe möchten.

Was schiefgehen kann und was Sie tun können

Was Sie sehenWarumLösung
Eine Zeile nennt Zeile und Spalte mit einem Zirkumflex darunterDieses Dokument ist kein gültiges JSONKorrigieren Sie es mit dem JSON-Validator oder dem JSON-Formatierer und führen Sie erneut zusammen
Ein Hinweis, dass ein Kommentar vorhanden und die strenge Eingabe aktiviert istKommentare und nachgestellte Kommas annehmen ist ausgeschaltetSchalten Sie es wieder ein; Konfigurationsdateien wie tsconfig.json enthalten oft Kommentare
Der Tab Eingaben meldet doppelte SchlüsselEine Datei enthält denselben Schlüssel zweimal, und nur der letzte übersteht das EinlesenPrüfen Sie, welcher gemeint war, bevor Sie dem Ergebnis vertrauen
Warnung, dass Zahlen an Genauigkeit verlierenGanzzahlen über 9007199254740991, etwa manche 64-Bit-Datenbank-ids, ändern sich beim EinlesenSpeichern Sie solche ids in den Quelldateien als Text
NDJSON ist nicht verfügbarDas zusammengeführte Ergebnis ist ein Objekt, NDJSON braucht ein ArrayVerwenden Sie JSON, oder führen Sie Array-Dateien zusammen
Hinweis „Einstellungen geändert“Sie haben nach dem Zusammenführen eine Option oder die Reihenfolge geändertKlicken Sie auf Erneut anwenden
Hinweis auf eine gekürzte VorschauDas Ergebnis ist zu lang, um es vollständig anzuzeigenEs fehlt nichts: Der Download enthält das ganze Ergebnis

Die kostenlose Grenze, an der eine Zusammenführung meist scheitert, ist die Summe von 30 MB und nicht die 10 MB pro Datei, weil das Werkzeug alle Eingaben und das Ergebnis gleichzeitig im Speicher hält. Fünf Dateien mit je 8 MB, zusammen 40 MB, liegen über der Summe, obwohl jede einzelne unter der Dateigrenze bleibt. Wenn Sie vorher mit dem JSON-Minifier die Leerzeichen entfernen, kommt ein Satz oft unter die Grenze, ohne dass sich Daten ändern.

Nach dem Zusammenführen: prüfen und aufräumen

Um die Zusammenführung von der anderen Seite zu sehen, vergleichen Sie die zusammengeführte Datei in JSON Diff mit Ihrer Basisdatei: Jede Ergänzung und jede Änderung wird nach Pfad aufgelistet. Wie Sie diesen Bericht lesen, erklärt zwei JSON-Dateien vergleichen. Wenn mehrere Werkzeuge die Datei neu erzeugen, sortieren Sie ihre Schlüssel, damit die Reihenfolge zwischen den Läufen stabil bleibt. Und wenn Ihre Daten eigentlich ein Tabellenexport sind, bleiben sie beim Zusammenführen von CSV-Dateien in Zeilen und Spalten.

Häufige Fragen

Wie führe ich zwei JSON-Dateien zu einer zusammen?

Fügen Sie beide Dateien der JSON-Zusammenführung hinzu, die Datei, deren Werte gewinnen sollen, an zweiter Stelle, lassen Sie Tiefe Zusammenführung ausgewählt und klicken Sie auf JSON zusammenführen. Laden Sie dann das Ergebnis herunter. Kostenlos sind bis zu 5 Dokumente, je 10 MB und insgesamt 30 MB.

Wie kombiniere ich JSON-Dateien, die Arrays sind, zu einem Array?

Stellen Sie Arrays vor dem Zusammenführen auf Aneinanderhängen. Mit der Voreinstellung Ersetzen gewinnt das spätere Array, und Sie erhalten nur die Elemente der letzten Datei. Wählen Sie stattdessen Vereinigung, um Wiederholungen zu entfernen, oder Nach Schlüssel, um Datensätze mit gleicher id zu verbinden.

Welcher Wert gewinnt, wenn zwei JSON-Dateien denselben Schlüssel haben?

Der des späteren Dokuments in der Liste. Sind beide Werte Objekte, werden sie kombiniert (im tiefen Modus); andernfalls ersetzt der spätere Wert den früheren, und der Tab Konflikte hält Pfad, alten Wert, neuen Wert und das gewinnende Dokument fest.

Was ist der Unterschied zwischen tiefer und flacher Zusammenführung bei JSON?

Die tiefe Zusammenführung geht in verschachtelte Objekte hinein und ändert nur die Schlüssel, die eine spätere Datei nennt. Die flache arbeitet nur mit den Schlüsseln der obersten Ebene, sodass ein verschachteltes Objekt einer späteren Datei das frühere vollständig ersetzt, auch die Schlüssel, die es nicht erwähnt.

Kann ich verhindern, dass null-Werte beim Zusammenführen Daten löschen?

Ja. Stellen Sie null-Werte auf Ignorieren. Ein null in einer späteren Datei wird dann überall übersprungen, wo schon ein Wert existiert, und der Bericht nennt, wie viele null ignoriert wurden. Mit Überschreiben, der Voreinstellung, ersetzt ein null den früheren Wert.

Kann ich JSON-Dateien mit Kommentaren oder JSON Lines zusammenführen?

Ja. Wenn Kommentare und nachgestellte Kommas annehmen eingeschaltet ist, was die Voreinstellung ist, werden Dateien mit Kommentaren in // oder /* */ und nachgestellten Kommas normal gelesen. NDJSON- und JSON-Lines-Dateien werden als Array gelesen, und ein Array-Ergebnis lässt sich wieder als NDJSON schreiben.

Weiterlesen

Mehr zu Dokumente →