跳到主要内容

EXPLODE_JSON_ARRAY_INT

描述

explode_json_array_int 表函数,接受一个 JSON 数组,其实现逻辑是将 JSON 数组转换为数组类型然后再调用 explode 函数处理,行为等价于:explode(cast(<json_array> as Array<BIGINT>)) 。需配合 LATERAL VIEW 使用。

语法

EXPLODE_JSON_ARRAY_INT(<json>)

参数

  • <json> JSON 类型,其内容应该是数组。

返回值

  • 返回由 <json> 所有元素组成的单列多行数据,列类型为 Nullable<BIGINT>
  • 如果 <json> 为 NULL 或者为空数组(元素个数为 0),返回 0 行数据。
  • 如果 JSON 数组的元素不是 INT 类型,会尝试将其转换为 INT,无法转换为 INT 类型的被转换为 NULL,关于类型转换的规则请参考 JSON 类型转换

示例

  1. 准备数据
        create table example(
    k1 int
    ) properties(
    "replication_num" = "1"
    );

    insert into example values(1);
  2. 常规参数
    select * from example lateral view explode_json_array_int('[4, 5, 5.23, null]') t2 as c;
    +------+------+
    | k1 | c |
    +------+------+
    | 1 | 4 |
    | 1 | 5 |
    | 1 | 5 |
    | 1 | NULL |
    +------+------+
  3. 非 INT 类型
     select * from example 
    lateral view
    explode_json_array_int('["abc", "123.4", 9223372036854775808.0, 9223372036854775295.999999]') t2 as c;
    +------+---------------------+
    | k1 | c |
    +------+---------------------+
    | 1 | NULL |
    | 1 | 123 |
    | 1 | NULL |
    | 1 | 9223372036854774784 |
    +------+---------------------+

    9223372036854775808.0 超过 BIGINT 的有效范围,所以会被转换为 NULL。 字符串 "123.4" 被转换为 123。 字符串 "abc" 无法转换为 INT,所以得到的是 NULL。

  4. 空数组
    select * from example lateral view explode_json_array_int('[]') t2 as c;
    Empty set (0.03 sec)
  5. NULL 参数
    select * from example lateral view explode_json_array_int(NULL) t2 as c;
    Empty set (0.03 sec)
  6. 非数组参数
    select * from example lateral view explode_json_array_int('{}') t2 as c;
    Empty set (0.03 sec)