DuckDB 支持预处理语句，在执行查询时会替换其中的参数。这不仅能提高代码的可读性，还有助于防止 SQL 注入。

语法

预处理语句中定义参数有三种语法：自动递增（?）、位置参数（$1）和命名参数（$param）。请注意，并非所有客户端都支持所有这些语法，例如 JDBC 客户端在预处理语句中仅支持自动递增参数。

示例数据集

在下文中，我们将介绍这三种不同的语法，并使用下表进行举例说明。

CREATE TABLE person (name VARCHAR, age BIGINT);
INSERT INTO person VALUES ('Alice', 37), ('Ana', 35), ('Bob', 41), ('Bea', 25);

在我们的示例查询中，我们将查找名字以 B 开头且年龄至少为 40 岁的人。这将返回单行结果 <'Bob', 41>。

自动递增参数：?

DuckDB 支持在预处理语句中使用自动递增索引，即参数在查询中的位置对应它们在执行语句中的位置。例如：

PREPARE query_person AS
    SELECT *
    FROM person
    WHERE starts_with(name, ?)
      AND age >= ?;

使用 CLI 客户端时，语句执行方式如下。

EXECUTE query_person('B', 40);

位置参数：$1

预处理语句可以使用位置参数，即用整数（$1, $2）来表示参数。例如：

PREPARE query_person AS
    SELECT *
    FROM person
    WHERE starts_with(name, $2)
      AND age >= $1;

使用 CLI 客户端时，语句执行方式如下。请注意，第一个参数对应 $1，第二个对应 $2，依此类推。

EXECUTE query_person(40, 'B');

命名参数：$parameter

DuckDB 还支持命名参数，使用 $parameter_name 来表示参数。例如：

PREPARE query_person AS
    SELECT *
    FROM person
    WHERE starts_with(name, $name_start_letter)
      AND age >= $minimum_age;

使用 CLI 客户端时，语句执行方式如下。

EXECUTE query_person(name_start_letter := 'B', minimum_age := 40);

删除预处理语句：DEALLOCATE

要删除预处理语句，请使用 DEALLOCATE 语句：

DEALLOCATE query_person;

或者，使用：

DEALLOCATE PREPARE query_person;