JQ

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

语法

JQ (<jq_expression>, <json_data>)

返回类型

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"         │
└─────────────────────────────────────┘