カテゴリ：

半構造化データ関数と構造化データ関数 （マップ）

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))
言語: 日本語