카테고리:

반정형 및 정형 데이터 함수 (지도)

MAP_INSERT

새 키-값 페어가 삽입된 입력 MAP로 구성된 새 :doc:`MAP </sql-reference/data-types-structured>`를 반환합니다. 즉, 기존 키는 새 값으로 업데이트됩니다.

구문

MAP_INSERT( <map> , <key> , <value> [ , <updateFlag> ] )

인자

map

새 키-값 페어가 삽입되는 원본 지도입니다.

key

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

value

키와 연결된 값입니다.

선택 사항

updateFlag

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

기본값은 FALSE입니다.

반환

새 키-값 페어가 삽입되거나 새 값으로 업데이트된 기존 키가 있는 입력 MAP으로 구성된 MAP을 반환합니다.

사용법 노트

  • 키 식의 유형은 지도의 키 유형과 일치해야 합니다. 유형이 VARCHAR인 경우 유형의 길이가 다를 수 있습니다.

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

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

    • key 가 NULL이 아닌 다른 문자열이고 value 가 SQL NULL(예: NULL)인 경우 값이 JSON null로 변환되고 반환된 지도에 키-값 페어가 삽입됩니다.

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

  • updateFlag 가 TRUE로 설정된 경우 기존 입력 key 가 입력 value 로 업데이트됩니다. updateFlag 가 생략되거나 FALSE로 설정되고 입력 키가 이미 지도에 존재하는 경우 오류가 반환됩니다.

  • updateFlag 가 TRUE로 설정되었지만 해당 키가 지도에 아직 존재하지 않는 경우 키-값 페어가 추가됩니다.

예

두 개의 키-값 페어를 포함하는 지도에 세 번째 키-값 페어를 삽입합니다.

SELECT MAP_INSERT({'a':1,'b':2}::MAP(VARCHAR,NUMBER),'c',3);

+------------------------------------------------------+
| MAP_INSERT({'A':1,'B':2}::MAP(VARCHAR,NUMBER),'C',3) |
|------------------------------------------------------|
| {                                                    |
|   "a": 1,                                            |
|   "b": 2,                                            |
|   "c": 3                                             |
| }                                                    |
+------------------------------------------------------+

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

  • Key_One 는 JSON null 값으로 구성됩니다.

  • Key_Two 는 JSON null 값으로 변환되는 SQL NULL 값으로 구성됩니다.

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

SELECT MAP_INSERT(MAP_INSERT(MAP_INSERT({}::MAP(VARCHAR,VARCHAR),
  'Key_One', PARSE_JSON('NULL')), 'Key_Two', NULL), 'Key_Three', 'null');

+---------------------------------------------------------------------------+
| MAP_INSERT(MAP_INSERT(MAP_INSERT({}::MAP(VARCHAR,VARCHAR),                |
|    'KEY_ONE', PARSE_JSON('NULL')), 'KEY_TWO', NULL), 'KEY_THREE', 'NULL') |
|---------------------------------------------------------------------------|
| {                                                                         |
|   "Key_One": null,                                                        |
|   "Key_Three": "null",                                                    |
|   "Key_Two": null                                                         |
| }                                                                         |
+---------------------------------------------------------------------------+

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

SELECT MAP_INSERT({'k1':100}::MAP(VARCHAR,VARCHAR), 'k1', 'string-value', TRUE) AS map;

+------------------------+
| MAP                    |
|------------------------|
| {                      |
|   "k1": "string-value" |
| }                      |
+------------------------+

다음과 같이 MAP 값이 포함된 임시 테이블을 만듭니다.

CREATE OR REPLACE TEMP TABLE demo_maps(
  id INTEGER,
  attrs MAP(VARCHAR, VARCHAR),
  defaults MAP(VARCHAR, VARCHAR),
  keep_keys ARRAY(VARCHAR),
  ins_key VARCHAR,
  ins_val VARCHAR,
  update_existing BOOLEAN,
  del_key1 VARCHAR,
  del_key2 VARCHAR);

INSERT INTO demo_maps SELECT
  1,
  {'color':'red','size':'M','brand':'Acme'}::MAP(VARCHAR, VARCHAR),
  {'currency':'USD','size':'L'}::MAP(VARCHAR, VARCHAR),
  ['color','brand']::ARRAY(VARCHAR),
  'material',
  'cotton',
  TRUE,
  'size',
  'brand';

INSERT INTO demo_maps SELECT
  2,
  {'color':'blue','brand':'ZenCo'}::MAP(VARCHAR, VARCHAR),
  {'currency':'EUR','size':'M','brand':'ZenCo'}::MAP(VARCHAR, VARCHAR),
  ['brand','currency']::ARRAY(VARCHAR),
  'brand',
  'ZC',
  FALSE,
  'currency',
  'material';

테이블을 쿼리하여 데이터를 표시합니다.

SELECT * FROM demo_maps;

+----+---------------------+----------------------+--------------+----------+---------+-----------------+----------+----------+
| ID | ATTRS               | DEFAULTS             | KEEP_KEYS    | INS_KEY  | INS_VAL | UPDATE_EXISTING | DEL_KEY1 | DEL_KEY2 |
|----+---------------------+----------------------+--------------+----------+---------+-----------------+----------+----------|
|  1 | {                   | {                    | [            | material | cotton  | True            | size     | brand    |
|    |   "brand": "Acme",  |   "currency": "USD", |   "color",   |          |         |                 |          |          |
|    |   "color": "red",   |   "size": "L"        |   "brand"    |          |         |                 |          |          |
|    |   "size": "M"       | }                    | ]            |          |         |                 |          |          |
|    | }                   |                      |              |          |         |                 |          |          |
|  2 | {                   | {                    | [            | brand    | ZC      | False           | currency | material |
|    |   "brand": "ZenCo", |   "brand": "ZenCo",  |   "brand",   |          |         |                 |          |          |
|    |   "color": "blue"   |   "currency": "EUR", |   "currency" |          |         |                 |          |          |
|    | }                   |   "size": "M"        | ]            |          |         |                 |          |          |
|    |                     | }                    |              |          |         |                 |          |          |
+----+---------------------+----------------------+--------------+----------+---------+-----------------+----------+----------+

ins_key 열의 키와 ins_val 열의 값을 사용하여 attrs 열의 지도에서 키-값 페어를 삽입하거나 업데이트합니다.

SELECT id, MAP_INSERT(attrs, ins_key, ins_val, TRUE) AS attrs_insert_or_update
  FROM demo_maps;

+----+-------------------------+
| ID | ATTRS_INSERT_OR_UPDATE  |
|----+-------------------------|
|  1 | {                       |
|    |   "brand": "Acme",      |
|    |   "color": "red",       |
|    |   "material": "cotton", |
|    |   "size": "M"           |
|    | }                       |
|  2 | {                       |
|    |   "brand": "ZC",        |
|    |   "color": "blue"       |
|    | }                       |
+----+-------------------------+