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\$1ARRAY\$1LENGTH 함수
<a name="JSON_ARRAY_LENGTH"></a>

**참고**  
JSON\$1PARSE 및 관련 함수는 JSON 값을 SUPER로 구문 분석하는데, Amazon Redshift는 VARCHAR보다 더 효율적으로 구문 분석합니다.  
 JSON\$1ARRAY\$1LENGTH를 사용하는 대신 [JSON\$1PARSE 함수](JSON_PARSE.md)를 사용해 JSON 문자열을 구문 분석하여 SUPER 값을 얻는 것이 좋습니다. 그런 다음 [GET\$1ARRAY\$1LENGTH 함수](get_array_length.md)를 사용하여 배열의 길이를 구합니다.

JSON\$1ARRAY\$1LENGTH 함수는 JSON 문자열의 바깥쪽 배열에 속한 요소 수를 반환합니다. **null\$1if\$1invalid 인수가 `true`로 설정되어 있는데 JSON 문자열이 잘못된 경우, 이 함수는 오류 대신 `NULL`을 반환합니다.

자세한 내용은 [JSON 함수](json-functions.md) 섹션을 참조하세요.

## 구문
<a name="JSON_ARRAY_LENGTH-synopsis"></a>

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

## 인수
<a name="JSON_ARRAY_LENGTH-arguments"></a>

 *json\$1array*  
올바른 형식의 JSON 배열입니다.

 *null\$1if\$1invalid*  
(선택) 입력 JSON 문자열이 잘못된 경우 오류 대신 `NULL`을 반환할지 여부를 지정하는 `BOOLEAN` 값입니다. JSON이 잘못되었을 때 `NULL`을 반환하게 하려면 `true`(`t`)를 지정합니다. JSON이 잘못되었을 때 오류를 반환하게 하려면 `false`(`f`)를 지정합니다. 기본값은 `false`입니다.

## 반환 타입
<a name="JSON_ARRAY_LENGTH-return"></a>

`INTEGER`

## 예제
<a name="JSON_ARRAY_LENGTH-examples"></a>

배열의 요소 수를 반환하려면 다음 예제를 사용합니다.

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

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

JSON이 유효하지 않아 오류를 반환하려면 다음 예제를 사용합니다.

```
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
```

잘못된 JSON에 대해 오류를 반환하는 대신 `NULL`을 반환하도록 **null\$1if\$1invalid를 **true로 설정하려면 다음 예제를 사용합니다.

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

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