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 JSON\_ARRAY\_LENGTH
<a name="JSON_ARRAY_LENGTH"></a>

**catatan**  
JSON\_PARSE dan fungsi terkaitnya mengurai nilai JSON sebagai SUPER, yang diurai Amazon Redshift lebih efisien daripada VARCHAR.  
 Alih-alih menggunakan JSON\_ARRAY\_LENGTH, kami sarankan Anda mengurai string JSON Anda menggunakan untuk mendapatkan nilai SUPER. [Fungsi JSON\_PARSE](JSON_PARSE.md) Kemudian, gunakan [Fungsi GET\_ARRAY\_LENGTH](get_array_length.md) untuk mendapatkan panjang array Anda. 

Fungsi JSON\_ARRAY\_LENGTH mengembalikan jumlah elemen dalam array luar string JSON. Jika argumen *null\_if\_invalid* disetel ke `true` dan string JSON tidak valid, fungsi kembali alih-alih mengembalikan kesalahan. `NULL`

Untuk informasi selengkapnya, lihat [Fungsi JSON](json-functions.md). 

## Sintaks
<a name="JSON_ARRAY_LENGTH-synopsis"></a>

```
JSON_ARRAY_LENGTH('json_array' [, null_if_invalid ] ) 
```

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

 *json\_array*  
Array JSON yang diformat dengan benar.

 *null\_if\_invalid*  
(Opsional) `BOOLEAN` Nilai yang menentukan apakah akan kembali `NULL` jika input JSON string tidak valid alih-alih mengembalikan kesalahan. Untuk kembali `NULL` jika JSON tidak valid, tentukan `true` (). `t` Untuk mengembalikan kesalahan jika JSON tidak valid, tentukan `false` (). `f` Nilai default-nya `false`.

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

`INTEGER`

## Contoh
<a name="JSON_ARRAY_LENGTH-examples"></a>

Untuk mengembalikan jumlah elemen dalam array, gunakan contoh berikut. 

```
SELECT JSON_ARRAY_LENGTH('[11,12,13,{"f1":21,"f2":[25,26]},14]'); 

+-------------------+
| json_array_length |
+-------------------+
|                 5 |
+-------------------+
```

Untuk mengembalikan kesalahan karena JSON tidak valid, gunakan contoh berikut.

```
SELECT JSON_ARRAY_LENGTH('[11,12,13,{"f1":21,"f2":[25,26]},14');
 
ERROR: invalid json array object [11,12,13,{"f1":21,"f2":[25,26]},14
```

Untuk mengatur *null\_if\_invalid* ke *true*, sehingga pernyataan mengembalikan `NULL` alih-alih mengembalikan kesalahan untuk JSON yang tidak valid, gunakan contoh berikut.

```
SELECT JSON_ARRAY_LENGTH('[11,12,13,{"f1":21,"f2":[25,26]},14',true);

+-------------------+
| json_array_length |
+-------------------+
| NULL              |
+-------------------+
```