SPI_execute — 执行命令
int SPI_execute(const char *command, boolread_only, longcount)
SPI_execute针对count行执行指定 SQL 命令。如果 read_only 为 true，命令必须为只读命令，且执行开销会略有减少。
此函数只能从已连接的 C 函数调用。
如果 count 为零，则为其适用的所有行执行命令。如果 count 大于零，则最多检索 count 行；当达到计数时，执行停止，就像向查询中添加 LIMIT 子句一样。例如，
SPI_execute("SELECT * FROM foo", true, 5);
将从表中最多检索 5 行。请注意，此类限制仅在命令实际返回行时才有效。例如，
SPI_execute("INSERT INTO foo SELECT * FROM bar", false, 5);
忽略 count 参数，插入 bar 中的所有行。但是，使用
SPI_execute("INSERT INTO foo SELECT * FROM bar RETURNING *", false, 5);
最多插入 5 行，因为检索第 5 个 RETURNING 结果行后执行将停止。
可在字符串中传递多个命令； SPI_execute 返回最后执行的命令的结果。 count 限制分别应用于每个命令（即使实际上只返回最后一个结果）。该限制不适用于规则生成的任何隐藏命令。
当 read_only 为 false 时， SPI_execute 将递增命令计数器并在执行字符串中的每个命令之前计算新的 快照。如果当前事务隔离级别为 SERIALIZABLE 或 REPEATABLE READ，则快照不会实际更改，但在 READ COMMITTED 模式下，快照更新允许每个命令查看其他会话中新提交事务的结果。当命令修改数据库时，快照更新对于保持一致的行为至关重要。
当 read_only 为 true 时， SPI_execute 不会更新快照或命令计数器，并且只允许在命令字符串中显示简单的 SELECT 命令。这些命令使用为周围查询先前建立的快照执行。由于消除了每个命令的开销，此执行模式比读/写模式稍快。它还允许构建真正的 稳定 函数：由于连续执行都将使用相同的快照，因此结果不会发生变化。
使用 SPI 在单个函数中混合只读和读写命令通常不明智；这可能会导致非常混乱的行为，因为只读查询不会看到读写查询所做的任何数据库更新的结果。
（最后）命令执行的实际行数在全局变量 SPI_processed 中返回。如果函数的返回值为 SPI_OK_SELECT、SPI_OK_INSERT_RETURNING、SPI_OK_DELETE_RETURNING、SPI_OK_UPDATE_RETURNING 或 SPI_OK_MERGE_RETURNING，那么你可以使用全局指针 SPITupleTable *SPI_tuptable 访问结果行。一些实用命令（例如 EXPLAIN）也会返回行集，在这些情况下 SPI_tuptable 也将包含结果。一些实用命令（COPY、CREATE TABLE AS）不会返回行集，因此 SPI_tuptable 为 NULL，但它们仍会返回 SPI_processed 中处理的行数。
结构 SPITupleTable 如此定义
typedef struct SPITupleTable
{
/* Public members */
TupleDesc tupdesc; /* tuple descriptor */
HeapTuple *vals; /* array of tuples */
uint64 numvals; /* number of valid tuples */
/* Private members, not intended for external callers */
uint64 alloced; /* allocated length of vals array */
MemoryContext tuptabcxt; /* memory context of result table */
slist_node next; /* link for internal bookkeeping */
SubTransactionId subid; /* subxact in which tuptable was created */
} SPITupleTable;
域 tupdesc、vals 和 numvals 可供 SPI 调用方使用；剩余的域是内部的。 vals 是指向行的指针数组。行数由 numvals 给出（出于某种历史原因，此计数也会在 SPI_processed 中返回）。 tupdesc 是行描述符，你可以将其传递给处理行的 SPI 函数。
SPI_finish 释放当前 C 函数期间分配的所有 SPITupleTable。如果你已完成特定结果表，可以通过调用 SPI_freetuptable 尽早释放它。
const char * command包含要执行的命令的字符串
bool read_onlytrue 表示只读执行
long count要返回的最大行数，或 0 表示无限制
如果命令执行成功，则将返回以下（非负）值之一
SPI_OK_SELECT如果执行了 SELECT（但未执行 SELECT INTO）
SPI_OK_SELINTO如果执行了 SELECT INTO
SPI_OK_INSERT如果执行了 INSERT
SPI_OK_DELETE如果执行了 DELETE
SPI_OK_UPDATE如果执行了 UPDATE
SPI_OK_MERGE如果执行了 MERGE
SPI_OK_INSERT_RETURNING如果执行了 INSERT RETURNING
SPI_OK_DELETE_RETURNING如果执行了 DELETE RETURNING
SPI_OK_UPDATE_RETURNING如果执行了 UPDATE RETURNING
SPI_OK_MERGE_RETURNING如果执行了 MERGE RETURNING
SPI_OK_UTILITY如果执行了一个实用程序命令（比如 CREATE TABLE）
SPI_OK_REWRITTEN如果命令被一个 规则 重新写入了另一种类型的命令（比如 UPDATE 变成了 INSERT）。
如果出错，将返回以下负值之一
SPI_ERROR_ARGUMENT如果 command 为 NULL 或 count 小于 0
SPI_ERROR_COPY如果尝试了 COPY TO stdout 或 COPY FROM stdin
SPI_ERROR_TRANSACTION如果尝试执行一个事务控制命令（BEGIN、COMMIT、ROLLBACK、SAVEPOINT、PREPARE TRANSACTION、COMMIT PREPARED、ROLLBACK PREPARED 或它们的任何变体）
SPI_ERROR_OPUNKNOWN如果命令类型未知（这不应该发生）
SPI_ERROR_UNCONNECTED如果从一个未连接的 C 函数调用
所有 SPI 查询执行函数都设置了 SPI_processed 和 SPI_tuptable（只是指针，而不是结构的内容）。如果你需要在之后的调用中访问 SPI_execute 或其他查询执行函数的结果表，请将这两个全局变量保存到本地 C 函数变量中。