Amazon Redshift tidak akan lagi mendukung penggunaan Python UDF setelah 30 Juni 2026. Kami akan mulai menegakkannya secara bertahap. Untuk informasi lebih lanjut tentang detail opsi akhir masa pakai dan migrasi Python, lihat posting [ blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/) yang diterbitkan pada 30 Juni 2025. 

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Fungsi ARRAY\_CONTAINS
<a name="array_contains"></a>

Memeriksa apakah array berisi nilai yang diberikan dan mengembalikan TRUE jika ditemukan.

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

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

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

 *array*   
Ekspresi SUPER yang menentukan array untuk mencari.

 *nilai*   
Sebuah nilai yang menentukan elemen untuk mencari.

 *null\_match*   
Sebuah nilai boolean yang menentukan bagaimana nilai-nilai NULL ditangani:  
+ *null\_match* = FALSE: Mencari NULL mengembalikan NULL. Jika array berisi nilai NULL dan tidak ada kecocokan ditemukan untuk nilai pencarian non-NULL, mengembalikan NULL.
+ *null\_match* = TRUE: NULL diperlakukan sebagai elemen yang valid dan dapat dicari. Jika array berisi nilai NULL dan tidak ada kecocokan ditemukan untuk nilai pencarian non-NULL, ia mengembalikan FALSE.
Defaultnya adalah BETUL.  
Penanganan NULL default juga dapat ditentukan oleh opsi konfigurasi:  

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

## Jenis pengembalian
<a name="array_contains-return-type"></a>

Fungsi ARRAY\_CONTAINS mengembalikan tipe BOOLEAN.

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

Contoh berikut menunjukkan fungsi ARRAY\_CONTAINS.

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

Contoh berikut menunjukkan perilaku fungsi dengan *null\_match* disetel ke 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)
```

Contoh berikut menunjukkan perilaku fungsi dengan *null\_match* disetel ke FALSE. Perhatikan bahwa menentukan perilaku *null\_match* dalam fungsi akan mengganti pengaturan konfigurasi default.

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

## Lihat juga
<a name="array_contains-see-also"></a>
+ [Fungsi ARRAY\_POSITION](array_position.md)
+ [Fungsi ARRAY\_POSITIONS](array_positions.md)
+ [Fungsi ARRAYS\_OVERLAP](arrays_overlap.md)