Important
You are viewing the archived documentation of TiDB, which no longer receives updates. It is recommended that you use
the latest LTS version of the TiDB database.
JSON Functions TiDB supports most of the JSON functions available in MySQL 8.0.
Functions that create JSON values Functions that search JSON values Function Name Description JSON_CONTAINS(target, candidate[, path]) Indicates by returning 1 or 0 whether a given candidate JSON document is contained within a target JSON document JSON_CONTAINS_PATH(json_doc, one_or_all, path[, path] ...) Returns 0 or 1 to indicate whether a JSON document contains data at a given path or paths JSON_EXTRACT(json_doc, path[, path] ...) Returns data from a JSON document, selected from the parts of the document matched by the path
arguments -> Returns the value from a JSON column after the evaluating path; an alias for JSON_EXTRACT(doc, path_literal)
->> Returns the value from a JSON column after the evaluating path and unquoting the result; an alias for JSON_UNQUOTE(JSON_EXTRACT(doc, path_literal))
JSON_KEYS(json_doc[, path]) Returns the keys from the top-level value of a JSON object as a JSON array, or, if a path argument is given, the top-level keys from the selected path JSON_SEARCH(json_doc, one_or_all, search_str[, escape_char[, path] ...]) Search a JSON document for one or all matches of a string value MEMBER OF(json_array) If the passed value is an element of the JSON array, returns 1. Otherwise, returns 0. JSON_OVERLAPS(json_doc1, json_doc2) Indicates whether two JSON documents have overlapping part. If yes, returns 1. If not, returns 0.
Functions that modify JSON values Function Name Description JSON_APPEND(json_doc, path, value) An alias to JSON_ARRAY_APPEND
JSON_ARRAY_APPEND(json_doc, path, val[, path, val] ...) Appends values to the end of the indicated arrays within a JSON document and returns the result JSON_ARRAY_INSERT(json_doc, path, val[, path, val] ...) Insert values into the specified locations of a JSON document and returns the result JSON_INSERT(json_doc, path, val[, path, val] ...) Inserts data into a JSON document and returns the result JSON_MERGE_PATCH(json_doc, json_doc[, json_doc] ...) Merge JSON documents JSON_MERGE_PRESERVE(json_doc, json_doc[, json_doc] ...) Merges two or more JSON documents and returns the merged result JSON_MERGE(json_doc, json_doc[, json_doc] ...) A deprecated alias for JSON_MERGE_PRESERVE
JSON_REMOVE(json_doc, path[, path] ...) Removes data from a JSON document and returns the result JSON_REPLACE(json_doc, path, val[, path, val] ...) Replaces existing values in a JSON document and returns the result JSON_SET(json_doc, path, val[, path, val] ...) Inserts or updates data in a JSON document and returns the result JSON_UNQUOTE(json_val) Unquotes a JSON value and returns the result as a string
Functions that return JSON value attributes Utility functions Function Name Description JSON_PRETTY(json_doc) Pretty formatting of a JSON document JSON_STORAGE_FREE(json_doc) Returns how much storage space was freed in the binary representation of the JSON value after it was updated in place. As TiDB has different storage architecture from MySQL, this function always returns 0 for a valid JSON value, and it is implemented for compatibility with MySQL 8.0. JSON_STORAGE_SIZE(json_doc) Returns an approximate size of bytes required to store the json value. As the size does not account for TiKV using compression, the output of this function is not strictly compatible with MySQL.
Aggregate functions See also Unsupported functions JSON_SCHEMA_VALID()
JSON_SCHEMA_VALIDATION_REPORT()
JSON_TABLE()
JSON_VALUE()
For more information, see #14486 .