SPI_saveplan

説明

SPI_saveplan stores a plan prepared by SPI_prepare in safe memory protected from freeing by SPI_finish or the transaction manager.

SPI_saveplan は、SPI_prepare によって作成された計画を SPI_finish やトランザクションマネージャによっ て行なわれるメモリの開放の影響を受けない安全なメモリ領域に保存しま す。

In the current version of Postgres there is no ability to store prepared plans in the system catalog and fetch them from there for execution. This will be implemented in future versions. As an alternative, there is the ability to reuse prepared plans in the consequent invocations of your procedure in the current session. Use SPI_execp to execute this saved plan.

現状の Postgres では、準備済み計画をシス テムカタログに保存しておき、実行時にそれを取り出すといった機能はあり ません。この機能は将来実装されるでしょう。 代わりに、同じセッションの中で、後から起動されるプロシージャが準備済 み計画を再利用する機能はあります。この保存された計画を実行するには、 SPI_execp を使用して下さい。

使い方

SPI_saveplan saves a passed plan (prepared by SPI_prepare) in memory protected from freeing by SPI_finish and by the transaction manager and returns a pointer to the saved plan. You may save the pointer returned in a local variable. Always check if this pointer is NULL or not either when preparing a plan or using an already prepared plan in SPI_execp (see below).

SPI_saveplan は（ SPI_prepare によって準備され）渡された計画を SPI_finish やトランザクションマネージャによっ て行なわれるメモリの開放の影響を受けない安全なメモリ領域に保存し、 その保存した計画を示すポインタを返します。返されたポインタをローカ ル変数に保存することもできます。計画を準備する時や（後述の） SPI_execp で既存の準備済み計画を使用する時は、常にこのポインタが NULL かどうかを点検して下さい。