メインコンテンツまでスキップ
バージョン: 26.x

MAP_CONTAINS_KEY

説明

指定されたmapが特定のキーkeyを含んでいるかどうかを判定します

構文

MAP_CONTAINS_KEY(<map>, <key>)

パラメータ

  • <map> MAP 型、入力するマップのコンテンツ。
  • <key> MAP でサポートされているキー型、検索対象のキー。

戻り値

指定された map が特定のキー key を含むかどうかを判定し、存在する場合は1を返し、存在しない場合は0を返します。

select map_contains_key(map(null, 1, 2, null), null),map_contains_key(map(1, "100", 0.1, 2), 0.11);
+-----------------------------------------------+-----------------------------------------------+
| map_contains_key(map(null, 1, 2, null), null) | map_contains_key(map(1, "100", 0.1, 2), 0.11) |
+-----------------------------------------------+-----------------------------------------------+
| 1 | 0 |
+-----------------------------------------------+-----------------------------------------------+

Mapでのキー比較は「null安全等価」を使用します(nullとnullは等しいとみなされます)。これは以下とは異なります

select map_contains_key(map(null,1), null);
+-------------------------------------+
| map_contains_key(map(null,1), null) |
+-------------------------------------+
| 1 |
+-------------------------------------+