33.3. 运行SQL命令

33.3.1. 执行SQL语句

创建一个表：

EXEC SQL CREATE TABLE foo (number integer, ascii char(16));
EXEC SQL CREATE UNIQUE INDEX num1 ON foo(number);
EXEC SQL COMMIT;

插入一行：

EXEC SQL INSERT INTO foo (number, ascii) VALUES (9999, 'doodad');
EXEC SQL COMMIT;

删除一行：

EXEC SQL DELETE FROM foo WHERE number = 9999;
EXEC SQL COMMIT;

更新：

EXEC SQL UPDATE foo
    SET ascii = 'foobar'
    WHERE number = 9999;
EXEC SQL COMMIT;

可以通过EXEC SQL直接执行返回一个结果行的SELECT 语句。为了处理多行结果集，应用程序必须使用游标； 参阅Section 33.3.2。（特殊情况下，应用程序可以一次读取多行到数组宿主变量中； 参阅Section 33.4.4.3.1。）

单行select:

EXEC SQL SELECT foo INTO :FooBar FROM table1 WHERE ascii = 'doodad';

同时，可以使用SHOW命令检索配置参数：

EXEC SQL SHOW search_path INTO :var;

形如:something 这样的记号是宿主变量，也就是说，他们指向C程序中的变量。 在Section 33.4中有解释。

33.3.2. 使用游标

为了检索出多行的结果集，应用程序必须声明一个游标并且从游标中抓取每一行。 使用游标的步骤如下：声明一个游标，打开它，从游标中抓取一行，重复，最后关闭它。

使用游标选择：

EXEC SQL DECLARE foo_bar CURSOR FOR
    SELECT number, ascii FROM foo
    ORDER BY ascii;
EXEC SQL OPEN foo_bar;
EXEC SQL FETCH foo_bar INTO :FooBar, DooDad;
...
EXEC SQL CLOSE foo_bar;
EXEC SQL COMMIT;

关于游标声明的更多细节，请参阅DECLARE，关于 FETCH命令的细节请参阅FETCH。

33.3.3. 管理事务

在缺省模式下，语句只有在EXEC SQL COMMIT 发出的时候才提交， 嵌入的SQL接口也支持事务的自动提交（类似libpq的行为）， 方法是通过给ecpg（见ecpg） 增加命令行选项-t， 或者是通过EXEC SQL SET AUTOCOMMIT TO ON语句。 在自动提交模式里，每条命令都是自动提交的， 除非它们包围在一个明确的事务块里。 这个模式可以用EXEC SQL SET AUTOCOMMIT TO OFF明确地关闭。

有以下事务管理命令可用：

33.3.4. 预备语句

当编译时间不知道该值已被传递给SQL语句，或者同一语句将使用多次， 那么预备语句是有帮助的。

使用命令PREPARE准备语句。对于不知道的值， 使用占位符"?":

EXEC SQL PREPARE stmt1 FROM "SELECT oid, datname FROM pg_database WHERE oid = ?";

如果一个语句返回单行，应用程序可以在PREPARE 执行语句之后调用EXECUTE， 使用USING子句为占位符提供实际值：

EXEC SQL EXECUTE stmt1 INTO :dboid, :dbname USING 1;

如果一个语句返回多行，应用程序可以使用基于预备语句声明的游标。 为了结合输入参数，必须使用USING子句打开游标：

EXEC SQL PREPARE stmt1 FROM "SELECT oid,datname FROM pg_database WHERE oid > ?";
EXEC SQL DECLARE foo_bar CURSOR FOR stmt1;

/* 当结果集达到最后时，打破while循环 */

EXEC SQL WHENEVER NOT FOUND DO BREAK;

EXEC SQL OPEN foo_bar USING 100;
...
while (1)
{
    EXEC SQL FETCH NEXT FROM foo_bar INTO :dboid, :dbname;
    ...
}
EXEC SQL CLOSE foo_bar;

当你不再需要预备语句的时候，你应该重新分配它：

EXEC SQL DEALLOCATE PREPARE name;

为获得关于PREPARE的更多详情， 请参阅PREPARE。同时参阅Section 33.5 获得关于占位符和输入参数的更多详情。