Tous les produits
Search
Centre de documentation

MaxCompute:ARRAYS_OVERLAP

Dernière mise à jour :Sep 21, 2026

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) et array(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) et array(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.