카테고리:

반정형 및 정형 데이터 함수 (배열/오브젝트)

OBJECT_INSERT

새 키-값 페어가 삽입된 입력 오브젝트(또는 새 값으로 업데이트된 기존 키)로 구성된 오브젝트를 반환합니다.

구문

OBJECT_INSERT( <object> , <key> , <value> [ , <updateFlag> ] )
Copy

인자

필수:

object

새 키-값 페어가 삽입되는 소스 오브젝트입니다.

key

오브젝트에 삽입할 새 키입니다. updateFlag 가 TRUE로 설정되지 않는 한, 오브젝트의 모든 기존 키와 달라야 합니다.

value

키와 연결된 값입니다.

선택 사항:

updateFlag

TRUE로 설정하는 경우, 입력 값을 지정하는 부울 플래그는 새 키-값 페어를 삽입하는 대신 오브젝트의 기존 키를 업데이트/덮어쓰는 데 사용됩니다.

기본값은 FALSE입니다.

사용법 노트

  • 함수는 JSON NULL 값을 지원하지만, SQL NULL 값 또는 키는 지원하지 않습니다.

    • key 가 NULL이 아닌 다른 문자열이고, value 가 JSON NULL(예: PARSE_JSON('NULL'))인 경우, 반환된 오브젝트에 키-값 페어가 삽입됩니다.

    • key 또는 value 가 SQL NULL인 경우, 반환된 오브젝트에서 키-값 페어가 생략됩니다.

  • 선택적 updateFlag 인자가 TRUE로 설정된 경우, 기존 입력 key 가 입력 value 로 업데이트됩니다. updateFlag 가 생략되거나 FALSE로 설정된 경우, 오브젝트에 이미 존재하는 입력 키로 이 함수를 호출하면 오류가 발생합니다.

  • 업데이트 플래그가 true로 설정되어 있지만 해당 키가 오브젝트에 이미 존재하지 않는 경우, 키/값 쌍이 추가됩니다.

  • 정형 OBJECT 의 경우:

    • 키인 인자의 경우 상수를 지정해야 합니다.

    • updateFlag 인자가 FALSE인 경우(새 키-값 페어를 삽입하는 경우):

      • OBJECT에 이미 존재하는 키를 지정하면 오류가 발생합니다.

        SELECT OBJECT_INSERT(
          {'city':'San Mateo','state':'CA'}::OBJECT(city VARCHAR,state VARCHAR),
          'city',
          'San Jose',
          false
        );
        
        Copy
        093202 (23001): Function OBJECT_INSERT:
          expected structured object to not contain field city but it did.
        
      • 이 함수는 정형 OBJECT를 반환합니다. OBJECT의 유형에는 새로 삽입된 키가 포함됩니다. 예를 들어, DOUBLE 값 94402 를 사용하여 zipcode 키를 추가한다고 가정해 보겠습니다.

        SELECT
          OBJECT_INSERT(
            {'city':'San Mateo','state':'CA'}::OBJECT(city VARCHAR,state VARCHAR),
            'zip_code',
            94402::DOUBLE,
            false
          ) AS new_object,
          SYSTEM$TYPEOF(new_object);
        
        Copy

        이 함수는 OBJECT(city VARCHAR, state VARCHAR, zipcode DOUBLE) 유형의 OBJECT를 반환합니다.

        +-------------------------------------+---------------------------------------------------------------------------------------+
        | NEW_OBJECT                          | SYSTEM$TYPEOF(NEW_OBJECT)                                                             |
        |-------------------------------------+---------------------------------------------------------------------------------------|
        | {                                   | OBJECT(city VARCHAR(16777216), state VARCHAR(16777216), zip_code FLOAT NOT NULL)[LOB] |
        |   "city": "San Mateo",              |                                                                                       |
        |   "state": "CA",                    |                                                                                       |
        |   "zip_code": 9.440200000000000e+04 |                                                                                       |
        | }                                   |                                                                                       |
        +-------------------------------------+---------------------------------------------------------------------------------------+
        

        삽입된 값의 유형에 따라 OBJECT 유형 정의에 추가된 유형이 결정됩니다. 이 경우 zipcode 의 값은 DOUBLE에 캐스팅된 값이므로 zipcode 의 유형은 DOUBLE입니다.

    • updateFlag 인자가 TRUE인 경우(기존 키-값 페어를 바꾸는 경우):

      • OBJECT에 존재하지 않는 키를 지정하면 오류가 발생합니다.

      • 이 함수는 동일한 유형의 정형 OBJECT를 반환합니다.

      • 삽입된 값의 유형은 기존 키 유형으로 강제 변환됩니다.

두 개의 키-값 페어를 포함하는 오브젝트에 세 번째 키-값 페어를 삽입합니다.

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

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

하나의 키-값 페어를 생략하면서 두 개의 새 키-값 페어를 빈 오브젝트에 삽입합니다.

  • Key_One 은 JSON NULL 값으로 구성됩니다.

  • Key_Two 는 SQL NULL 값으로 구성되므로 생략됩니다.

  • Key_Three 는 “null”을 포함하는 문자열로 구성됩니다.

SELECT
  OBJECT_INSERT(OBJECT_INSERT(OBJECT_INSERT(OBJECT_CONSTRUCT(), 'Key_One', PARSE_JSON('NULL')), 'Key_Two', NULL), 'Key_Three', 'null')
  AS obj;

-----------------------+
          OBJ          |
-----------------------+
 {                     |
   "Key_One": null,    |
   "Key_Three": "null" |
 }                     |
-----------------------+
Copy

기존 키-값 페어("k1": 100)을 새 값("string-value")으로 업데이트합니다.

SELECT OBJECT_INSERT(OBJECT_INSERT(OBJECT_CONSTRUCT(),'k1', 100),'k1','string-value', TRUE) AS obj;

------------------------+
          OBJ           |
------------------------+
 {                      |
   "k1": "string-value" |
 }                      |
------------------------+
Copy