SelectDB Enterprise
参考手册
SQL 函数
标量函数
JSON 函数
JSON_PARSE_NOTNULL_ERROR_TO_VALUE

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}                |
+-------------------------------------------+
 
© 2025 北京飞轮数据科技有限公司 京ICP备2022004029号 | Apache、Apache Doris 以及相关开源项目名称均为 Apache 基金会商标