JQ

引入或更新于：v1.2.622

JQ 函数是一个返回集合的 SQL 函数，允许你将 jq 过滤器应用于存储在 Variant（Variant）列中的 JSON 数据。通过此函数，你可以应用指定的 jq 过滤器来处理 JSON 数据，并将结果作为行集返回。

语法

JQ (<jq_expression>, <json_data>)

参数	描述
jq_expression	一个 jq 过滤器表达式，定义了如何使用 jq 语法处理和转换 JSON 数据。此表达式可以指定如何选择、修改和操作 JSON 对象及数组中的数据。有关 jq 支持的语法、过滤器和函数的更多信息，请参阅 jq 手册。
json_data	你希望使用 jq 过滤器表达式处理或转换的 JSON 格式输入。它可以是 JSON 对象、数组或任何有效的 JSON 数据结构。

返回类型

JQ 函数返回一个 JSON 值集合，其中每个值对应于基于 <jq_expression> 转换或提取结果的一个元素。

示例

首先，我们创建一张名为 customer_data 的表，包含 id 和 profile 列，其中 profile 是用于存储用户信息的 JSON 类型：

CREATE TABLE customer_data (
    id INT,
    profile JSON
);

INSERT INTO customer_data VALUES
    (1, '{"name": "Alice", "age": 30, "city": "New York"}'),
    (2, '{"name": "Bob", "age": 25, "city": "Los Angeles"}'),
    (3, '{"name": "Charlie", "age": 35, "city": "Chicago"}');

此示例从 JSON 数据中提取特定字段：

SELECT
    id,
    jq('.name', profile) AS customer_name
FROM
    customer_data;

┌─────────────────────────────────────┐
│        id       │   customer_name   │
├─────────────────┼───────────────────┤
│               1 │ "Alice"           │
│               2 │ "Bob"             │
│               3 │ "Charlie"         │
└─────────────────────────────────────┘

此示例为每个用户选择用户 ID 和增加 1 后的年龄：

SELECT
    id,
    jq('.age + 1', profile) AS updated_age
FROM
    customer_data;

┌─────────────────────────────────────┐
│        id       │    updated_age    │
├─────────────────┼───────────────────┤
│               1 │ 31                │
│               2 │ 26                │
│               3 │ 36                │
└─────────────────────────────────────┘

此示例将城市名称转换为大写：

SELECT
    id,
    jq('.city | ascii_upcase', profile) AS city_uppercase
FROM
    customer_data;

┌─────────────────────────────────────┐
│        id       │   city_uppercase  │
├─────────────────┼───────────────────┤
│               1 │ "NEW YORK"        │
│               2 │ "LOS ANGELES"     │
│               3 │ "CHICAGO"         │
└─────────────────────────────────────┘