Vérifie si les tableaux a et b contiennent un élément commun.
Syntaxe
boolean arrays_overlap(array<T> <a>, array<T> <b>)
Paramètres
a et b : obligatoires. Ces paramètres désignent des tableaux. Le type T dans array<T> indique le type de données des éléments contenus dans les tableaux. Les éléments peuvent être de n'importe quel type. Les éléments du tableau a et ceux du tableau b doivent toutefois être du même type.
Les types de données suivants sont pris en charge :
TINYINT, SMALLINT, INT et BIGINT
FLOAT et DOUBLE
BOOLEAN
DECIMAL et DECIMALVAL
DATE, DATETIME, TIMESTAMP, IntervalDayTime et IntervalYearMonth
STRING, BINARY, VARCHAR et CHAR
ARRAY, STRUCT et MAP
Valeur renvoyée
La fonction renvoie une valeur de type BOOLEAN. La valeur de retour dépend des règles suivantes :
Si le tableau a contient au moins un élément présent dans le tableau b et que cet élément n'est pas null, la fonction renvoie true.
Si les tableaux a et b ne partagent aucun élément commun, qu'aucun des deux tableaux n'est vide et que l'un d'eux (ou les deux) contient un élément null, la fonction renvoie null.
Si les tableaux a et b ne partagent aucun élément commun, qu'aucun des deux tableaux n'est vide et qu'aucun ne contient d'élément null, la fonction renvoie false.
Exemples
-
Exemple 1 : Vérifiez si
array(1, 2, 3)etarray(3, 4, 5)contiennent un élément commun. Exemple de commande :-- The return value is true. select arrays_overlap(array(1, 2, 3), array(3, 4, 5)); -
Exemple 2 : Vérifiez si
array(1, 2, 3)etarray(6, 4, 5)contiennent un élément commun. Exemple de commande :-- The return value is false. select arrays_overlap(array(1, 2, 3), array(6, 4, 5)); -
Exemple 3 : Vérifiez si l'un des tableaux contient un élément null. Exemple de commande :
-- The return value is null. select arrays_overlap(array(1, 2, 3), array(5, 4, null));
Fonctions associées
ARRAYS_OVERLAP est une fonction de type complexe. Pour plus d'informations sur les fonctions utilisées pour traiter les données de types complexes, tels que ARRAY, MAP, STRUCT et JSON, consultez la section Fonctions de type complexe.