OBJECT_CONSTRUCT

OBJECT_CONSTRUCT (객체 생성)

지정된 키-값 쌍으로 OBJECT를 만들어 반환해요. 값이 NULL인 쌍은 결과 객체에서 제외돼요.

출처: Snowflake SQL Reference - OBJECT_CONSTRUCT

본문

구문 (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)