JSON_EXTRACT_LARGEINT

描述

JSON_EXTRACT_LARGEINT 从 JSON 对象中提取 <json_path> 指定的字段，并将其转换为 LARGEINT 类型。

语法

JSON_EXTRACT_LARGEINT(<json_object>, <json_path>)

参数

• <json_object> JSON 类型，要提取的目标参数。
• <json_path> String 类型，要从目标 JSON 中提取目标元素的 JSON 路径。

返回值

Nullable(LARGEINT) 返回提取出的 LARGEINT 值，某些情况会得到 NULL

使用说明

1. 如果 <json_object> 或则 <json_path> 为 NULL，返回 NULL。
2. 如果 <json_path> 指定的元素不存在返回 NULL。
3. 如果 <json_path> 指定的元素无法转换为 LARGEINT 返回 NULL。
4. 其行为与 "cast + json_extract" 一致，即等价于：

   CAST(JSON_EXTRACT(<json_object>, <json_path>) as LARGEINT)

示例

1. 正常参数

   SELECT json_extract_largeint('{"id": 11529215046068469760, "name": "doris"}', '$.id');

   +--------------------------------------------------------------------------------+
   | json_extract_largeint('{"id": 11529215046068469760, "name": "doris"}', '$.id') |
   +--------------------------------------------------------------------------------+
   | 11529215046068469760                                                           |
   +--------------------------------------------------------------------------------+
2. 路径不存在的情况

   SELECT json_extract_largeint('{"id": 11529215046068469760, "name": "doris"}', '$.id2');

   +---------------------------------------------------------------------------------+
   | json_extract_largeint('{"id": 11529215046068469760, "name": "doris"}', '$.id2') |
   +---------------------------------------------------------------------------------+
   | NULL                                                                            |
   +---------------------------------------------------------------------------------+
3. NULL 参数

   SELECT json_extract_largeint('{"id": 11529215046068469760, "name": "doris"}', NULl);

   +------------------------------------------------------------------------------+
   | json_extract_largeint('{"id": 11529215046068469760, "name": "doris"}', NULl) |
   +------------------------------------------------------------------------------+
   | NULL                                                                         |
   +------------------------------------------------------------------------------+

   SELECT json_extract_largeint(NULL, '$.id2');

   +--------------------------------------+
   | json_extract_largeint(NULL, '$.id2') |
   +--------------------------------------+
   | NULL                                 |
   +--------------------------------------+
4. 无法转换为 LARGEINT 的情况

   SELECT json_extract_largeint('{"id": 123, "name": "doris"}','$.name');

   +----------------------------------------------------------------+
   | json_extract_largeint('{"id": 123, "name": "doris"}','$.name') |
   +----------------------------------------------------------------+
   | NULL                                                           |
   +----------------------------------------------------------------+