# SPI_saveplan ## Name SPI_saveplan?--?保存一個預備語句 ## Synopsis ``` SPIPlanPtr SPI_saveplan(SPIPlanPtr plan) ``` ## 描述 `SPI_saveplan`在內存里保存一個傳遞進來的語句(用 `SPI_prepare`準備的)，它將不會被`SPI_finish` 和事務管理器釋放，并且返回一個指向拷貝的語句的指針。 這樣就給你在當前會話里的隨后的調用中復用這個預備規劃的能力。 ## 參數 `SPIPlanPtr` `plan` 要保存的預備語句 ## 返回值 指向保存的規劃的指針；如果不成功則為 NULL 。出錯的時候，像下面這樣設置 SPI_result ： `SPI_ERROR_ARGUMENT` 如果`plan`是`NULL`或者無效的 `SPI_ERROR_UNCONNECTED` 如果從一個未連接的過程中調用 ## 注意 原先傳入的語句并沒有釋放，所以你可能希望在其上執行`SPI_freeplan`， 以避免內存泄露直到`SPI_finish`。 在大多數情況下，`SPI_keepplan`偏愛這個函數， 因為它基本上不需要物理上拷貝預備語句的數據結構就完成了相同的結果。