Tous les produits
Search

Ce produit

    MaxCompute:ARRAY_REMOVE

    Centre de documentation

    MaxCompute:ARRAY_REMOVE

    Dernière mise à jour :Sep 22, 2026

    Supprime un element donné du tableau a.

    Syntaxe

    array<T> array_remove(array<T> <a>, T <element>)

    Paramètres

    • a : obligatoire. Tableau d'entrée. Le type T dans array<T> indique le type de données des éléments du tableau. 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

    • element : obligatoire. Élément à supprimer. Son type de données doit correspondre à celui des éléments du tableau a.

    Valeur renvoyée

    Renvoie une valeur de type ARRAY. La valeur de retour dépend des règles suivantes :

    • Si un élément du tableau a est null, il n'est pas pris en compte lors de l'opération.

    • Si le tableau a ou le paramètre element est null, la fonction renvoie null.

    • Si le tableau a ne contient pas l'element spécifié, le tableau a est renvoyé tel quel.

    Exemples

    • Exemple 1 : Supprimer 1 de array(3, 2, 1). Exemple d'instruction :

      -- The return value is [3,2]. 
select array_remove(array(3, 2, 1), 1);

    • Exemple 2 : L'element spécifié est null. Exemple d'instruction :

      -- The return value is null. 
select array_remove(array(3, 1, null), null);

    • Exemple 3 : Supprimer 2 de array(3, 1, null). Exemple d'instruction :

      -- The return value is [3,1,null]. 
select array_remove(array(3, 1, null), 2);

    Fonctions associées

    ARRAY_REMOVE est une fonction de type complexe. Pour plus d'informations sur les fonctions de traitement des types de données complexes (ARRAY, MAP, STRUCT et JSON), consultez la rubrique Fonctions de type complexe.