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

JSON_EXTRACT_ARRAY_ELEMENT_TEXT 함수

참고

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

JSON_EXTRACT_ARRAY_ELEMENT_TEXT를 사용하는 대신 JSON_PARSE 함수를 사용해 JSON 문자열을 구문 분석하여 SUPER 값을 얻는 것이 좋습니다. 그런 다음 value[element position] 구문으로 배열 인덱스를 사용하여 원하는 요소를 쿼리합니다. SUPER 값의 배열 요소를 쿼리하는 방법에 대한 자세한 내용은 비정형 데이터 쿼리 섹션을 참조하세요.

JSON_EXTRACT_ARRAY_ELEMENT_TEXT 함수는 0부터 시작되는 인덱스를 사용하여 가장 바깥쪽 JSON 문자열 배열의 JSON 배열 요소를 반환합니다. 배열의 첫 번째 요소는 0 위치에 자리합니다. 인덱스가 음의 값이거나 경계를 벗어나면 JSON_EXTRACT_ARRAY_ELEMENT_TEXT 함수가 빈 문자열을 반환합니다. null_if_invalid 인수가 true로 설정되어 있는데 JSON 문자열이 잘못된 경우, 이 함수는 오류 대신 NULL을 반환합니다.

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

구문

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

인수

json_string

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

pos

반환할 배열 요소의 인덱스를 0부터 시작되는 배열 인덱스를 사용하여 나타내는 INTEGER입니다.

null_if_invalid

(선택) 입력 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_if_invalid를 true로 설정해 문이 잘못된 JSON에 대해 오류가 아니라 NULL을 반환하도록 합니다.

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