데브러너 (DevRunner)

14.17.1 JSON Function Reference

Table 14.22 JSON Functions

Name	Description	Deprecated
`->`	path를 평가한 후 JSON 컬럼으로부터 값을 반환합니다. JSON_EXTRACT()와 동일합니다.
`->>`	path를 평가한 후 JSON 컬럼으로부터 값을 반환하고 결과의 따옴표를 제거합니다. JSON_UNQUOTE(JSON_EXTRACT())와 동일합니다.
`JSON_ARRAY()`	JSON 배열을 생성합니다.
`JSON_ARRAY_APPEND()`	JSON 문서에 데이터를 추가합니다.
`JSON_ARRAY_INSERT()`	JSON 배열에 삽입합니다.
`JSON_CONTAINS()`	JSON 문서가 path 위치에 특정 객체를 포함하는지 여부를 나타냅니다.
`JSON_CONTAINS_PATH()`	JSON 문서가 path 위치에 어떤 데이터든 포함하는지 여부를 나타냅니다.
`JSON_DEPTH()`	JSON 문서의 최대 깊이를 반환합니다.
`JSON_DUALITY_OBJECT()`	JSON 듀얼리티 객체를 생성합니다.
`JSON_EXTRACT()`	JSON 문서로부터 데이터를 반환합니다.
`JSON_INSERT()`	JSON 문서에 데이터를 삽입합니다.
`JSON_KEYS()`	JSON 문서로부터 키들의 배열을 반환합니다.
`JSON_LENGTH()`	JSON 문서에 있는 요소의 개수를 반환합니다.
`JSON_MERGE()`	JSON 문서들을 병합하며 중복 키를 유지합니다. JSON_MERGE_PRESERVE()의 폐기 예정 동의어입니다.	Yes
`JSON_MERGE_PATCH()`	JSON 문서들을 병합하며 중복 키의 값을 교체합니다.
`JSON_MERGE_PRESERVE()`	JSON 문서들을 병합하며 중복 키를 유지합니다.
`JSON_OBJECT()`	JSON 객체를 생성합니다.
`JSON_OVERLAPS()`	두 JSON 문서를 비교하여, 이들이 어떤 키-값 쌍이나 배열 요소라도 공통으로 가지면 TRUE (1)을, 그렇지 않으면 FALSE (0)을 반환합니다.
`JSON_PRETTY()`	JSON 문서를 사람이 읽기 쉬운 형식으로 출력합니다.
`JSON_QUOTE()`	JSON 문서를 따옴표 처리합니다.
`JSON_REMOVE()`	JSON 문서에서 데이터를 제거합니다.
`JSON_REPLACE()`	JSON 문서 내의 값을 교체합니다.
`JSON_SCHEMA_VALID()`	JSON 문서를 JSON 스키마에 대해 검증합니다. 문서가 스키마에 대해 검증을 통과하면 TRUE/1을, 통과하지 못하면 FALSE/0을 반환합니다.
`JSON_SCHEMA_VALIDATION_REPORT()`	JSON 문서를 JSON 스키마에 대해 검증합니다. 검증 결과에 대해, 성공 또는 실패 여부와 실패 이유를 포함하는 보고서를 JSON 형식으로 반환합니다.
`JSON_SEARCH()`	JSON 문서 내의 값에 대한 path를 반환합니다.
`JSON_SET()`	JSON 문서에 데이터를 삽입합니다.
`JSON_STORAGE_FREE()`	부분 업데이트 이후 JSON 컬럼 값의 바이너리 표현 내에서 해제된 공간을 반환합니다.
`JSON_STORAGE_SIZE()`	JSON 문서의 바이너리 표현 저장에 사용되는 공간을 반환합니다.
`JSON_TABLE()`	JSON 표현식으로부터 데이터를 관계형 테이블로 반환합니다.
`JSON_TYPE()`	JSON 값의 타입을 반환합니다.
`JSON_UNQUOTE()`	JSON 값의 따옴표를 제거합니다.
`JSON_VALID()`	JSON 값이 유효한지 여부를 나타냅니다.
`JSON_VALUE()`	제공된 path가 가리키는 위치에서 JSON 문서로부터 값을 추출합니다. 이 값을 VARCHAR(512) 또는 지정된 타입으로 반환합니다.
`MEMBER OF()`	첫 번째 피연산자가 두 번째 피연산자로 전달된 JSON 배열의 어떤 요소와도 일치하면 true (1)을 반환하고, 그렇지 않으면 false (0)을 반환합니다.

Name	Description	Deprecated

MySQL은 두 개의 집계 JSON 함수인 JSON_ARRAYAGG()와 JSON_OBJECTAGG()를 지원합니다. 이에 대한 설명은 Section 14.19, “Aggregate Functions”을 참조하십시오.

MySQL은 또한 JSON_PRETTY() 함수를 사용하여, JSON 값을 사람이 읽기 쉬운 형식으로 “pretty-printing”하는 기능을 지원합니다. 주어진 JSON 값이 얼마나 많은 스토리지 공간을 차지하는지, 그리고 추가 스토리지를 위해 얼마나 많은 공간이 남아 있는지를 JSON_STORAGE_SIZE()와 JSON_STORAGE_FREE()를 각각 사용하여 확인할 수 있습니다. 이들 함수에 대한 전체 설명은 Section 14.17.8, “JSON Utility Functions”을 참조하십시오.