jsonb_parse

description

Syntax

JSONB jsonb_parse(VARCHAR json_str) JSONB jsonb_parse_error_to_null(VARCHAR json_str) JSONB jsonb_parse_error_to_value(VARCHAR json_str, VARCHAR default_json_str)

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

  • json_str为NULL时,都返回NULL
  • json_str为非法JSON字符串时
    • jsonb_parse报错
    • jsonb_parse_error_to_null返回NULL,
    • jsonb_parse_error_to_value返回参数default_json_str指定的默认值

example

  1. 正常JSON字符串解析
  1. mysql> SELECT jsonb_parse('{"k1":"v31","k2":300}');
  2. +--------------------------------------+
  3. | jsonb_parse('{"k1":"v31","k2":300}') |
  4. +--------------------------------------+
  5. | {"k1":"v31","k2":300} |
  6. +--------------------------------------+
  7. 1 row in set (0.01 sec)
  1. 非法JSON字符串解析
  1. mysql> SELECT jsonb_parse('invalid json');
  2. ERROR 1105 (HY000): errCode = 2, detailMessage = json parse error: Invalid document: document must be an object or an array for value: invalid json
  3. mysql> SELECT jsonb_parse_error_to_null('invalid json');
  4. +-------------------------------------------+
  5. | jsonb_parse_error_to_null('invalid json') |
  6. +-------------------------------------------+
  7. | NULL |
  8. +-------------------------------------------+
  9. 1 row in set (0.01 sec)
  10. mysql> SELECT jsonb_parse_error_to_value('invalid json', '{}');
  11. +--------------------------------------------------+
  12. | jsonb_parse_error_to_value('invalid json', '{}') |
  13. +--------------------------------------------------+
  14. | {} |
  15. +--------------------------------------------------+
  16. 1 row in set (0.00 sec)

keywords

JSONB, JSON, jsonb_parse, jsonb_parse_error_to_null, jsonb_parse_error_to_value