MAP_CONTAINS_KEY

MAP_CONTAINS_KEY (키 포함 확인)

지정된 MAP 값에 특정 키가 포함되어 있는지 확인해요. 키가 포함되어 있으면 TRUE를, 그렇지 않으면 FALSE를 반환해요.

출처: Snowflake SQL Reference - MAP_CONTAINS_KEY

본문

구문 (Syntax)

MAP_CONTAINS_KEY( <map_expr> , <key_value> )

인자 (Arguments)

map_expr

검색 대상이 되는 MAP 값이에요. MAP_CONTAINS_KEY가 지원하는 지도 데이터 구조:

  • 키-값 쌍으로 이루어진 OBJECT
  • 두 요소 배열(키, 값)의 ARRAY

key_value

MAP에서 키로 확인할 값이에요.

반환 값 (Returns)

map_expr이 key_value를 키로 포함하면 TRUE를 반환해요. 그렇지 않으면 FALSE를 반환해요. 어느 인자든 NULL이면 NULL을 반환해요.

사용 참고 사항 (Usage notes)

  • 이 함수는 대소문자를 구분(case-sensitive)해 키를 비교해요.
  • 내부적으로 이 함수는 OBJECT_KEYS 함수를 사용해 구현돼요. 따라서 이 함수는 OBJECT_KEYS 함수와 동일한 제한 사항을 따라요.

예시 (Examples)

SELECT MAP_CONTAINS_KEY(PARSE_JSON('{"a": 1, "b": 2}'), 'a');

+--------------------------------------------------+
| MAP_CONTAINS_KEY(PARSE_JSON('{"A": 1, "B": 2}'), 'A') |
|--------------------------------------------------|
| True                                             |
+--------------------------------------------------+

더 알아보기 (Learn more)