카테고리:

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

MAP_CONTAINS_KEY

지정된 MAP 에 지정된 키가 포함되어 있는지 확인합니다.

구문

MAP_CONTAINS_KEY( <key> , <map> )
Copy

인자

key

찾을 키입니다.

map

검색할 지도입니다.

반환

  • 지정된 지도에 지정된 키가 포함되어 있으면 TRUE를 반환합니다.

  • 지정된 지도에 지정된 키가 포함되어 있지 않으면 FALSE를 반환합니다.

사용법 노트

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

  • NULL 입력의 경우, 출력은 NULL입니다.

이 함수는 k1 키를 검색하여 지도에서 찾습니다.

SELECT MAP_CONTAINS_KEY(
  'k1',{'k1':'v1','k2':'v2','k3':'v3'}::MAP(VARCHAR,VARCHAR))
  AS contains_key;
Copy
+--------------+
| CONTAINS_KEY |
|--------------|
| True         |
+--------------+

이 함수는 k1 키를 검색하지만 지도에서 찾지 못합니다.

SELECT MAP_CONTAINS_KEY(
  'k1',{'ka':'va','kb':'vb','kc':'vc'}::MAP(VARCHAR,VARCHAR))
  AS contains_key;
Copy
+--------------+
| CONTAINS_KEY |
|--------------|
| False        |
+--------------+

SELECT 문은 지도의 키와 다른 유형을 사용하는 키를 전달합니다.

SELECT MAP_CONTAINS_KEY(
  'k1',{'1':'va','2':'vb','3':'vc'}::MAP(NUMBER,VARCHAR))
  AS contains_key;
Copy
001065 (22023): SQL compilation error:
Function MAP_CONTAINS_KEY cannot be used with arguments of types VARCHAR(2) and MAP(NUMBER(38,0), VARCHAR(134217728))

다음과 같이 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';
Copy

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

SELECT * FROM demo_maps;
Copy
+----+---------------------+----------------------+--------------+----------+---------+-----------------+----------+----------+
| 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"        | ]            |          |         |                 |          |          |
|    |                     | }                    |              |          |         |                 |          |          |
+----+---------------------+----------------------+--------------+----------+---------+-----------------+----------+----------+

attrs 열의 지도에 ins_key 열의 키가 포함되어 있습니다.

SELECT id, MAP_CONTAINS_KEY(ins_key, attrs) AS has_key
  FROM demo_maps;
Copy
+----+---------+
| ID | HAS_KEY |
|----+---------|
|  1 | False   |
|  2 | True    |
+----+---------+

출력은 다음을 보여줍니다.

  • 1attrs 열에 있는 맵에는 ins_key 열의 키(material)가 없습니다.

  • 2attrs 열에 있는 맵에는 ins_key 열의 키(brand)가 있습니다.