ARRAY_REMOVE - MaxCompute - Centre de documentation Alibaba Cloud

Supprime les éléments égaux à element du tableau a.

Syntaxe

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

Paramètres

a : obligatoire. Tableau de type ARRAY. Le paramètre T dans array<T> représente le type de données des éléments du tableau. Les types de données 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 être identique à celui des éléments du tableau a.

Valeur de retour

Renvoie une valeur de type ARRAY. Les règles de retour sont les suivantes :

Si le tableau a contient des valeurs NULL, celles-ci ne sont pas prises en compte lors du traitement.
Si le tableau a ou element est NULL, la fonction renvoie NULL.
Si le tableau a ne contient pas l'élément element, la fonction renvoie le tableau d'origine a.

Exemples

Exemple 1 : Supprime l'élément égal à 1 du tableau array(3, 2, 1). Voici la commande correspondante.
```
--返回[3,2]。
select array_remove(array(3, 2, 1), 1);
```
Exemple 2 : Le paramètre element est NULL. Voici la commande correspondante.
```
--返回NULL。
select array_remove(array(3, 1, null), null);
```
Exemple 3 : Supprime l'élément égal à 2 du tableau array(3, 1, null). Voici la commande correspondante.
```
--返回[3,1,null]。
select array_remove(array(3, 1, null), 2);
```

Fonctions associées

La fonction ARRAY_REMOVE fait partie des fonctions de type complexe. Pour plus d'informations sur les fonctions de traitement des données de type complexe (telles que ARRAY, MAP, STRUCT et JSON), consultez la rubrique Complex type functions.