SPI_saveplan

SPI_saveplan —保存准备好的语句

Synopsis

SPIPlanPtr SPI_saveplan(SPIPlanPtr plan)

Description

SPI_saveplan将传递的语句(由SPI_prepare准备)复制到SPI_finish或事务 Management 器都不会释放的内存中,并返回指向复制的语句的指针。这使您能够在当前会话的过程的后续调用中重用准备好的语句。

Arguments

  • SPIPlanPtr plan

    • 准备好的要保存的语句

Return Value

指向复制语句的指针;或NULL(如果不成功)。如果出错,则设置SPI_result

  • SPI_ERROR_ARGUMENT

    • 如果* plan *为NULL或无效
  • SPI_ERROR_UNCONNECTED

    • 如果从未连接的过程调用

Notes

最初传入的语句不会释放,因此您可能希望对其执行SPI_freeplan以避免在SPI_finish之前泄漏内存。

在大多数情况下,此函数首选SPI_keepplan,因为它可以实现几乎相同的结果,而无需物理复制准备好的语句的数据结构。