Lambda 函数 – DuckDB - DuckDB 数据库

搜索快捷键 cmd + k | ctrl + k

文档 / SQL / 函数

Lambda 函数

弃用说明：DuckDB 1.3.0 已弃用旧版单箭头 lambda 语法（x -> x + 1），转而采用 Python 风格的语法（lambda x : x + 1）。

DuckDB 1.3.0 引入了一项新的设置用于配置 lambda 语法。
SET lambda_syntax = 'DEFAULT';
SET lambda_syntax = 'ENABLE_SINGLE_ARROW';
SET lambda_syntax = 'DISABLE_SINGLE_ARROW';
DuckDB 1.4.0 同时支持旧版单箭头语法和 Python 风格语法。

DuckDB 1.5.0 是最后一个无需显式启用即可支持单箭头语法的版本。

DuckDB 2.0.0 将默认禁用单箭头语法。

DuckDB 2.1.0 将移除 lambda_syntax 标志并完全弃用单箭头语法，届时将无法再使用旧版行为。

Lambda 函数允许在查询中使用更复杂和灵活的表达式。DuckDB 支持多种作用于 LIST（列表）的标量函数，这些函数接受形式为 lambda parameter1, parameter2, ... : expression 的 lambda 函数作为参数。如果 lambda 函数只有一个参数，则可以省略括号。参数可以使用任何名称。例如，以下均为有效的 lambda 函数：

lambda param : param > 1
lambda s : contains(concat(s, 'DB'), 'duck')
lambda acc, x : acc + x

接受 Lambda 函数的标量函数

函数	描述
`apply(list, lambda(x))`	`list_transform` 的别名。
`array_apply(list, lambda(x))`	`list_transform` 的别名。
`array_filter(list, lambda(x))`	`list_filter` 的别名。
`array_reduce(list, lambda(x, y)[, initial_value])`	`list_reduce` 的别名。
`array_transform(list, lambda(x))`	`list_transform` 的别名。
`filter(list, lambda(x))`	`list_filter` 的别名。
`list_apply(list, lambda(x))`	`list_transform` 的别名。
`list_filter(list, lambda(x))`	从输入 `list` 中构建一个新列表，其中包含使 `lambda` 函数返回 `true` 的元素。DuckDB 必须能够将 `lambda` 函数的返回类型转换为 `BOOL`。 `list_filter` 的返回类型与输入列表的类型相同。请参阅 `list_filter` 示例。
`list_reduce(list, lambda(x, y)[, initial_value])`	通过对运行结果和下一个列表元素执行 `lambda` 函数，将输入 `list` 的所有元素规约为单个标量值。`lambda` 函数有一个可选的 `initial_value`（初始值）参数。请参阅 `list_reduce` 示例。
`list_transform(list, lambda(x))`	返回一个列表，该列表是将 `lambda` 函数应用于输入 `list` 的每个元素的结果。返回类型由 `lambda` 函数的返回类型定义。请参阅 `list_transform` 示例。
`reduce(list, lambda(x, y)[, initial_value])`	`list_reduce` 的别名。

`list_filter(list, lambda(x))`

描述	从输入 `list` 中构建一个新列表，其中包含使 `lambda` 函数返回 `true` 的元素。DuckDB 必须能够将 `lambda` 函数的返回类型转换为 `BOOL`。 `list_filter` 的返回类型与输入列表的类型相同。请参阅 `list_filter` 示例。
示例	`list_filter([3, 4, 5], lambda x : x > 4)`
结果	`[5]`
别名	`array_filter`, `filter`

`list_reduce(list, lambda(x, y)[, initial_value])`

描述	通过对运行结果和下一个列表元素执行 `lambda` 函数，将输入 `list` 的所有元素规约为单个标量值。`lambda` 函数有一个可选的 `initial_value`（初始值）参数。请参阅 `list_reduce` 示例。
示例	`list_reduce([1, 2, 3], lambda x, y : x + y)`
结果	`6`
别名	`array_reduce`, `reduce`

`list_transform(list, lambda(x))`

