OBJECT_INSERT

OBJECT_INSERT (키 삽입·갱신)

OBJECT에 지정된 키-값 쌍을 삽입하거나 갱신한 새 OBJECT를 반환해요.

출처: Snowflake SQL Reference - OBJECT_INSERT

본문

구문 (Syntax)

OBJECT_INSERT( <object> , <key> , <value> [, { TRUE | FALSE } ] )

인자 (Arguments)

object

변경할 OBJECT 값이에요.

key

삽입하거나 갱신할 키(들)이에요.

value

키에 설정할 값이에요.

{ TRUE | FALSE }

선택적인 불리언 인자로, 키가 이미 object에 있을 때 값을 덮어쓸지 여부를 지정해요:

  • TRUE(기본값): 키가 존재하면 값을 덮어써요.
  • FALSE: 키가 존재하면 기존 값을 유지해요.

반환 값 (Returns)

지정된 키-값 쌍이 삽입되거나 갱신된 OBJECT를 반환해요. 원본 객체는 변경되지 않아요.

사용 참고 사항 (Usage notes)

  • 이 함수는 원본 객체를 변경하지 않고 새 객체를 반환해요.
  • 구조화된(strict) OBJECT 타입 및 VARIANT(반정형) OBJECT 타입 모두에 사용할 수 있어요.

예시 (Examples)

SELECT OBJECT_INSERT(OBJECT_CONSTRUCT('a', 1), 'b', 2);

+--------------------------------------------------+
| OBJECT_INSERT(OBJECT_CONSTRUCT('A', 1), 'B', 2)  |
|--------------------------------------------------|
| { "a": 1, "b": 2 }                               |
+--------------------------------------------------+

더 알아보기 (Learn more)