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