mergedJSONPatch

​

mergedJSONPatch

1. Eliminación de valores nulos: un patch {"key": null} no elimina la clave. ColumnObject descarta los miembros con valor nulo durante la inserción, por lo que la función no puede distinguir entre “clave ausente” y “clave con valor nulo”.
2. Reemplazo con objeto vacío: un patch {"a": {}} no puede sustituir un valor escalar o array anterior en la ruta a. ColumnObject descarta silenciosamente las rutas cuyo valor es un objeto vacío {}, por lo que el patch más reciente no aporta nada y el valor anterior se mantiene.
3. Ausencia en rutas tipadas no Nullable: cuando una columna JSON declara una ruta tipada con un tipo no Nullable (p. ej., JSON(a UInt32)), una fila que omite a se almacena con el valor predeterminado del tipo (p. ej., 0). La agregación no puede distinguir entre “ausente” y “escrito explícitamente con el valor predeterminado”, por lo que un patch más reciente que omite a borra silenciosamente un valor anterior distinto de cero. Para evitarlo, declare las rutas tipadas como Nullable (p. ej., JSON(a Nullable(UInt32))). Un valor nulo en una ruta tipada Nullable se trata como “ruta ausente” y se omite correctamente.
4. Todas las rutas tipadas son atómicas: cada ruta tipada (Map(K,V), JSON, Dynamic, Tuple(…), Variant(…), Array(…) o cualquier otro tipo declarado) se almacena como un único valor. La agregación reemplaza el valor completo de forma atómica, en lugar de fusionar su contenido en profundidad. Solo las rutas dinámicas (no tipadas, escalares) se fusionan en profundidad, ruta por ruta.
5. Ambigüedad por puntos en las claves: el tipo JSON representa {"a":{"b":1}} y {"a.b":1} con la misma ruta interna a.b. Por lo tanto, una misma fila puede exponer tanto a como a.b como elementos independientes del mismo nivel. Cuando un patch más reciente escribe solo a, la regla de conflicto entre ancestro y descendiente borra a.b; cuando escribe solo a.b, esa misma regla borra a. Para evitarlo, establezca json_type_escape_dots_in_keys = 1. Con este ajuste, los puntos literales de las claves JSON se representan mediante codificación porcentual (p. ej., a.b se convierte en a%2Eb), lo que los distingue de las rutas anidadas y elimina el falso conflicto.

mergedJSONPatch(json, sort_key)

• json — Columna JSON que se va a agregar. JSON
• sort_key — Columna comparable que determina qué escritura prevalece para cada ruta. Se conserva la fila con el valor de sort_key más alto.

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}             │
└─────────────────────────────────┘