OBJECT_AGG
OBJECT_AGG (객체 집계)
그룹 내 키-값 쌍으로 OBJECT를 만들어 반환해요. 키는 첫 번째 표현식에서, 값은 두 번째 표현식에서 가져와요.
본문
구문 (Syntax)
집계 함수(Aggregate function):
OBJECT_AGG( <key_expr> , <value_expr> )
창 함수(Window function):
OBJECT_AGG( <key_expr> , <value_expr> ) OVER ( [ PARTITION BY <expr1> ] )
인자 (Arguments)
key_expr
객체의 키를 제공하는 표현식이에요. OBJECT 또는 VARIANT로 평가되어야 해요. 키가 될 객체는 지원되지 않는 경우 (예: VARIANT 키의 제한)에 따라 처리돼요.
value_expr
객체의 값을 제공하는 표현식이에요.
반환 값 (Returns)
그룹당 하나의 OBJECT를 반환해요. 반환값은 VARIANT 타입(객체)이에요. 모든 키가 NULL이면(또는 그룹이 비어 있으면) NULL을 반환해요.
사용 참고 사항 (Usage notes)
- 키와 값의 쌍이 객체로 만들어져요.
- OBJECT_KEYS와 관련된 제한이 적용될 수 있어요.
예시 (Examples)
SELECT OBJECT_AGG(k, v) AS obj
FROM VALUES ('a', 1), ('b', 2) AS t(k, v);
+-------------------+
| OBJ |
|-------------------|
| { "a": 1, "b": 2 } |
+-------------------+
더 알아보기 (Learn more)
- Aggregate functions — 집계 함수 모음
- OBJECT_CONSTRUCT — 객체 생성
- OBJECT_KEYS — 객체 키 가져오기
- ARRAY_AGG — 배열로 결합