OBJECT_CONSTRUCT
OBJECT_CONSTRUCT (객체 생성)
지정된 키-값 쌍으로 OBJECT를 만들어 반환해요. 값이 NULL인 쌍은 결과 객체에서 제외돼요.
본문
구문 (Syntax)
OBJECT_CONSTRUCT( [ <key1> , <value1> [ , <key2> , <value2> ... ] ] )
인자 (Arguments)
keyN
객체의 키가 되는 문자열 값(또는 문자열로 변환되는 표현식)이에요. 키가 NULL로 평가되면 해당 키-값 쌍은 생략돼요.
valueN
객체의 값이 되는 표현식이에요. 값이 NULL이면 해당 키-값 쌍은 결과 객체에서 제외돼요.
반환 값 (Returns)
지정된 키-값 쌍을 포함하는 OBJECT(VARIANT)를 반환해요. NULL 값은 객체에 포함되지 않아요.
사용 참고 사항 (Usage notes)
- 값이 NULL인 키-값 쌍은 결과에서 생략돼요(객체에 포함되지 않음).
- NULL 값을 유지해서 포함하려면 OBJECT_CONSTRUCT_KEEP_NULL을 사용해요.
- 구조화된(strict) OBJECT 타입으로 반환하려면 OBJECT_CONSTRUCT_STRUCTURED를 사용해요.
예시 (Examples)
SELECT OBJECT_CONSTRUCT('a', 1, 'b', NULL, 'c', 'x');
+----------------------------------------------------+
| OBJECT_CONSTRUCT('A', 1, 'B', NULL, 'C', 'X') |
|----------------------------------------------------|
| { "a": 1, "c": "x" } |
+----------------------------------------------------+
더 알아보기 (Learn more)
- Semi-structured data functions — 반정형 데이터 함수 모음
- OBJECT_CONSTRUCT_KEEP_NULL — NULL 유지 객체 생성
- OBJECT_INSERT — 키 삽입/갱신
- OBJECT_AGG — 객체 집계