44.5. 例子

这是一个非常简单的 SPI 使用的例子。过程execq 在其第一个参数里接收一个 SQL 命令,第二个参数接收一个行计数, 用SPI_exec执行这个查询并且返回查询执行过的记录个数。 你可以在src/test/regress/regress.c中的源码树和 spi模块里找更复杂的例子。

#include "postgres.h"
#include "executor/spi.h"
#include "utils/builtins.h"
#ifdef PG_MODULE_MAGIC
PG_MODULE_MAGIC;
#endif
int execq(text *sql, int cnt);
int
execq(text *sql, int cnt)
{
 char *command;
 int ret;
 int proc;
 /* 把给出的 text 对象转换成 C 字符串*/
 command = text_to_cstring(sql);
 SPI_connect();
 ret = SPI_exec(command, cnt);
 proc = SPI_processed;
 /*
 
 * 如果取出了一些行,通过 elog(INFO) 打印它们
 */
 if (ret > 0 && SPI_tuptable != NULL)
 {
 TupleDesc tupdesc = SPI_tuptable->tupdesc;
 SPITupleTable *tuptable = SPI_tuptable;
 char buf[8192];
 int i, j;
 for (j = 0; j < proc; j++)
 {
 HeapTuple tuple = tuptable->vals[j];
 for (i = 1, buf[0] = 0; i <= tupdesc->natts; i++)
 snprintf(buf + strlen (buf), sizeof(buf) - strlen(buf), " %s%s",
 SPI_getvalue(tuple, tupdesc, i),
 (i == tupdesc->natts) ? " " : " |");
 elog(INFO, "EXECQ: %s", buf);
 }
 }
 SPI_finish();
 pfree(command);
 return (proc);
}

这个函数使用了调用习惯版本0 ,为了是让例子更容易理解。在真实的应用里, 你应该使用新的版本1的接口。

下面是你在把函数编译成共享库之后声明它的方法(详情请看 第 35.9.6 节):

CREATE FUNCTION execq(text, integer) RETURNS integer
 AS 'filename'
 LANGUAGE C;

下面是一个会话例子:

=> SELECT execq('CREATE TABLE a (x integer)', 0);
 execq
-------
 0
(1 row)
=> INSERT INTO a VALUES (execq('INSERT INTO a VALUES (0)', 0));
INSERT 0 1
=> SELECT execq('SELECT * FROM a', 0);
INFO: EXECQ: 0 -- execq插入 0 行
INFO: EXECQ: 1 -- execq 返回,被上层 INSERT 插入
 execq
-------
 2
(1 row)
=> SELECT execq('INSERT INTO a SELECT x + 2 FROM a', 1);
 execq
-------
 1
(1 row)
=> SELECT execq('SELECT * FROM a', 10);
INFO: EXECQ: 0
INFO: EXECQ: 1
INFO: EXECQ: 2 -- 0 + 2,就像声明的那样只插入了一行
 execq
-------
 3 -- 10 只是最大值,3 是真实的行数
(1 row)
=> DELETE FROM a;
DELETE 3
=> INSERT INTO a VALUES (execq('SELECT * FROM a', 0) + 1);
INSERT 0 1
=> SELECT * FROM a;
 x
---
 1 -- 在 (0)+1 里面没有行
(1 row)
=> INSERT INTO a VALUES (execq('SELECT * FROM a', 0) + 1);
INFO: EXECQ: 1
INSERT 0 1
=> SELECT * FROM a;
 x
---
 1
 2 -- 在 a+1 里面有一行
(2 rows)
-- 下面示范了改变数据可视性的规则:
=> INSERT INTO a SELECT execq('SELECT * FROM a', 0) * x FROM a;
INFO: EXECQ: 1
INFO: EXECQ: 2
INFO: EXECQ: 1
INFO: EXECQ: 2
INFO: EXECQ: 2
INSERT 0 2
=> SELECT * FROM a;
 x
---
 1
 2
 2 -- 2行 * 1 (x 在第一行)
 6 -- 3 行 (2 + 1 刚刚插入的) * 2 (第二行里的 x)
(4 rows) ^^^^^^
 在不同的调用里 execq() 看到的东西不同