IA sur votre appareil : performant et privé.

Documents

Comment fusionner des fichiers JSON en ligne (et ce qui se passe en cas de conflit de clés)

Fusionnez des fichiers JSON en un seul : fusion profonde ou superficielle, quatre modes pour les tableaux, un rapport des valeurs écrasées. Gratuit jusqu'à 5 fichiers.

Mis à jour le 8 novembre 202610 min de lecture

Pour fusionner des fichiers JSON, ajoutez-les au fusionneur JSON dans l'ordre où ils doivent s'appliquer, choisissez Fusion profonde ou Fusion superficielle, décidez du sort des tableaux et cliquez sur Fusionner le JSON. Le résultat se télécharge en un seul fichier. L'ordre est la règle des conflits : quand deux fichiers définissent la même clé, le plus tardif l'emporte, et l'onglet Conflits liste chaque valeur écrasée, avec l'ancienne et la nouvelle. L'offre gratuite accepte jusqu'à 5 documents, 10 Mo chacun et 30 Mo au total, et tout s'exécute sur votre appareil, pas sur nos serveurs. La suite du guide indique quels réglages conviennent à quelle tâche, car « fusionner » recouvre trois choses bien différentes selon le contenu de vos fichiers.

Fusionner des fichiers JSON : trois tâches différentes

