Catégories :

Fonctions de données semi-structurées et structurées (Carte)

MAP_CONTAINS_KEY

Détermine si la MAP spécifiée contient la clé spécifiée.

Syntaxe

MAP_CONTAINS_KEY( <key> , <map> )
Copy

Arguments

key

La clé à trouver.

map

La carte à rechercher.

Renvoie

  • Renvoie TRUE si la carte spécifiée contient la clé spécifiée.

  • Renvoie FALSE si la carte spécifiée ne contient pas la clé spécifiée.

Notes sur l’utilisation

  • Le type de l’expression de clé doit correspondre au type de la clé de la carte. Si le type est VARCHAR, les types peuvent être de longueurs différentes.

  • Pour une entrée NULL, la sortie est NULL.

Exemples

La fonction recherche la clé k1 et la trouve dans la carte :

SELECT MAP_CONTAINS_KEY(
  'k1',{'k1':'v1','k2':'v2','k3':'v3'}::MAP(VARCHAR,VARCHAR))
  AS contains_key;
Copy
+--------------+
| CONTAINS_KEY |
|--------------|
| True         |
+--------------+

La fonction recherche la clé k1 et ne la trouve pas dans la carte :

SELECT MAP_CONTAINS_KEY(
  'k1',{'ka':'va','kb':'vb','kc':'vc'}::MAP(VARCHAR,VARCHAR))
  AS contains_key;
Copy
+--------------+
| CONTAINS_KEY |
|--------------|
| False        |
+--------------+

Une instruction SELECT transmet une clé qui utilise un type différent de celui de la clé de la carte :

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))
Langage: Français