Todos os produtos
Search
Central de documentação

MaxCompute:ARRAY_CONTAINS

Última atualização: Sep 22, 2026

Verifica se o array a contém o elemento v.

Sintaxe

boolean array_contains(array<T> <a>, value <v>)

Parâmetros

  • a: obrigatório. Especifica um array. T em array<T> define o tipo de dados dos elementos do array. Os elementos podem ser de qualquer tipo de dados.

  • v: obrigatório. Especifica o elemento que você deseja verificar. O valor de v deve ter o mesmo tipo de dados dos elementos no array a.

Valor de retorno

Retorna um valor do tipo BOOLEAN.

Exemplos

Crie um array com base nos dados da tabela t_table_array, que contém as colunas c1 (BIGINT) and t_array (ARRAY<STRING>). Dados da tabela:

+------------+---------+
| c1         | t_array |
+------------+---------+
| 1000       | [k11, 86, k21, 15] |
| 1001       | [k12, 97, k22, 2] |
| 1002       | [k13, 99, k23, 1] |
+------------+---------+

Exemplo de instrução:

-- Check whether the t_array column contains the value 1. 
select c1, array_contains(t_array,'1') from t_table_array;
-- The following result is returned: 
+------------+------+
| c1         | _c1  |
+------------+------+
| 1000       | false |
| 1001       | false |
| 1002       | true |
+------------+------+

Funções relacionadas

ARRAY_CONTAINS é uma função de tipo complexo. Para mais informações sobre as funções usadas para processar dados de tipos complexos, como ARRAY, MAP, STRUCT e JSON, consulte Complex type functions.