mergedJSONPatch

​

mergedJSONPatch

1. Suppression par null : un patch {"key": null} ne supprime pas la clé. ColumnObject supprime les membres de valeur null lors de l’insertion ; la fonction ne peut donc pas distinguer “clé absente” de “clé à null”.
2. Remplacement par un objet vide : un patch {"a": {}} ne peut pas remplacer une ancienne valeur scalaire ou un ancien tableau au chemin a. ColumnObject supprime silencieusement les chemins dont la valeur est un objet vide {} ; le patch le plus récent n’apporte donc rien et l’ancienne valeur est conservée.
3. Absence d’un chemin typé non Nullable : lorsqu’une colonne JSON déclare un chemin typé avec un type non nullable (par exemple, JSON(a UInt32)), une ligne qui omet a est stockée avec la valeur par défaut du type (par exemple, 0). L’agrégat ne peut pas distinguer “absent” de “explicitement écrit avec la valeur par défaut” : un patch plus récent qui omet a efface donc silencieusement une ancienne valeur non nulle. Pour éviter cela, déclarez les chemins typés comme Nullable (par exemple, JSON(a Nullable(UInt32))). Un null dans un chemin typé nullable est traité comme “chemin absent” et correctement ignoré.
4. Tous les chemins typés sont atomiques : chaque chemin typé (Map(K,V), JSON, Dynamic, Tuple(…), Variant(…), Array(…) ou tout autre type déclaré) est stocké sous forme de valeur unique. L’agrégat remplace la valeur entière de manière atomique au lieu de fusionner son contenu en profondeur. Seuls les chemins dynamiques (non typés, scalaires) sont fusionnés en profondeur, chemin par chemin.
5. Ambiguïté des points dans les clés : le type JSON représente {"a":{"b":1}} et {"a.b":1} avec le même chemin interne a.b. Une même ligne peut donc exposer à la fois a et a.b comme des chemins homologues indépendants. Lorsqu’un patch plus récent écrit uniquement a, la règle de conflit ancêtre/descendant efface a.b ; lorsqu’il écrit uniquement a.b, la même règle efface a. Pour éviter cela, définissez json_type_escape_dots_in_keys = 1. Avec ce paramètre, les points littéraux dans les clés JSON sont encodés en pourcentage (par exemple, a.b devient a%2Eb), ce qui les distingue des chemins imbriqués et élimine le faux conflit.

mergedJSONPatch(json, sort_key)

• json — Colonne JSON à agréger. JSON
• sort_key — Colonne comparable qui détermine quelle écriture l’emporte pour chaque path. La ligne dont la valeur de sort_key est la plus élevée est conservée.

SELECT mergedJSONPatch(json, sort_key) FROM
(
    SELECT '{"a":1}'::JSON AS json, 1 AS sort_key
    UNION ALL
    SELECT '{"b":2}'::JSON, 2
    UNION ALL
    SELECT '{"a":3, "c":4}'::JSON, 3
);

┌─mergedJSONPatch(json, sort_key)─┐
│ {"a":3,"b":2,"c":4}             │
└─────────────────────────────────┘