array_contains, fonction

S’applique à : Databricks SQL Databricks Runtime

Retourne la valeur true si array contient value.

Syntaxe

array_contains(array, value)

Arguments

• array : ARRAY à rechercher.
• value : expression contenant un type qui partage un type moins commun avec les éléments array.

Retours

BOOLEAN. Si value est NULL, le résultat est NULL. Si un élément de array est NULL, le résultat est NULL si value n’est pas mis en correspondance avec un autre élément.

Exemples

> SELECT array_contains(array(1, 2, 3), 2);
 true

> SELECT array_contains(array(1, NULL, 3), 2);
 NULL

> SELECT array_contains(array(1, 2, 3), NULL::INT);
 NULL

-- You cannot test for a NULL value in an array using this function.
-- Use the exists function with a lambda instead.
> SELECT array_contains(array(1, 2, NULL, 3), NULL::INT);
 NULL

> SELECT exists(array(1, 2, NULL, 3), x -> x IS NULL);
 true

> SELECT exists(array(1, 2, 3), x -> x IS NULL);
 false

Rubriques connexes

• Opérateur [ ] (crochet)
• Fonction arrays_overlap
• Fonction array_position
• Fonction exists
• Règles de type de données SQL