Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 Python UDF 將繼續正常運作至 2026 年 6 月 30 日。如需詳細資訊，請參閱[部落格文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# JSON\$1EXTRACT\$1ARRAY\$1ELEMENT\$1TEXT 函數
**注意**
JSON\$1PARSE 及其相關聯的函式會將 JSON 值剖析為 SUPER，Amazon Redshift 會剖析這類值的效率比剖析 VARCHAR 更高。
建議您使用 [JSON\$1PARSE 函數](JSON_PARSE.md) 剖析 JSON 字串來取得 SUPER 值，而不要使用 JSON\$1EXTRACT\$1ARRAY\$1ELEMENT\$1TEXT。然後使用陣列索引與 `value[element position]` 語法查詢您要的元素。如需在 SUPER 值中查詢陣列元素的詳細資訊，請前往 [查詢半結構化資料](query-super.md)。
JSON\$1EXTRACT\$1ARRAY\$1ELEMENT\$1TEXT 函數傳回 JSON 字串最外圍陣列中的 JSON 陣列元素 (採用以零開始的索引)。陣列的第一個元素在位置 0。如果索引是負數或超出邊界，JSON\$1EXTRACT\$1ARRAY\$1ELEMENT\$1TEXT 會傳回 `NULL`。如果 *null\$1if\$1invalid* 引數設為 `TRUE`，且 JSON 字串無效，此函數會傳回 `NULL`，而非傳回錯誤。
如需詳細資訊，請參閱[JSON 函數](json-functions.md)。
## 語法
```
JSON_EXTRACT_ARRAY_ELEMENT_TEXT('json string', pos [, null_if_invalid ] )
```
## 引數
*json\$1string*
格式正確的 JSON 字串。
*pos*
`INTEGER`，代表要傳回之陣列元素的索引 (採用以零開始的陣列索引)。
*null\$1if\$1invalid*
(選用) `BOOLEAN` 值，指定輸入 JSON 字串無效時是否傳回 `NULL`，而非傳回錯誤。若要在 JSON 無效時傳回 `NULL`，請指定 `true` (`t`)。若要在 JSON 無效時傳回錯誤，請指定 `false` (`f`)。預設值為 `false`。
## 傳回類型
`VARCHAR`
`VARCHAR` 字串，代表 *pos* 所參考的 JSON 陣列元素。
## 範例
若要傳回位置 2 的陣列元素 (即從零開始之陣列索引的第三個元素)，請使用下列範例。
```
SELECT JSON_EXTRACT_ARRAY_ELEMENT_TEXT('[111,112,113]', 2);
+---------------------------------+
| json_extract_array_element_text |
+---------------------------------+
| 113 |
+---------------------------------+
```
若要因 JSON 無效而傳回錯誤，請使用下列範例。
```
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,]]]
```
若要將 *null\$1if\$1invalid* 設為 *true*，以便在 JSON 無效時，陳述式傳回 `NULL` 而非傳回錯誤，請使用下列範例。
```
SELECT JSON_EXTRACT_ARRAY_ELEMENT_TEXT('["a",["b",1,["c",2,3,null,]]]',1,true);
+---------------------------------+
| json_extract_array_element_text |
+---------------------------------+
| NULL |
+---------------------------------+
```
請參考下列範例陳述式。如果提供的 JSON 字串或索引為 NULL，無論任何其他參數的值為何，JSON\$1EXTRACT\$1ARRAY\$1ELEMENT\$1TEXT 都會傳回 NULL。
```
--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
```
請參考下列範例陳述式。當 *null\$1if\$1invalid* 為 TRUE 時，JSON\$1EXTRACT\$1ARRAY\$1ELEMENT\$1TEXT 會在 *json\$1string* 為無效 JSON 的情況下傳回 NULL。如果 *null\$1if\$1invalid* 為 FALSE 或未設定，則函式會在 *json\$1string* 無效時傳回錯誤。
```
--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
```
請參考下列範例，其中 *json\$1string* 是有效的 JSON，而 *pos* 參考 JSON `null` 值。在此情況下，無論 *null\$1if\$1invalid* 的值為何，JSON\$1EXTRACT\$1ARRAY\$1ELEMENT\$1TEXT 都會傳回 NULL。
```
--Statement selecting a null value.
SELECT json_extract_array_element_text('[null]', 0);
json_extract_array_element_text
----------------------------------
NULL
```