mergedJSONPatch

마지막 쓰기 우선(last-write-wins) 방식의 JSON Merge Patch 의미 체계에 따라 JSON 값을 집계합니다.

​

mergedJSONPatch

도입 버전: v26.8.0

JSON 값을 마지막 쓰기 우선(last-write-wins) 의미 체계로 머지하여 집계하며, RFC 7396 JSON Merge Patch의 핵심 머지 동작을 경로 수준에서 구현합니다.

이 집계 함수는 상태를 (key, value, sorting_key) 형태의 3개 항목 튜플로 저장하며, 각 key(JSON 경로)마다 sorting_key를 기준으로 가장 최신의 유효한 레코드만 유지합니다. JSON 타입이 동적 스칼라 리프로 저장하는 경로에서는 객체 쓰기가 하위 경로로 평탄화됩니다. 상위 경로에 객체가 아닌 값을 쓰면 충돌하는 하위 경로는 가려집니다.

명시적으로 타입이 지정된 모든 경로(JSON(a Map(...)), JSON(a Tuple(...)), JSON(a Variant(...)), JSON(a Dynamic) 등으로 선언된 경로)는 원자적(atomic) 값으로 처리됩니다. 즉, 경로 값 전체가 딥 머지되지 않고 더 최신 패치로 대체됩니다. 타입이 지정되지 않은(동적) 스칼라 경로만 RFC 7396 딥 머지 의미 체계를 따릅니다.

sort_key는 각 JSON 경로에서 어떤 값이 우선할지 결정합니다. sort_key가 가장 큰 행이 유지됩니다. 충돌하는 두 패치의 정렬 키가 같으면 결과는 처리 순서에 따라 달라지며, 나중에 처리된 패치가 우선합니다. 동률을 결정론적으로 해소하는 용도로 ORDER BY에 의존하지 마십시오.

제한 사항(ColumnObject에서 상속됨):

1. Null 삭제: 패치 {"key": null}은 키를 제거하지 않습니다. ColumnObject는 삽입 시 값이 null인 멤버를 삭제하므로, 함수는 “키 없음”과 “키가 null임”을 구분할 수 없습니다.

2. 빈 객체로의 대체: 패치 {"a": {}}로는 경로 a에 있는 이전 스칼라 값이나 배열을 대체할 수 없습니다. ColumnObject는 값이 빈 객체 {}인 경로를 별도 알림 없이 삭제하므로, 새 패치는 아무런 영향을 주지 못하고 이전 값이 그대로 유지됩니다.

3. 널 비허용(Non-Nullable) 타입이 지정된 경로의 부재: JSON 컬럼에서 널을 허용하지 않는 타입으로 타입이 지정된 경로를 선언하면(예: JSON(a UInt32)), a가 생략된 행은 해당 타입의 기본값(예: 0)으로 저장됩니다. 집계 함수는 “부재”와 “기본값으로 명시적으로 기록됨”을 구분할 수 없으므로, a를 생략한 새 패치가 0이 아닌 이전 값을 별도 알림 없이 지워 버립니다. 이를 방지하려면 타입이 지정된 경로를 Nullable로 선언하십시오 (예: JSON(a Nullable(UInt32))). 널 허용 타입이 지정된 경로의 null은 “경로 없음”으로 처리되어 올바르게 건너뜁니다.

4. 타입이 지정된 경로는 모두 원자적으로 처리됨: 타입이 지정된 모든 경로(Map(K,V), JSON, Dynamic, Tuple(…), Variant(…), Array(…) 또는 기타 선언된 타입)는 단일 값으로 저장됩니다. 집계 함수는 내용을 깊은 머지(deep merge)하지 않고 값 전체를 원자적으로 대체합니다. 동적(타입이 지정되지 않은 스칼라) 경로만 경로 단위로 깊은 머지됩니다.

5. 키에 포함된 점으로 인한 모호성: JSON 타입은 {"a":{"b":1}}과 {"a.b":1}을 동일한 내부 경로 a.b로 표현합니다. 따라서 하나의 행에서 a와 a.b가 서로 독립적인 피어로 함께 노출될 수 있습니다. 새 패치가 a만 기록하면 상위/하위 충돌 규칙에 따라 a.b가 지워지고, a.b만 기록하면 같은 규칙에 따라 a가 지워집니다. 이를 방지하려면 json_type_escape_dots_in_keys = 1로 설정하십시오. 이 설정을 사용하면 JSON 키에 포함된 리터럴 점이 퍼센트 인코딩되어(예: a.b가 a%2Eb로 변환됨) 중첩 경로와 구분되므로 잘못된 충돌이 발생하지 않습니다.

구문

mergedJSONPatch(json, sort_key)

인수

• json — 집계할 JSON 컬럼입니다. JSON
• sort_key — 각 경로마다 어떤 쓰기를 최종 반영할지 결정하는 비교 가능한 컬럼입니다. sort_key 값이 가장 큰 행이 유지됩니다.

반환 값

입력된 모든 JSON 객체를 병합한 결과로 단일 JSON 객체를 반환합니다. JSON

예시

정렬 키를 사용한 기본 사용법

Query

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
);

Response

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