JSON_EACH_TEXT_OUTER

설명

json_each_text_outer 테이블 함수는 최상위 JSON 객체를 키/값 쌍의 집합으로 펼칩니다. 각 행에는 하나의 키(key)와 그에 해당하는 값(value)이 포함됩니다. json_each_outer와 달리 value 열의 타입은 TEXT이므로 문자열 값은 JSON 따옴표 없이 반환됩니다.

json_each_text와 달리 입력이 NULL이거나 빈 객체인 경우 json_each_text_outer는 0행 대신 NULL, NULL로 구성된 한 행을 반환합니다.

LATERAL VIEW와 함께 사용해야 합니다.

구문

JSON_EACH_TEXT_OUTER(<json_str>)

매개변수

매개변수	설명
<json_str>	펼칠 JSON 문자열입니다. 내용은 JSON 객체여야 합니다.

반환 값

여러 열과 여러 행으로 구성된 데이터를 반환합니다. 각 행은 JSON 객체의 키-값 쌍 하나에 해당합니다:

열	타입	설명
key	TEXT	JSON 객체의 키 이름
value	TEXT	일반 텍스트로 표현한 해당 값(문자열 값에는 따옴표가 없음, 예: foo)

특수한 경우:

• <json_str>이 NULL이면 NULL, NULL로 구성된 1행을 반환합니다.
• <json_str>이 빈 객체({})이면 NULL, NULL로 구성된 1행을 반환합니다.
• JSON null 값은 SQL NULL로 반환됩니다.

예제

기본 사용법: 문자열 값이 있는 JSON 객체 펼치기

SELECT k, v
FROM (SELECT 1) dummy
LATERAL VIEW json_each_text_outer('{"a":"foo","b":"bar"}') t AS k, v;

+---+-----+
| k | v   |
+---+-----+
| a | foo |
| b | bar |
+---+-----+

value 열은 TEXT 타입이므로 문자열 값에는 JSON 따옴표가 없습니다(json_each_outer와 다름).

NULL 매개변수: NULL로 구성된 1행 반환

SELECT k, v
FROM (SELECT 1) dummy
LATERAL VIEW json_each_text_outer(NULL) t AS k, v;

+------+------+
| k    | v    |
+------+------+
| NULL | NULL |
+------+------+

빈 객체: NULL로 구성된 1행 반환

SELECT k, v
FROM (SELECT 1) dummy
LATERAL VIEW json_each_text_outer('{}') t AS k, v;

+------+------+
| k    | v    |
+------+------+
| NULL | NULL |
+------+------+