Todos os produtos
Search
Central de documentação

MaxCompute:ARRAY_CONTAINS

Última atualização: Jun 26, 2026

Verifica se o elemento v existe no array a.

Formato do comando

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

Descrição dos parâmetros

  • a: obrigatório. Array. O T em array<T> indica o tipo de dados dos elementos do array, que podem ser de qualquer tipo.

  • v: obrigatório. Elemento a verificar. Deve ter o mesmo tipo de dados dos elementos do array a.

Valor de retorno

Retorna um valor BOOLEAN.

Exemplos de uso

Considere a tabela t_table_array com as colunas c1 bigint, t_array array<string> e os seguintes dados:

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

Exemplo de comando:

--检测t_array列是否包含1。
select c1, array_contains(t_array,'1') from t_table_array;
--返回结果如下。
+------------+------+
| c1         | _c1  |
+------------+------+
| 1000       | false |
| 1001       | false |
| 1002       | true |
+------------+------+

Funções relacionadas

A função ARRAY_CONTAINS 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 Complex type functions.