跳到主要内容

json_parse_notnull_error_to_value

描述

函数用于解析 JSON 字符串。如果 JSON 字符串格式无效或发生解析错误,函数会返回用户指定的默认值,而不是返回无效的 JSON 对象。该函数的主要作用是提供一个默认值,用于替代解析错误时的无效结果,确保查询返回合理的值。

语法

JSON_PARSE_NOTNULL_ERROR_TO_VALUE(< str >, <default_value>)

别名

  • JSONB_PARSE_NOTNULL_ERROR_TO_VALUE

必选参数

参数描述
<str>需要解析的 JSON 字符串。该参数应为一个有效的 JSON 字符串。如果 JSON 格式无效,函数会返回 default_value。
<default_value>解析错误时返回的默认值。该参数可以是任意类型,用于替代无效的 JSON 格式数据。

返回值

返回一个 JSON 对象。如果输入的 JSON 字符串有效,返回解析后的 JSON 对象;如果无效,返回用户指定的 default_value。

示例

SELECT JSON_PARSE_NOTNULL_ERROR_TO_VALUE('{"name": "Alice", "age": 30}', '{"name": "Unknown", "age": 0}') AS parsed_json;

+-------------------------------------------+
| parsed_json |
+-------------------------------------------+
| {"name":"Alice","age":30} |
+-------------------------------------------+