JSON_EXTRACT_ARRAY_ELEMENT_TEXT 함수

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부터 시작되는 배열 인덱스를 사용하여 나타내는 정수입니다.

null_if_invalid

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

반환 유형

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);
 
An error occurred when executing the SQL command:
select json_extract_array_element_text('["a",["b",1,["c",2,3,null,]]]',1)

다음 예에서는 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
-------------------------------