2024 年 9 月 26 日: PostgreSQL 17 发布!
支持版本:当前 (17) / 16 / 15 / 14 / 13 / 12
开发版本:devel
不支持版本:11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4

34.5. 动态 SQL #

在很多情况下,应用程序需要执行的特定 SQL 语句是在应用程序编写时已知的。但在某些情况下,SQL 语句是在运行时生成的,或者由外部来源提供。在这些情况下,您不能将 SQL 语句直接嵌入到 C 源代码中,但有一个功能可以让您调用您在字符串变量中提供的任意 SQL 语句。

34.5.1. 执行没有结果集的语句 #

执行任意 SQL 语句最简单的方法是使用命令 EXECUTE IMMEDIATE。例如

EXEC SQL BEGIN DECLARE SECTION;
const char *stmt = "CREATE TABLE test1 (...);";
EXEC SQL END DECLARE SECTION;

EXEC SQL EXECUTE IMMEDIATE :stmt;

EXECUTE IMMEDIATE 可用于不返回结果集的 SQL 语句(例如 DDL、INSERTUPDATEDELETE)。您无法通过这种方式执行检索数据的语句(例如 SELECT)。下一节将介绍如何执行此操作。

34.5.2. 执行带输入参数的语句 #

执行任意 SQL 语句的一种更强大的方法是先准备它们,然后根据需要执行已准备好的语句。还可以准备语句的通用版本,然后通过替换参数来执行其特定版本。在准备语句时,在您想要稍后替换参数的地方编写问号。例如

EXEC SQL BEGIN DECLARE SECTION;
const char *stmt = "INSERT INTO test1 VALUES(?, ?);";
EXEC SQL END DECLARE SECTION;

EXEC SQL PREPARE mystmt FROM :stmt;
 ...
EXEC SQL EXECUTE mystmt USING 42, 'foobar';

当不再需要已准备好的语句时,您应该将其解除分配

EXEC SQL DEALLOCATE PREPARE name;

34.5.3. 执行带结果集的语句 #

要执行仅返回单行结果的 SQL 语句,可以使用 EXECUTE。要保存结果,请添加 INTO 子句。

EXEC SQL BEGIN DECLARE SECTION;
const char *stmt = "SELECT a, b, c FROM test1 WHERE a > ?";
int v1, v2;
VARCHAR v3[50];
EXEC SQL END DECLARE SECTION;

EXEC SQL PREPARE mystmt FROM :stmt;
 ...
EXEC SQL EXECUTE mystmt INTO :v1, :v2, :v3 USING 37;

一个 EXECUTE 命令可以包含 INTO 子句、USING 子句、两者兼有或两者都没有。

如果查询预计返回多行结果,则应使用游标,如以下示例所示。(有关游标的更多详细信息,请参阅第 34.3.2 节。)

EXEC SQL BEGIN DECLARE SECTION;
char dbaname[128];
char datname[128];
char *stmt = "SELECT u.usename as dbaname, d.datname "
             "  FROM pg_database d, pg_user u "
             "  WHERE d.datdba = u.usesysid";
EXEC SQL END DECLARE SECTION;

EXEC SQL CONNECT TO testdb AS con1 USER testuser;
EXEC SQL SELECT pg_catalog.set_config('search_path', '', false); EXEC SQL COMMIT;

EXEC SQL PREPARE stmt1 FROM :stmt;

EXEC SQL DECLARE cursor1 CURSOR FOR stmt1;
EXEC SQL OPEN cursor1;

EXEC SQL WHENEVER NOT FOUND DO BREAK;

while (1)
{
    EXEC SQL FETCH cursor1 INTO :dbaname,:datname;
    printf("dbaname=%s, datname=%s\n", dbaname, datname);
}

EXEC SQL CLOSE cursor1;

EXEC SQL COMMIT;
EXEC SQL DISCONNECT ALL;

提交更正

如果您在文档中发现任何不正确的内容,与您对特定功能的体验不符,或者需要进一步说明,请使用此表格报告文档问题。