Amazon Redshift tidak akan lagi mendukung pembuatan UDF Python baru mulai Patch 198. UDF Python yang ada 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\_EXTRACT\_ARRAY\_ELEMENT\_TEXT
<a name="JSON_EXTRACT_ARRAY_ELEMENT_TEXT"></a>

**catatan**  
JSON\_PARSE dan fungsi terkaitnya mengurai nilai JSON sebagai SUPER, yang diurai Amazon Redshift lebih efisien daripada VARCHAR.  
Alih-alih menggunakan JSON\_EXTRACT\_ARRAY\_ELEMENT\_TEXT, kami sarankan Anda mengurai string JSON Anda menggunakan untuk mendapatkan nilai SUPER. [Fungsi JSON\_PARSE](JSON_PARSE.md) Kemudian, kueri elemen yang Anda inginkan menggunakan indeks array, menggunakan `value[element position]` sintaks. Untuk informasi lebih lanjut tentang menanyakan elemen array dalam nilai SUPER, buka. [Meminta data semi-terstruktur](query-super.md)

Fungsi JSON\_EXTRACT\_ARRAY\_ELEMENT\_TEXT mengembalikan elemen array JSON dalam array terluar dari string JSON, menggunakan indeks berbasis nol. Elemen pertama dalam array berada pada posisi 0. Jika indeks negatif atau di luar batas, JSON\_EXTRACT\_ARRAY\_ELEMENT\_TEXT kembali. `NULL` 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_EXTRACT_ARRAY_ELEMENT_TEXT-synopsis"></a>

```
JSON_EXTRACT_ARRAY_ELEMENT_TEXT('json string', pos [, null_if_invalid ] )
```

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

 *json\_string*  
String JSON yang diformat dengan benar.

*pos*  
Sebuah `INTEGER` mewakili indeks elemen array yang akan dikembalikan, menggunakan indeks array berbasis nol.

*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_EXTRACT_ARRAY_ELEMENT_TEXT-return"></a>

`VARCHAR`  
*Sebuah `VARCHAR` string yang mewakili elemen array JSON direferensikan oleh pos.*

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

Untuk mengembalikan elemen array pada posisi 2, yang merupakan elemen ketiga dari indeks array berbasis nol, gunakan contoh berikut. 

```
SELECT JSON_EXTRACT_ARRAY_ELEMENT_TEXT('[111,112,113]', 2);
 
+---------------------------------+
| json_extract_array_element_text |
+---------------------------------+
|                             113 |
+---------------------------------+
```

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

```
SELECT JSON_EXTRACT_ARRAY_ELEMENT_TEXT('["a",["b",1,["c",2,3,null,]]]',1);
 
ERROR: invalid json array object ["a",["b",1,["c",2,3,null,]]]
```

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

```
SELECT JSON_EXTRACT_ARRAY_ELEMENT_TEXT('["a",["b",1,["c",2,3,null,]]]',1,true);
 
+---------------------------------+
| json_extract_array_element_text |
+---------------------------------+
| NULL                            |
+---------------------------------+
```

Perhatikan contoh pernyataan berikut. Jika string JSON yang disediakan atau indeks adalah NULL, JSON\_EXTRACT\_ARRAY\_ELEMENT\_TEXT mengembalikan NULL terlepas dari nilai parameter lainnya. 

```
--Statement where json_string is NULL.
SELECT json_extract_array_element_text(NULL, 0)

 json_extract_array_element_text
---------------------------------
                            NULL

--Statement where pos is NULL and json_string is invalid JSON.
SELECT json_extract_array_element_text('invalid_json', NULL);

 json_extract_array_element_text
---------------------------------
                            NULL

--Statement where json_string is NULL and null_if_invalid is FALSE.
SELECT json_extract_array_element_text(NULL, 0, FALSE);

 json_extract_array_element_text
---------------------------------
                            NULL
```

Perhatikan contoh pernyataan berikut. *Ketika *null\_if\_invalid TRUE, JSON\_EXTRACT\_ARRAY\_ELEMENT\_TEXT mengembalikan NULL ketika json\_string JSON tidak valid*.* *Jika *null\_if\_invalid adalah FALSE* atau tidak disetel, fungsi mengembalikan kesalahan ketika json\_string tidak valid.*

```
--Statement with invalid JSON where null_if_invalid is TRUE.
SELECT json_extract_array_element_text('invalid_json', 0, TRUE);

 json_extract_array_element_text
---------------------------------
                            NULL
                            
--Statement with invalid JSON where null_if_invalid is FALSE.
SELECT json_extract_array_element_text('invalid_json', 0);

ERROR:  JSON parsing error
```

Perhatikan contoh berikut, di mana *json\_string* adalah JSON yang valid, dan *pos mengacu pada nilai* JSON. `null` *Dalam hal ini, JSON\_EXTRACT\_ARRAY\_ELEMENT\_TEXT mengembalikan NULL, terlepas dari nilai null\_if\_invalid.*

```
--Statement selecting a null value.
SELECT json_extract_array_element_text('[null]', 0);

  json_extract_array_element_text 
----------------------------------
                             NULL
```