描述	返回一个列表，该列表是将 `lambda` 函数应用于输入 `list` 的每个元素的结果。返回类型由 `lambda` 函数的返回类型定义。请参阅 `list_transform` 示例。
示例	`list_transform([1, 2, 3], lambda x : x + 1)`
结果	`[2, 3, 4]`
别名	`apply`, `array_apply`, `array_transform`, `list_apply`

嵌套 Lambda 函数

所有标量函数都可以任意嵌套。例如，使用嵌套的 lambda 函数获取列表中所有偶数元素的平方：

SELECT list_transform(
        list_filter([0, 1, 2, 3, 4, 5], lambda x: x % 2 = 0),
        lambda y: y * y
    );

[0, 4, 16]

用于将第一个列表的每个元素添加到第二个列表总和中的嵌套 lambda 函数：

SELECT list_transform(
        [1, 2, 3],
        lambda x :
            list_reduce([4, 5, 6], lambda a, b: a + b) + x
    );

[16, 17, 18]

作用域

Lambda 函数遵循以下顺序的作用域规则：

内部 lambda 参数
外部 lambda 参数
列名
宏参数

CREATE TABLE tbl (x INTEGER);
INSERT INTO tbl VALUES (10);
SELECT list_apply(
            [1, 2],
            lambda x: list_apply([4], lambda x: x + tbl.x)[1] + x
    )
FROM tbl;

[15, 16]

以索引作为参数

所有 lambda 函数都接受一个可选的额外参数，该参数表示当前元素的索引。这始终是 lambda 函数的最后一个参数（例如 (x, i) 中的 i），并且是从 1 开始计数的（即第一个元素的索引为 1）。

获取所有大于其索引的元素：

SELECT list_filter([1, 3, 1, 5], lambda x, i: x > i);

[3, 5]

示例

`list_transform` 示例

将每个列表元素加 1

SELECT list_transform([1, 2, NULL, 3], lambda x: x + 1);

[2, 3, NULL, 4]

转换字符串

SELECT list_transform(['Duck', 'Goose', 'Sparrow'], lambda s: concat(s, 'DB'));

[DuckDB, GooseDB, SparrowDB]

结合 lambda 函数与其他函数

SELECT list_transform([5, NULL, 6], lambda x: coalesce(x, 0) + 1);

[6, 1, 7]

`list_filter` 示例

过滤掉负值

SELECT list_filter([5, -6, NULL, 7], lambda x: x > 0);

[5, 7]

可被 2 和 5 整除

SELECT list_filter(
        list_filter([2, 4, 3, 1, 20, 10, 3, 30], lambda x: x % 2 = 0),
        lambda y: y % 5 = 0
    );

[20, 10, 30]

结合 range(...) 构建列表

SELECT list_filter([1, 2, 3, 4], lambda x: x > #1) FROM range(4);

[1, 2, 3, 4]
[2, 3, 4]
[3, 4]
[4]

`list_reduce` 示例

所有列表元素的总和

SELECT list_reduce([1, 2, 3, 4], lambda acc, x: acc + x);

仅相加大于 2 的列表元素

SELECT list_reduce(
        list_filter([1, 2, 3, 4], lambda x: x > 2),
        lambda acc, x: acc + x
    );

拼接所有列表元素

SELECT list_reduce(['DuckDB', 'is', 'awesome'], lambda acc, x: concat(acc, ' ', x));

DuckDB is awesome

在没有初始值的情况下拼接带有索引的元素

SELECT list_reduce(
        ['a', 'b', 'c', 'd'],
        lambda x, y, i: x || ' - ' || CAST(i AS VARCHAR) || ' - ' || y
    );

a - 2 - b - 3 - c - 4 - d

在有初始值的情况下拼接带有索引的元素

SELECT list_reduce(
        ['a', 'b', 'c', 'd'],
        lambda x, y, i: x || ' - ' || CAST(i AS VARCHAR) || ' - ' || y, 'INITIAL'
    );

INITIAL - 1 - a - 2 - b - 3 - c - 4 - d

限制

目前不支持在 lambda 表达式中使用子查询。例如：

SELECT list_apply([1, 2, 3], lambda x: (SELECT 42) + x);

Binder Error:
subqueries in lambda expressions are not supported

关于此页面

行为准则商标使用指南

关于此页面

本文中