JSON_PARSE_NULLABLE_ERROR_TO_VALUE
更新时间：2025-10-16
描述
JSON_PARSE_NULLABLE_ERROR_TO_VALUE 函数用于解析一个 JSON 字符串为有效的 JSON 对象。如果输入的 JSON 字符串无效，它将返回用户指定的默认值，而不是抛出错误。如果输入为 NULL，则返回默认值。
语法
SQL
1JSON_PARSE_NULLABLE_ERROR_TO_VALUE( <str> , <default_value>)别名
- JSONB_PARSE_NULLABLE_ERROR_TO_VALUE
必选参数
| 参数 | 描述 |
|---|---|
<str> |
需要解析的 JSON 格式的输入字符串。 |
<default_value> |
解析失败时返回的默认值。 |
返回值
如果输入字符串是有效的 JSON，返回对应的 JSON 对象。 如果输入字符串无效或为 NULL，返回 default_value 参数指定的默认值。
举例
- 有效的 JSON 字符串：
SQL
1SELECT JSON_PARSE_NULLABLE_ERROR_TO_VALUE('{"name": "John", "age": 30}', 'default');
SQL
1+---------------------------------------------------------------+
2| JSON_PARSE_NULLABLE_ERROR_TO_VALUE('{"name": "John", "age": 30}', 'default') |
3+---------------------------------------------------------------+
4| {"name": "John", "age": 30} |
5+---------------------------------------------------------------+- 无效的 JSON 字符串：
SQL
1SELECT JSON_PARSE_NULLABLE_ERROR_TO_VALUE('{"name": "John", "age": }', 'default');
SQL
1+---------------------------------------------------------------+
2| JSON_PARSE_NULLABLE_ERROR_TO_VALUE('{"name": "John", "age": }', 'default') |
3+---------------------------------------------------------------+
4| default |
5+---------------------------------------------------------------+- 输入为 NULL：
SQL
1SELECT JSON_PARSE_NULLABLE_ERROR_TO_VALUE(NULL, 'default');
SQL
1+---------------------------------------------------------------+
2| JSON_PARSE_NULLABLE_ERROR_TO_VALUE(NULL, 'default') |
3+---------------------------------------------------------------+
4| default |
5+---------------------------------------------------------------+