| PostgreSQL 8.1 中文文档 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
SPI_exec 执行声明的 SQL 命令获取 count 行。 如果 read_only 为真，命令必须是只读的，因此可以略微降低一些执行的开销。
这个函数只能在已连接的过程中调用。
如果 count 是零，则在命令适合的所有行上执行。 如果 count 大于 0，那么命令执行的行数将被限制（很像一个 LIMIT 子句）。 比如，
SPI_execute("INSERT INTO foo SELECT * FROM bar", false, 5);将只允许最多 5 行插入表中。
你可以在一个字串里传递多个命令。 SPI_execute 返回最后执行的命令的结果。 count 的限制独立地应用于每一个命令， 但是不会应用于规则生成的隐藏命令。
如果 read_only 是 false， SPI_execute 递增命令计数器并且在执行字串里的每个命令之前计算一个新的"快照"。 如果当前事务的隔离级别是SERIALIZABLE，这个快照实际上并不改变， 但是在 READ COMMITTED 模式里，这个快照更新允许每个命令看到其它会话的事务提交的结果。 这样实际上是为了修改数据库的命令有一致的行为。
如果 read_only 是 true， SPI_execute 并不更新快照或者命令计数器，并且它指允许简单的 SELECT 命令出现在命令字串里。这个命令使用为周围的查询建立起来的快照执行。 这个执行模式比读/写模式执行得略微块些，因为它消除了每个命令的一些开销。 并且它还允许制作真正稳定的函数：因为随后的执行都将使用同一个快照， 结果里不会有改变。
通常，在同一个使用 SPI 的函数里混杂只读和读写命令是不明智的； 那样可能导致非常混乱的行为，因为只读的查询不能看到任何读写的查询做的数据库更新。
（最后）一条命令执行返回的结果的实际行数会放在全局的变量 SPI_processed 里 （除非函数返回的值是 SPI_OK_UTILITY）。如果函数的返回值是 SPI_OK_SELECT， 那么你可以使用全局指针 SPITupleTable *SPI_tuptable 访问结果行。
结构 SPITupleTable 是这样定义的：
typedef struct
{
MemoryContext tuptabcxt; /* 结果表的内存环境 */
uint32 alloced; /* 分配的 vals 的数目 */
uint32 free; /* 空闲的 vals 数目 */
TupleDesc tupdesc; /* 行描述符 */
HeapTuple *vals; /* 数据行 */
} SPITupleTable;vals 是一个指向数据行的的指针数组。 （有效记录的数目由 SPI_processed 给出）。 tupdesc 是一个行描述符，你可以传递给 SPI 函数处理这些数据行。 tuptabcxt，alloced，和 free 是 SPI 的内部字段，并非给 SPI 调用者使用的。
SPI_finish 释放所有在当前过程中分配的 SPITupleTables。 如果你已经处理完特定的结果表，那么可以更早地释放它，方法是调用 SPI_freetuptable。
如果命令执行成功，那么返回下列值之一（非负数）：
如果执行了一个 SELECT（但不是 SELECT INTO）
如果执行了一条 SELECT INTO。
如果执行了一条 DELETE。
如果执行了一条 INSERT。
如果执行了一条 UPDATE。
如果执行了一条工具命令你（比如，CREATE TABLE）
发生错误时，返回下列负数值之一：
如果 command 是 NULL 或者 count 小于 0
如果企图进行 COPY TO stdout 或者 COPY FROM stdin
如果企图进行 DECLARE，CLOSE，或者 FETCH
如果企图进行 BEGIN，COMMIT，或者 ROLLBACK
命令类型未知（不应该发生）
如果从一个未连接的过程中调用