カテゴリ：: 半構造化データ関数と構造化データ関数（マップ）

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