

 Amazon Redshift tidak akan lagi mendukung pembuatan Python UDFs baru mulai Patch 198. Python yang ada UDFs akan terus berfungsi hingga 30 Juni 2026. Untuk informasi lebih lanjut, 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/). 

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

# Fungsi JSON\$1ARRAY\$1LENGTH
<a name="JSON_ARRAY_LENGTH"></a>

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

Fungsi JSON\$1ARRAY\$1LENGTH mengembalikan jumlah elemen dalam array luar string JSON. Jika argumen *null\$1if\$1invalid* 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\$1array*  
Array JSON yang diformat dengan benar.

 *null\$1if\$1invalid*  
(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\$1if\$1invalid* 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              |
+-------------------+
```