描述

SPI_prepare 创建并返回一个执行计划（解析器+规划器+优化器），但不执行该查询。 只应从已连接的过程中调用。

用法

当同一条或相似的查询需要反复执行时，只做一次查询规划可能是有利的。 SPI_prepare 把查询字符串转换成一个执行计划， 之后可以反复传给 SPI_execp。

预备查询可以通过在普通查询原本应写常量的位置写入参数 （$1、$2 等）而得到泛化。这些参数的值会在调用 SPI_execp 时指定。这样，预备查询就能适用于比 不带参数时更广泛的场景。

如果查询使用了参数，那么在调用 SPI_prepare 时 必须指定它们的数量和数据类型。

SPI_prepare 返回的计划只能在当前这次过程调用中 使用，因为 SPI_finish 会释放为计划分配的内存。 但可以使用 SPI_saveplan 把计划保存得更久。

成功时会返回一个非空指针。否则，将得到 NULL 计划。无论成功还是出错， SPI_result 都会被设成与 SPI_exec 返回值类似的值；但如果 query 为 NULL，或 nargs < 0，或 nargs > 0 且 argtypes 为 NULL，则会将其设为 → SPI_ERROR_ARGUMENT。