バージョンごとのドキュメント一覧

SPI_register_trigger_data

SPI_register_trigger_data <refpurpose>make ephemeral trigger data available in SPI queries</refpurpose> — 短命のトリガーデータをSPIの問い合わせから利用可能にする

概要

int SPI_register_trigger_data(TriggerData *tdata)

説明

<title>Description</title>

<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のトリガハンドラ関数から呼び出されるようにします。

引数

<title>Arguments</title>
TriggerData *tdata

the <structname>TriggerData</structname> object passed to a trigger handler function as <literal>fcinfo->context</literal> トリガハンドラ関数にfcinfo->contextとして渡されるTriggerDataオブジェクト

戻り値

<title>Return Value</title>

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> tdataNULLの場合

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 トリガデータの遷移リレーションのどれかの名前が、この接続で既に登録されている場合