O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a [publicação de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# Função ARRAY\$1CONTAINS
<a name="array_contains"></a>

Verifica se a matriz contém o valor fornecido e exibe TRUE se for encontrada.

## Sintaxe
<a name="array_contains-syntax"></a>

```
ARRAY_CONTAINS( array, value [, null_match] )
```

## Argumentos
<a name="array_contains-arguments"></a>

 *array*   
Uma expressão SUPER que especifica a matriz na qual pesquisar.

 *valor*   
Um valor que especifica o elemento a ser pesquisado.

 *null\$1match*   
Um valor booliano que especifica como os valores NULL são tratados:  
+ *null\$1match* = FALSE: a pesquisa por NULL exibe NULL. Se a matriz contiver valores NULL e nenhuma correspondência for encontrada para um valor de pesquisa não NULL, exibirá NULL.
+ *null\$1match* = TRUE: os valores NULL são tratados como elementos válidos e pesquisáveis. Se a matriz contiver valores NULL e nenhuma correspondência for encontrada para um valor de pesquisa não NULL, exibirá FALSE.
O padrão é TRUE.  
O tratamento padrão de NULL também pode ser especificado pela opção de configuração:  

```
-- same as null_match = TRUE
SET default_array_search_null_handling to TRUE;
```

## Tipo de retorno
<a name="array_contains-return-type"></a>

A função ARRAY\$1CONTAINS exibe um tipo BOOLIANO.

## Exemplo
<a name="array_contains-example"></a>

Os exemplos a seguir mostram a função ARRAY\$1CONTAINS.

```
SELECT ARRAY_CONTAINS(ARRAY('red', 'green'), 'red');
array_contains
----------------
 t
(1 row)
```

Os exemplos a seguir mostram o comportamento da função com *null\$1match* definido como TRUE.

```
SET default_array_search_null_handling to TRUE;

-- NULL search is enabled
SELECT ARRAY_CONTAINS(ARRAY('red', NULL, 'green'), NULL);
array_contains
----------------
 t
(1 row)

-- The array can contain NULLs
SELECT ARRAY_CONTAINS(ARRAY('red', NULL, 'green'), 'blue', TRUE);
array_contains
----------------
 f
(1 row)
```

Os exemplos a seguir mostram o comportamento da função com *null\$1match* definido como FALSE. Observe que, ao especificar o comportamento *null\$1match* na função, a configuração padrão será substituída.

```
-- same as null_match = TRUE
SET default_array_search_null_handling to TRUE;

-- NULL search is disabled. The default behavior is overridden
SELECT ARRAY_CONTAINS(ARRAY('red', 'green'), NULL, FALSE);
array_contains
----------------
 
(1 row)

-- same as null_match = FALSE
SET default_array_search_null_handling to FALSE;

-- The array contains NULL and a match is found
SELECT ARRAY_CONTAINS(ARRAY('red', NULL, 'green'), 'green');
array_contains
----------------
 t
(1 row)

-- The array contains NULL but no match is found
SELECT ARRAY_CONTAINS(ARRAY('red', NULL, 'green'), 'blue');
array_contains
----------------
 
(1 row)
```

## Consulte também
<a name="array_contains-see-also"></a>
+ [Função ARRAY\$1POSITION](array_position.md)
+ [Função ARRAY\$1POSITIONS](array_positions.md)
+ [Função ARRAYS\$1OVERLAP](arrays_overlap.md)