SPI_register_trigger_data <refpurpose>make ephemeral trigger data available in SPI queries</refpurpose> — 短命のトリガーデータをSPIの問い合わせから利用可能にする
int SPI_register_trigger_data(TriggerData *tdata
)
<function>SPI_register_trigger_data</function> makes any ephemeral
relations captured by a trigger available to queries planned and executed
through the current SPI connection. Currently, this means the transition
tables captured by an <literal>AFTER</literal> trigger defined with a
<literal>REFERENCING OLD/NEW TABLE AS</literal> ... clause. This function
should be called by a PL trigger handler function after connecting.
SPI_register_trigger_data
はトリガによって捕捉される任意の短命のリレーションを、現在のSPI接続を通して計画され、実行される問い合わせで利用可能にします。
現在のところ、これはREFERENCING OLD/NEW TABLE AS
の句で定義されるAFTER
トリガによって捕捉される遷移テーブルを意味します。
この関数は接続後にPLのトリガハンドラ関数から呼び出されるようにします。
TriggerData *tdata
the <structname>TriggerData</structname> object passed to a trigger
handler function as <literal>fcinfo->context</literal>
トリガハンドラ関数にfcinfo->context
として渡されるTriggerData
オブジェクト
If the execution of the command was successful then the following (nonnegative) value will be returned: コマンドの実行に成功したときは、次の(負でない)値が返されます。
SPI_OK_TD_REGISTER
if the captured trigger data (if any) has been successfully registered 捕捉されたトリガデータ(あれば)が登録された場合
On error, one of the following negative values is returned: エラーが発生したときは、以下の負の値の一つが返されます。
SPI_ERROR_ARGUMENT
if <parameter>tdata</parameter> is <symbol>NULL</symbol>
tdata
がNULL
の場合
SPI_ERROR_UNCONNECTED
if called from an unconnected C function 未接続のC関数から呼び出された場合
SPI_ERROR_REL_DUPLICATE
if the name of any trigger data transient relation is already registered for this connection トリガデータの遷移リレーションのどれかの名前が、この接続で既に登録されている場合