Amazon Redshift는 패치 198부터 새 Python UDF 생성을 더 이상 지원하지 않습니다. 기존 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\$1EXTRACT\$1ARRAY\$1ELEMENT\$1TEXT를 사용하는 대신 [JSON\$1PARSE 함수](JSON_PARSE.md)를 사용해 JSON 문자열을 구문 분석하여 SUPER 값을 얻는 것이 좋습니다. 그런 다음 `value[element position]` 구문으로 배열 인덱스를 사용하여 원하는 요소를 쿼리합니다. SUPER 값의 배열 요소를 쿼리하는 방법에 대한 자세한 내용은 [반정형 데이터 쿼리](query-super.md) 섹션을 참조하세요.
JSON\$1EXTRACT\$1ARRAY\$1ELEMENT\$1TEXT 함수는 0부터 시작되는 인덱스를 사용하여 가장 바깥쪽 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*
반환할 배열 요소의 인덱스를 0부터 시작되는 배열 인덱스를 사용하여 나타내는 `INTEGER`입니다.
*null\$1if\$1invalid*
(선택) 입력 JSON 문자열이 잘못된 경우 오류 대신 `NULL`을 반환할지 여부를 지정하는 `BOOLEAN` 값입니다. JSON이 잘못되었을 때 `NULL`을 반환하게 하려면 `true`(`t`)를 지정합니다. JSON이 잘못되었을 때 오류를 반환하게 하려면 `false`(`f`)를 지정합니다. 기본값은 `false`입니다.
## 반환 타입
`VARCHAR`
**pos에서 참조한 JSON 배열 요소를 나타내는 `VARCHAR` 문자열입니다.
## 예제
0부터 시작하는 배열 인덱스의 세 번째 요소인 위치 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\$1string*이 유효하지 않은 JSON이면 JSON\$1EXTRACT\$1ARRAY\$1ELEMENT\$1TEXT가 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` 값을 참조하는 다음 예제를 살펴보세요. 이 경우 JSON\$1EXTRACT\$1ARRAY\$1ELEMENT\$1TEXT는 *null\$1if\$1invalid* 값에 관계없이 NULL을 반환합니다.
```
--Statement selecting a null value.
SELECT json_extract_array_element_text('[null]', 0);
json_extract_array_element_text
----------------------------------
NULL
```