Avant de choisir les réglages, regardez les crochets extérieurs de vos fichiers. Un fichier qui commence par { est un objet (des clés nommées) ; un fichier qui commence par [ est un tableau (une liste). Ce que vous attendez de la fusion en dépend, ainsi que du fait que les fichiers décrivent les mêmes éléments ou des éléments différents.

Vos fichiersCe que vous voulezRéglages
Objets : une configuration de base plus des surchargesChaque surcharge ne modifie que les clés qu'elle nommeFusion profonde, Tableaux : Remplacer
Tableaux : plusieurs listes d'enregistrements ou d'entrées de journalUne seule longue liste avec toutTableaux : Concaténer
Tableaux d'étiquettes ou de valeurs qui se répètentUne liste où chaque valeur n'apparaît qu'une foisTableaux : Union
Deux exports des mêmes enregistrements avec des champs différentsUn enregistrement par id avec tous ses champsTableaux : Fusionner par clé, Champ clé : id
Objets dont les sections imbriquées doivent être remplacées en blocUne section ultérieure remplace entièrement la précédenteFusion superficielle

L'outil accepte n'importe quelle racine JSON : vous pouvez fusionner des objets avec des objets, des tableaux avec des tableaux, ou mélanger. Quand les deux valeurs au même endroit sont de types différents (un objet face à un tableau, un nombre face à une chaîne), elles ne peuvent pas être combinées : la plus tardive remplace la précédente et ce remplacement est enregistré comme conflit.

Combiner des fichiers JSON en un seul, étape par étape

1

Ajoutez les documents

Déposez jusqu'à cinq fichiers .json, .jsonc, .jsonl ou .ndjson dans l'outil de fusion JSON, ou cliquez sur Coller du JSON pour saisir ou coller un document. Vous pouvez mélanger fichiers et texte collé.

2

Mettez-les dans l'ordre

Le premier document sert de base et chaque document suivant vient se poser par-dessus. Utilisez les flèches de chaque ligne pour le déplacer plus haut ou plus bas, de sorte que le fichier dont les valeurs doivent l'emporter soit le dernier.

3

Choisissez comment combiner les objets

Sous Objets, Fusion profonde combine les objets imbriqués clé par clé ; Fusion superficielle ne combine que les clés de premier niveau et remplace les objets imbriqués en entier. La fusion profonde est le réglage par défaut.

4

Choisissez comment combiner les tableaux

Sous Tableaux, choisissez Remplacer, Concaténer, Union ou Fusionner par clé. Pour Fusionner par clé, saisissez le Champ clé qui identifie un enregistrement (id par défaut). Réglez Valeurs null sur Ignorer si un null dans un fichier ultérieur ne doit jamais effacer une valeur.

5

Fusionnez et vérifiez

Cliquez sur Fusionner le JSON. Lisez l'onglet Conflits pour voir ce qui a été écrasé, et l'onglet Entrées pour les clés en double ou les avertissements de précision trouvés dans chaque source.

6

Téléchargez ou copiez

Choisissez une indentation (Minifié, 2 espaces, 4 espaces ou tabulation) et un format (JSON, ou NDJSON quand le résultat est un tableau), puis cliquez sur Télécharger le JSON ou Copier.

Fusion profonde ou superficielle, quatre stratégies de tableaux, une règle pour les null et un rapport de conflits, le tout gratuit. Gratuit : jusqu'à 5 documents, 10 Mo chacun et 30 Mo au total. Pro : jusqu'à 100 documents, limités uniquement par votre appareil, plus la livraison en ZIP.

Fusionner des fichiers JSON

Fusion profonde ou fusion superficielle

Prenons un fichier de base {"server": {"host": "localhost", "port": 8080}} et une surcharge {"server": {"port": 9090}}. Avec la Fusion profonde, le résultat est {"server": {"host": "localhost", "port": 9090}} : l'outil entre dans server et ne modifie que la clé mentionnée par la surcharge. Avec la Fusion superficielle, le résultat est {"server": {"port": 9090}} : l'objet server entier du fichier ultérieur remplace le précédent, et host disparaît.

La fusion profonde convient aux configurations en couches (base, puis production, puis surcharges locales), aux fichiers de traduction répartis entre équipes et aux jeux de données de test où chaque cas ne change que quelques champs. La fusion superficielle convient quand chaque section de premier niveau forme un tout et qu'un fichier ultérieur doit fournir un remplacement complet, par exemple un bloc database entier pour un autre environnement.

Combiner des tableaux JSON : remplacer, concaténer, union ou par clé

Il n'existe pas de façon unique et correcte de fusionner deux listes, alors l'outil vous pose la question. Le réglage s'applique partout où deux tableaux se rencontrent : à la racine du fichier, et à tout chemin imbriqué en mode profond (ou à une clé de premier niveau en mode superficiel).

  • Remplacer (par défaut) : le tableau ultérieur l'emporte entièrement. [1, 2] et [3] donnent [3].
  • Concaténer : tous les éléments des deux tableaux, dans l'ordre, doublons compris. [1, 2] et [2, 3] donnent [1, 2, 2, 3]. À utiliser pour les journaux, les événements et les exports d'enregistrements qui ne se recoupent pas.
  • Union : les deux tableaux réunis, puis les éléments répétés supprimés. [1, 2] et [2, 3] donnent [1, 2, 3]. Les objets sont comparés par leur contenu, donc {"a":1,"b":2} et {"b":2,"a":1} comptent comme le même élément.
  • Fusionner par clé : les enregistrements qui partagent la même valeur de Champ clé sont combinés champ par champ ; ceux qui ont une clé nouvelle sont ajoutés à la fin ; les éléments qui ne sont pas des objets ou n'ont pas la clé sont ajoutés tels quels.

Fusionner par clé compare le type autant que la valeur. Un enregistrement avec "id": 1 et un autre avec "id": "1" sont deux enregistrements distincts et ne sont pas réunis. Si vos deux exports ne s'accordent pas sur le fait que les id soient des nombres ou des chaînes, corrigez l'un des deux d'abord, sinon le résultat contiendra les deux versions côte à côte.

Ce qui se passe exactement en cas de conflit de clés

Un conflit est tout endroit où un document ultérieur a remplacé une valeur au lieu de s'y fusionner. Voici, au complet, les règles que suit le fusionneur :

  1. 1Une clé présente dans un seul document est copiée telle quelle. Rien n'est perdu, rien n'est signalé.
  2. 2Deux objets au même chemin sont fusionnés clé par clé (en mode superficiel, seulement au premier niveau).
  3. 3Deux tableaux au même chemin suivent le réglage Tableaux.
  4. 4Tout le reste, par exemple deux nombres différents, une chaîne face à un objet, ou un objet face à un objet en fusion superficielle, est remplacé par la valeur ultérieure et enregistré comme conflit.
  5. 5Un document ultérieur qui écrit exactement la même valeur ne crée pas de conflit : le rapport ne montre que les vrais changements.
  6. 6Un null explicite dans un fichier ultérieur écrase la valeur par défaut, car null est une vraie valeur JSON. Avec Valeurs null sur Ignorer, il est ignoré et le rapport compte combien de null l'ont été.

L'onglet Conflits présente chacun sur une ligne : le chemin (par exemple $.server.port), l'ancienne valeur, la nouvelle et le document d'où elle vient. Les 500 premiers conflits sont listés en entier et le compteur continue au-delà. Si l'onglet indique que rien n'a été écrasé, chaque valeur de chaque document figure dans le résultat.

Par défaut, l'ordre des clés suit le document de base, et les clés présentes uniquement dans les fichiers ultérieurs sont ajoutées à la fin, ce qui limite la taille du diff dans votre gestionnaire de versions. Choisissez Ordre des clés : A-Z si vous voulez le même résultat quelle que soit la façon dont les entrées étaient écrites.

Ce qui peut mal tourner, et que faire

Ce que vous voyezPourquoiSolution
Une ligne indique une ligne et une colonne avec un accent circonflexe en dessousCe document n'est pas du JSON valideCorrigez-le avec le Validateur JSON ou le Formateur JSON, puis relancez la fusion
Un message indiquant qu'il y a un commentaire alors que l'entrée stricte est activéeL'option Accepter commentaires et virgules finales est désactivéeRéactivez-la ; les fichiers de configuration comme tsconfig.json contiennent souvent des commentaires
L'onglet Entrées signale des clés en doubleUn fichier contient deux fois la même clé, et seule la dernière survit à la lectureVérifiez laquelle vous vouliez avant de vous fier à la fusion
Avertissement de nombres qui perdent en précisionLes entiers supérieurs à 9007199254740991, comme certains id de base de données sur 64 bits, changent à la lectureStockez ces id sous forme de chaînes dans les fichiers sources
NDJSON n'est pas disponibleLe résultat fusionné est un objet, et NDJSON exige un tableauUtilisez JSON, ou fusionnez des fichiers de tableaux
Badge « Réglages modifiés »Vous avez changé une option ou l'ordre après la fusionCliquez sur Réappliquer
Avertissement d'aperçu raccourciLe résultat est trop long pour être affiché en entierRien ne manque : le téléchargement contient le résultat complet

La limite gratuite qui bloque le plus souvent une fusion est le total de 30 Mo plutôt que les 10 Mo par fichier, car l'outil garde en mémoire toutes les entrées et le résultat fusionné en même temps. Cinq fichiers de 8 Mo chacun, soit 40 Mo ensemble, dépassent le total même si chaque fichier reste sous la limite individuelle. Supprimer les espaces avec le Minificateur JSON au préalable suffit souvent à passer sous la limite sans changer aucune donnée.

Après la fusion : vérifier et ranger

Pour voir la fusion sous l'autre angle, comparez le fichier fusionné à votre fichier de base dans JSON Diff : chaque ajout et chaque modification seront listés par chemin. La lecture de ce rapport est expliquée dans comment comparer deux fichiers JSON. Si plusieurs outils régénèrent le fichier fusionné, triez ses clés pour que l'ordre reste stable d'une exécution à l'autre. Et si vos données sont en réalité un export de tableur, fusionner des fichiers CSV les garde en lignes et en colonnes.

Questions fréquentes

Comment fusionner deux fichiers JSON en un seul ?

Ajoutez les deux fichiers au fusionneur JSON, en plaçant en second celui dont les valeurs doivent l'emporter, laissez Fusion profonde sélectionnée et cliquez sur Fusionner le JSON. Téléchargez ensuite le résultat. La version gratuite couvre jusqu'à 5 documents, 10 Mo chacun et 30 Mo au total.

Comment combiner des fichiers JSON qui sont des tableaux en un seul tableau ?

Réglez Tableaux sur Concaténer avant de fusionner. Avec le réglage par défaut, Remplacer, le tableau ultérieur l'emporte et vous n'obtenez que les éléments du dernier fichier. Choisissez plutôt Union pour supprimer les éléments répétés, ou Fusionner par clé pour réunir les enregistrements qui partagent un id.

Quelle valeur l'emporte quand deux fichiers JSON ont la même clé ?

Celle du document placé plus bas dans la liste. Si les deux valeurs sont des objets, elles sont combinées (en mode profond) ; sinon, la valeur ultérieure remplace la précédente, et l'onglet Conflits enregistre le chemin, l'ancienne valeur, la nouvelle et le document gagnant.

Quelle est la différence entre fusion profonde et fusion superficielle en JSON ?

La fusion profonde entre dans les objets imbriqués et ne modifie que les clés qu'un fichier ultérieur nomme. La fusion superficielle ne travaille que sur les clés de premier niveau : un objet imbriqué d'un fichier ultérieur remplace donc entièrement l'objet précédent, y compris les clés qu'il ne mentionnait pas.

Peut-on empêcher les valeurs null d'effacer des données lors d'une fusion JSON ?

Oui. Réglez Valeurs null sur Ignorer. Un null dans un fichier ultérieur est alors ignoré partout où une valeur existe déjà, et le rapport de fusion indique combien de null ont été ignorés. Avec Écraser, le réglage par défaut, un null remplace la valeur précédente.

Peut-on fusionner des fichiers JSON avec commentaires ou au format JSON Lines ?

Oui. Avec l'option Accepter commentaires et virgules finales activée, ce qui est le cas par défaut, les fichiers contenant des commentaires // ou /* */ et des virgules finales sont lus normalement. Les fichiers NDJSON et JSON Lines sont lus comme un tableau, et un résultat sous forme de tableau peut être réécrit en NDJSON.

À lire ensuite

Plus sur Documents →