mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document interaction of bgworkers with LISTEN/NOTIFY.

Browse Source 
Thomas Munro and Robert Haas, reviewed by Haribabu Kommi
This commit is contained in:
Robert Haas 2015-11-06 00:31:03 -05:00
parent b23af45875
commit dde5f09fad
1 changed files with 12 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
doc/src/sgml/bgworker.sgml
View File

@ -277,6 +277,18 @@ typedef struct BackgroundWorker
<literal>BGWH_POSTMASTER_DIED</literal>.
</para>
<para>
If a background worker sends asynchronous notifications with the
<command>NOTIFY</command> command via the Server Programming Interface
(<acronym>SPI</acronym>), it should call
<function>ProcessCompletedNotifies</function> explicitly after committing
the enclosing transaction so that any notifications can be delivered. If a
background worker registers to receive asynchronous notifications with
the <command>LISTEN</command> through <acronym>SPI</acronym>, the worker
will log those notifications, but there is no programmatic way for the
worker to intercept and respond to those notifications.
</para>
<para>
The <filename>worker_spi</> contrib module contains a working example,
which demonstrates some useful techniques.