- カテゴリ:
半構造化データ関数と構造化データ関数 (マップ)
MAP_CONTAINS_KEY¶
指定された MAP に指定されたキーが含まれているかどうか判断します。
構文¶
MAP_CONTAINS_KEY( <key> , <map> )
引数¶
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;
+--------------+
| CONTAINS_KEY |
|--------------|
| True |
+--------------+
この関数は k1
キーを検索しますが、マップ内では見つけません。
SELECT MAP_CONTAINS_KEY(
'k1',{'ka':'va','kb':'vb','kc':'vc'}::MAP(VARCHAR,VARCHAR))
AS contains_key;
+--------------+
| CONTAINS_KEY |
|--------------|
| False |
+--------------+
SELECT ステートメントは、マップのキーとは異なる型を使用するキーを渡します。
SELECT MAP_CONTAINS_KEY(
'k1',{'1':'va','2':'vb','3':'vc'}::MAP(NUMBER,VARCHAR))
AS contains_key;
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';
テーブルをクエリしてデータを表示します。
SELECT * FROM demo_maps;
+----+---------------------+----------------------+--------------+----------+---------+-----------------+----------+----------+
| 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;
+----+---------+
| ID | HAS_KEY |
|----+---------|
| 1 | False |
| 2 | True |
+----+---------+
出力は次を示します。
行
1
のattrs
列のマップには、ins_key
列のキー (material
) が含まれていません。行
2
のattrs
列のマップには、ins_key
列のキー (brand
) が含まれています。