Amazon Redshift dejará de admitir la creación de UDF de Python después del 30 de junio de 2026. Empezaremos a aplicarlo por fases. Para obtener más información sobre los detalles del fin de vida de Python y las opciones de migración, consulte la [entrada del blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/) que se publicó el 30 de junio de 2025. 

# Función ARRAY\_CONTAINS
<a name="array_contains"></a>

Comprueba si la matriz contiene el valor dado y devuelve TRUE si lo encuentra.

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

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

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

 *array*   
Una expresión SUPER que especifica la matriz en la que se va a buscar.

 *valor de*   
Un valor que especifica el elemento que se va a buscar.

 *null\_match*   
Un valor booleano que especifica cómo se gestionan los valores NULL:  
+ *null\_match* = FALSE: al buscar NULL, devuelve NULL. Si la matriz contiene valores NULL y no se encuentra ninguna coincidencia para un valor de búsqueda distinto de NULL, devuelve NULL.
+ *null\_match* = TRUE: los valores NULL se tratan como elementos válidos y susceptibles de búsqueda. Si la matriz contiene valores NULOS y no se encuentra ninguna coincidencia con un valor de búsqueda distinto de NULL, devuelve FALSE.
El valor predeterminado es TRUE.  
La gestión predeterminada de NULL también se puede especificar mediante la opción de configuración:  

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

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

La función ARRAY\_CONTAINS devuelve un tipo BOOLEAN.

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

Los ejemplos siguientes muestran la función ARRAY\_CONTAINS.

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

Los ejemplos siguientes muestran el comportamiento de la función con *null\_match* establecido en 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)
```

Los ejemplos siguientes muestran el comportamiento de la función con *null\_match* establecido en FALSE. Tenga en cuenta que si se especifica el comportamiento *null\_match* en la función, se anulará el valor de configuración predeterminado.

```
-- 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)
```

## Véase también
<a name="array_contains-see-also"></a>
+ [Función ARRAY\_POSITION](array_position.md)
+ [Función ARRAY\_POSITIONS](array_positions.md)
+ [Función ARRAYS\_OVERLAP](arrays_overlap.md)