OBJECT_INSERT¶

구문¶

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

인자¶

필수:

object

새 키-값 페어가 삽입되거나 기존 키-값 페어가 업데이트되는 소스 OBJECT 값입니다.

key

OBJECT 값에 삽입할 새 키 또는 값이 업데이트되는 기존 키입니다. 지정된 키는 updateFlag 가 TRUE 로 설정되어 있지 않는 한 OBJECT 값의 모든 기존 키와 달라야 합니다.

value

키와 연결된 값입니다.

선택 사항:

updateFlag

TRUE 로 설정하면 입력 값이 새 키-값 페어를 삽입하는 대신 OBJECT 값에 있는 기존 키의 값을 업데이트하도록 지정하는 부울 플래그입니다.

기본값은 FALSE입니다.

반환¶

이 함수는 OBJECT 데이터 타입의 값을 반환합니다.

사용법 노트¶

• 이 함수는 JSON null 값을 지원하지만 SQL NULL 값이나 키는 지원하지 않습니다.

  • key 가 NULL 이외의 문자열이고 value 가 JSON null(예: PARSE_JSON('null'))인 경우 키-값 페어가 반환된 OBJECT 값에 삽입됩니다.

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

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

• 업데이트 플래그가 TRUE 로 설정되어 있지만 OBJECT 값에 해당 키가 아직 존재하지 않는 경우 키-값 페어가 추가됩니다.

• 정형 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 값의 유형에는 새로 삽입된 키가 포함됩니다. 예를 들어, FLOAT 값 94402 를 사용하여 zipcode 키를 추가한다고 가정해 보겠습니다.

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

      Copy

      +-------------------------------------+---------------------------------------------------------------------------------------+
      | NEW_OBJECT                          | TYPE                                                                                  |
      |-------------------------------------+---------------------------------------------------------------------------------------|
      | {                                   | 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 의 값은 FLOAT에 캐스팅된 값이므로 zipcode 의 유형은 FLOAT입니다.

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

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

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

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

예¶

예제에서는 다음 테이블을 사용합니다.

CREATE OR REPLACE TABLE object_insert_examples (object_column OBJECT);

INSERT INTO object_insert_examples (object_column)
  SELECT OBJECT_CONSTRUCT('a', 'value1', 'b', 'value2');

SELECT * FROM object_insert_examples;

+------------------+
| OBJECT_COLUMN    |
|------------------|
| {                |
|   "a": "value1", |
|   "b": "value2"  |
| }                |
+------------------+

UPDATE object_insert_examples
  SET object_column = OBJECT_INSERT(object_column, 'c', 'value3');

SELECT * FROM object_insert_examples;

+------------------+
| OBJECT_COLUMN    |
|------------------|
| {                |
|   "a": "value1", |
|   "b": "value2", |
|   "c": "value3"  |
| }                |
+------------------+

UPDATE object_insert_examples
  SET object_column = OBJECT_INSERT(object_column, 'd', PARSE_JSON('null'));

UPDATE object_insert_examples
  SET object_column = OBJECT_INSERT(object_column, 'e', NULL);

UPDATE object_insert_examples
  SET object_column = OBJECT_INSERT(object_column, 'f', 'null');

SELECT * FROM object_insert_examples;

+------------------+
| OBJECT_COLUMN    |
|------------------|
| {                |
|   "a": "value1", |
|   "b": "value2", |
|   "c": "value3", |
|   "d": null,     |
|   "f": "null"    |
| }                |
+------------------+

UPDATE object_insert_examples
  SET object_column = OBJECT_INSERT(object_column, 'b', 'valuex', TRUE);

SELECT * FROM object_insert_examples;

+------------------+
| OBJECT_COLUMN    |
|------------------|
| {                |
|   "a": "value1", |
|   "b": "valuex", |
|   "c": "value3", |
|   "d": null,     |
|   "f": "null"    |
| }                |
+------------------+