JSON_ARRAY_LENGTH 함수 - Amazon Redshift
구문인수반환 타입예시

JSON_ARRAY_LENGTH 함수

참고

JSON_PARSE 및 관련 함수는 JSON 값을 SUPER로 구문 분석하는데, Amazon Redshift는 VARCHAR보다 더 효율적으로 구문 분석합니다.

JSON_ARRAY_LENGTH를 사용하는 대신 JSON_PARSE 함수를 사용해 JSON 문자열을 구문 분석하여 SUPER 값을 얻는 것이 좋습니다. 그런 다음 get_array_length 함수를 사용하여 배열의 길이를 구합니다.

JSON_ARRAY_LENGTH 함수는 JSON 문자열의 바깥쪽 배열에 속한 요소 수를 반환합니다. null_if_invalid 인수가 true로 설정되어 있는데 JSON 문자열이 잘못된 경우, 이 함수는 오류 대신 NULL을 반환합니다.

자세한 내용은 JSON 함수 단원을 참조하십시오.

구문

JSON_ARRAY_LENGTH('json_array' [, null_if_invalid ] )

인수

json_array

올바른 형식의 JSON 배열입니다.

null_if_invalid

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

반환 타입

INTEGER

예시

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

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_if_invalid를 true로 설정하려면 다음 예제를 사용합니다.

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

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