Central de documentação

Todos os produtos

Central de documentação

MaxCompute:ANY_MATCH

Última atualização: Sep 22, 2026

Verifica se algum elemento no array a atende à condição do predicate.

Sintaxe

boolean any_match(array<T> <a>, function<T, boolean> <predicate>)

Parâmetros

a: obrigatório. Especifica um array. T em array<T> indica o tipo de dados dos elementos do array. Os elementos podem ser de qualquer tipo de dado.
predicate: obrigatório. Especifica a função interna, a função definida pelo usuário ou a expressão que determina se todos os elementos do array a atendem aos requisitos. O tipo de dados do parâmetro de entrada deve ser igual ao dos elementos do array a.

Valor de retorno

Retorna um valor do tipo BOOLEAN. O valor retornado segue as regras abaixo:

Se um ou mais elementos do array a atenderem à condição do predicate, retorna true.
Se nenhum elemento do array a atender à condição do predicate ou se o array estiver vazio, retorna false.
Se um elemento do array a for nulo e os demais não atenderem à condição do predicate, retorna null.

Exemplos

Exemplo 1: Verifica se algum elemento em array(1, 2, -10, 100, -30) atende à condição xx > 3. Instrução:
```
-- The return value is true. 
select any_match(array(1, 2, -10, 100, -30), x-> x > 3);
```

Exemplo 2: O array está vazio. Instrução:

-- The return value is false. 
select any_match(array(), x-> x > 3);

Exemplo 3: Verifica se algum elemento em array(1, 2, -10, -20, -30) atende à condição x-> x > 3. Instrução:
```
-- The return value is false. 
select any_match(array(1, 2, -10, -20, -30), x-> x > 3);
```
Exemplo 4: Verifica se algum elemento em array(1, 2, null, -10) atende à condição x-> x > 3. Instrução:
```
-- The return value is null. 
select any_match(array(1, 2, null, -10), x-> x > 3);
```

Funções relacionadas

ANY_MATCH é uma função de tipos complexos. Para obter mais informações sobre as funções usadas para processar dados de tipos complexos, como ARRAY, MAP, STRUCT e JSON, consulte Complex type functions.
Os exemplos anteriores usam a combinação de um hífen e um sinal de maior que (->). Para mais informações sobre o uso dessa combinação em funções Lambda, consulte Lambda functions.