14.17.2 Functions That Create JSON Values

14.17.2 Functions That Create JSON Values

이 섹션에 나열된 함수들은 구성 요소 요소들로부터 JSON 값을 생성합니다.

• JSON_ARRAY([val[, val] ...])

값들의 (비어 있을 수도 있는) 목록을 평가하고, 해당 값들을 포함하는 JSON 배열을 반환합니다.

1mysql> SELECT JSON_ARRAY(1, "abc", NULL, TRUE, CURTIME());
2+---------------------------------------------+
3| JSON_ARRAY(1, "abc", NULL, TRUE, CURTIME()) |
4+---------------------------------------------+
5| [1, "abc", null, true, "11:30:24.000000"]   |
6+---------------------------------------------+

• JSON_DUALITY_OBJECT([table_annotations] json_duality_key_value_pairs)

이 함수는 CREATE JSON DUALITY VIEW 또는 ALTER JSON DUALITY VIEW에서 사용하기 위한 JSON 듀얼리티 오브젝트를 반환합니다. 그 밖의 다른 어떤 컨텍스트에서 호출을 시도하면 에러가 발생합니다.

자세한 예시는 Section 27.7, “JSON Duality Views”와 CREATE JSON DUALITY VIEW 및 ALTER JSON DUALITY VIEW 스테이트먼트 설명을 참조하십시오.

• JSON_OBJECT([key, val[, key, val] ...])

키-값 쌍들의 (비어 있을 수도 있는) 목록을 평가하고, 해당 쌍들을 포함하는 JSON 오브젝트를 반환합니다. 어떤 키 이름이라도 NULL이면 에러가 발생하며, argument 개수가 홀수여도 에러가 발생합니다.

1mysql> SELECT JSON_OBJECT('id', 87, 'name', 'carrot');
2+-----------------------------------------+
3| JSON_OBJECT('id', 87, 'name', 'carrot') |
4+-----------------------------------------+
5| {"id": 87, "name": "carrot"}            |
6+-----------------------------------------+

• JSON_QUOTE(string)

문자열을 양쪽에 더블 쿼트 문자를 붙이고, 내부의 쿼트 및 기타 문자들을 이스케이프하여 JSON 값으로서 quoting한 다음, 그 결과를 utf8mb4 문자열로 반환합니다. argument가 NULL이면 NULL을 반환합니다.

이 함수는 일반적으로 JSON 도큐먼트 안에 포함할 수 있는 유효한 JSON 문자열 리터럴을 생성하는 데 사용됩니다.

특정 특수 문자는 Table 14.23, “JSON_UNQUOTE() Special Character Escape Sequences”에 나와 있는 이스케이프 시퀀스에 따라 백슬래시로 이스케이프됩니다.

1mysql> SELECT JSON_QUOTE('null'), JSON_QUOTE('"null"');
2+--------------------+----------------------+
3| JSON_QUOTE('null') | JSON_QUOTE('"null"') |
4+--------------------+----------------------+
5| "null"             | "\"null\""           |
6+--------------------+----------------------+
7mysql> SELECT JSON_QUOTE('[1, 2, 3]');
8+-------------------------+
9| JSON_QUOTE('[1, 2, 3]') |
10+-------------------------+
11| "[1, 2, 3]"             |
12+-------------------------+

또한 다른 타입의 값을 CAST(value AS JSON)를 사용하여 JSON 타입으로 캐스팅함으로써 JSON 값을 얻을 수 있습니다. 자세한 내용은 Converting between JSON and non-JSON values를 참조하십시오.

JSON 값을 생성하는 집계 함수 두 개를 사용할 수 있습니다. JSON_ARRAYAGG()는 결과 집합을 하나의 JSON 배열로 반환하고, JSON_OBJECTAGG()는 결과 집합을 하나의 JSON 오브젝트로 반환합니다. 자세한 내용은 Section 14.19, “Aggregate Functions”을 참조하십시오.