카테고리:

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

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(16777216))