大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:JSON_PARSE

· 52CE 我爱测

## 描述 将原始 JSON 字符串解析成 JSON 二进制格式。为了满足不同的异常数据处理需求,提供不同的 JSON_PARSE 系列函数,具体如下: * 解析 JSON 字符串,当输入的字符串不是合法的 JSON 字符串时,报错。 * 解析 JSON 字符串,当输入的字符串不是合法的 JSON 字符串时,返回 NULL。 * 解析 JSON 字符串,当输入的字符串不是合法的 JSON 字符串时,返回参数 default_json_v

描述

将原始 JSON 字符串解析成 JSON 二进制格式。为了满足不同的异常数据处理需求,提供不同的 JSON_PARSE 系列函数,具体如下:

  • JSON_PARSE 解析 JSON 字符串,当输入的字符串不是合法的 JSON 字符串时,报错。
  • JSON_PARSE_ERROR_TO_NULL 解析 JSON 字符串,当输入的字符串不是合法的 JSON 字符串时,返回 NULL。
  • JSON_PARSE_ERROR_TO_VALUE 解析 JSON 字符串,当输入的字符串不是合法的 JSON 字符串时,返回参数 default_json_value 指定的默认值。

语法

JSON_PARSE (<json_str>)
JSON_PARSE_ERROR_TO_NULL (<json_str>)
JSON_PARSE_ERROR_TO_VALUE (<json_str>, <default_json_value>)

参数

必须参数

  • <json_str> String 类型,其内容应是合法的 JSON 字符串。

可选参数

  • <default_json_value> JSON 类型,可以是 NULL,当 <json_str> 解析失败时,<default_json_value> 作为默认值返回。

返回值

Nullable<JSON> 返回解析后得到的 JSON 对象

使用说明

  1. 如果 <json_str> 是 NULL,得到的结果也是 NULL。
  2. JSON_PARSE/JSON_PARSE_ERROR_TO_NULL/JSON_PARSE_ERROR_TO_VALUE 行为基本一致,只是在解析失败时得到的结果不同。

示例

  1. 正常 JSON 字符串解析
    SELECT json_parse('{"k1":"v31","k2":300}');
    
    +-------------------------------------+
    | json_parse('{"k1":"v31","k2":300}') |
    +-------------------------------------+
    | {"k1":"v31","k2":300}               |
    +-------------------------------------+
    
    SELECT json_parse_error_to_null('{"k1":"v31","k2":300}');
    
    +---------------------------------------------------+
    | json_parse_error_to_null('{"k1":"v31","k2":300}') |
    +---------------------------------------------------+
    | {"k1":"v31","k2":300}                             |
    +---------------------------------------------------+
    
    SELECT json_parse_error_to_value('{"k1":"v31","k2":300}','{}');
    
    +---------------------------------------------------------+
    | json_parse_error_to_value('{"k1":"v31","k2":300}','{}') |
    +---------------------------------------------------------+
    | {"k1":"v31","k2":300}                                   |
    +---------------------------------------------------------+
    
    SELECT json_parse_error_to_value('{"k1":"v31","k2":300}', NULL);
    
    +----------------------------------------------------------+
    | json_parse_error_to_value('{"k1":"v31","k2":300}', NULL) |
    +----------------------------------------------------------+
    | {"k1":"v31","k2":300}                                    |
    +----------------------------------------------------------+
    
  2. 非法 JSON 字符串解析
    SELECT json_parse('invalid json');
    
    ERROR 1105 (HY000): errCode = 2, detailMessage = [INVALID_ARGUMENT]Parse json document failed at row 0, error: [INTERNAL_ERROR]simdjson parse exception:
    
    SELECT json_parse_error_to_null('invalid json');
    
    +------------------------------------------+
    | json_parse_error_to_null('invalid json') |
    +------------------------------------------+
    | NULL                                     |
    +------------------------------------------+
    
    SELECT json_parse_error_to_value('invalid json');
    
    +-------------------------------------------+
    | json_parse_error_to_value('invalid json') |
    +-------------------------------------------+
    | {}                                        |
    +-------------------------------------------+
    
    SELECT json_parse_error_to_value('invalid json', '{"key": "default value"}');
    
    +-----------------------------------------------------------------------+
    | json_parse_error_to_value('invalid json', '{"key": "default value"}') |
    +-----------------------------------------------------------------------+
    | {"key":"default value"}                                               |
    +-----------------------------------------------------------------------+
    
    SELECT json_parse_error_to_value('invalid json', NULL);
    
    +-------------------------------------------------+
    | json_parse_error_to_value('invalid json', NULL) |
    +-------------------------------------------------+
    | NULL                                            |
    +-------------------------------------------------+
    
  3. NULL 参数
    SELECT json_parse(NULL);
    
    +------------------+
    | json_parse(NULL) |
    +------------------+
    | NULL             |
    +------------------+
    
    SELECT json_parse_error_to_null(NULL);
    
    +--------------------------------+
    | json_parse_error_to_null(NULL) |
    +--------------------------------+
    | NULL                           |
    +--------------------------------+
    
    SELECT json_parse_error_to_value(NULL, '{}');
    
    +---------------------------------------+
    | json_parse_error_to_value(NULL, '{}') |
    +---------------------------------------+
    | NULL                                  |
    +---------------------------------------+
    

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。