Categorias:

Funções de dados semiestruturados e estruturados (Mapa)

MAP_CONTAINS_KEY

Determina se o MAP especificado contém a chave especificada.

Sintaxe

MAP_CONTAINS_KEY( <key> , <map> )
Copy

Argumentos

key

A chave a ser encontrada.

map

O mapa a ser pesquisado.

Retornos

  • Retornará TRUE se o mapa especificado contiver a chave especificada.

  • Retornará FALSE se o mapa especificado não contiver a chave especificada.

Notas de uso

  • O tipo da expressão-chave deve corresponder ao tipo da chave do mapa. Se o tipo for VARCHAR, os tipos poderão ter comprimentos diferentes.

  • Para a entrada NULL, a saída será NULL.

Exemplos

A função procura a chave k1 e a encontra no mapa:

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

A função procura a chave k1 e não a encontra no mapa:

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

Uma instrução SELECT passa uma chave que usa um tipo diferente da chave no mapa:

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))
Linguagem: Português