本文介绍AnalyticDB MySQL版集群支持的JSON函数。

JSON _ARRAY_CONTAINS

json_array_contains(json, value)
  • 命令说明:判断JSON数组中是否包含value指定的值。
  • 输入值类型:value可以是数值、字符串类型或BOOLEAN类型。
  • 返回值类型:BOOLEAN。
  • 示例:
    SELECT json_array_contains('[1, 2, 3]', 2);
    返回结果如下:
    +-------------------------------------+
    | json_array_contains('[1, 2, 3]', 2) |
    +-------------------------------------+
    |                                   1 |
    +-------------------------------------+

JSON_ARRAY_LENGTH

json_array_length(json)
  • 命令说明:返回JSON数组的长度。
  • 输入值类型:字符串类型或JSON类型。
  • 返回值类型:BIGINT。
  • 示例:
    SELECT json_array_length('[1, 2, 3]');
    返回结果如下:
    +--------------------------------+
    | json_array_length('[1, 2, 3]') |
    +--------------------------------+
    |                              3 |
    +--------------------------------+

JSON _EXTRACT

json_extract(json, jsonpath)
  • 命令说明:从JSON中返回jsonpath指定的值。
  • 输入值类型:字符串类型或JSON类型。
  • 返回值类型:JSON。
  • 示例:
    SELECT json_extract('[10, 20, [30, 40]]', '$.1');
    返回结果如下:
    +-------------------------------------------+
    | json_extract('[10, 20, [30, 40]]', '$.1') |
    +-------------------------------------------+
    | 20                                        |
    +-------------------------------------------+

JSON_SIZE

json_size(json, jsonpath)
  • 命令说明:从JSON中返回jsonpath指定JSON对象或JSON数组的大小。
    说明jsonpath指向的不是JSON对象或者JSON数组时,返回0。
  • 输入值类型:字符串类型或JSON类型。
  • 返回值类型:BIGINT。
  • 示例:
    • jsonpath指向的是JSON对象,语句如下:
      SELECT json_size('{"x":{"a":1, "b": 2}}', '$.x') as result;
      返回结果如下:
      +--------+
      | result |
      +--------+
      |      2 |
      +--------+
    • jsonpath指向的不是JSON对象或者JSON数组,语句如下:
      SELECT json_size('{"x": {"a": 1, "b": 2}}', '$.x.a') as result;
      返回结果如下:
      +--------+
      | result |
      +--------+
      |      0 |
      +--------+

JSON_KEYS

json_keys(json, jsonpath)
json_keys(json)
  • 命令说明
    • 若指定了jsonpath,表示获取JSON在指定路径下的所有键。
    • 若未指定jsonpath,表示获取根路径(即jsonpath='$')下的所有键。
  • 输入值类型:仅支持输入JSON类型的参数。
    您可以通过如下方式构造JSON数据:
    • 直接使用JSON数据。例如json '{"a": 1, "b": {"c": 30}}'
    • 通过CAST函数将字符串进行显式转换为JSON数据。例如CAST('{"a": 1, "b": {"c": 30}}' AS json)
  • 返回值类型:JSON ARRAY。
  • 示例:
    • 返回$.b路径下的所有键,语句如下:
      SELECT json_keys(CAST('{"a": 1, "b": {"c": 30}}' AS json),'$.b');
      返回结果如下:
      +-----------------------------------------------------------+
      | json_keys(CAST('{"a": 1, "b": {"c": 30}}' AS json),'$.b') |
      +-----------------------------------------------------------+
      | ["c"]                                                     |
      +-----------------------------------------------------------+
    • 返回根路径下的所有键,语句如下:
      SELECT JSON_KEYS(json '{"a": 1, "b": {"c": 30}}');
      返回结果如下:
      +--------------------------------------------+
      | JSON_KEYS(json '{"a": 1, "b": {"c": 30}}') |
      +--------------------------------------------+
      | ["a","b"]                                  |
      +--------------------------------------------+