ARRAY_REMOVE - MaxCompute: Central de Documentação do Alibaba Cloud

Remove elementos iguais a element do array a.

Formato do comando

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

Descrição dos parâmetros

a: obrigatório. Array. O T em array<T> indica o tipo de dados dos elementos do array. Tipos de dados compatíveis:
- TINYINT, SMALLINT, INT, BIGINT
- FLOAT, DOUBLE
- BOOLEAN
- DECIMAL, DECIMALVAL
- DATE, DATETIME, TIMESTAMP, IntervalDayTime, IntervalYearMonth
- STRING, BINARY, VARCHAR, CHAR
- ARRAY, STRUCT, MAP
element: obrigatório. Elemento a remover. Deve ter o mesmo tipo de dados dos elementos em a.

Valor de retorno

Retorna um valor do tipo ARRAY. Regras de retorno:

Valores NULL no array a não participam da operação.
Retorna NULL se o array a ou o parâmetro element for NULL.
Se element não existir no array a, a função retorna o array original a inalterado.

Exemplos de uso

Exemplo 1: remova elementos iguais a 1 do array array(3, 2, 1). Comando:
```
--返回[3,2]。
select array_remove(array(3, 2, 1), 1);
```

Exemplo 2: element é NULL. Comando:

--返回NULL。
select array_remove(array(3, 1, null), null);

Exemplo 3: remova elementos iguais a 2 do array array(3, 1, null). Comando:
```
--返回[3,1,null]。
select array_remove(array(3, 1, null), 2);
```

Funções relacionadas

A função ARRAY_REMOVE pertence ao grupo de funções de tipos complexos. Para outras funções de processamento de dados de tipos complexos (como ARRAY, MAP, STRUCT e JSON), consulte Funções de tipos complexos.