Tous les produits
Search

Ce produit

    MaxCompute:ARRAY_REMOVE

    Centre de documentation

    MaxCompute:ARRAY_REMOVE

    Dernière mise à jour :Sep 17, 2026

    Supprime un élément 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 suivants sont pris en charge :

      • TINYINT, SMALLINT, INT, BIGINT

      • FLOAT, DOUBLE

      • BOOLEAN

      • DECIMAL, DECIMALVAL

      • DATE, DATETIME, TIMESTAMP, IntervalDayTime, IntervalYearMonth

      • STRING, BINARY, VARCHAR, CHAR

      • ARRAY, STRUCT, MAP

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

    Valeur de retour

    Renvoie une valeur de type ARRAY. Le résultat 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'élément element spécifié, le tableau a est renvoyé tel quel.

    Exemples

    • Exemple 1 : Supprimer 1 du tableau array(3, 2, 1). Instruction :

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

    • Exemple 2 : Le paramètre element spécifié est null. Instruction :

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

    • Exemple 3 : Supprimer 2 du tableau array(3, 1, null). 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 complexes (ARRAY, MAP, STRUCT et JSON), consultez la rubrique Fonctions de type complexe.