diff --git a/doc/src/sgml/bgworker.sgml b/doc/src/sgml/bgworker.sgml index 505e362879a..5570ed045db 100644 --- a/doc/src/sgml/bgworker.sgml +++ b/doc/src/sgml/bgworker.sgml @@ -277,6 +277,18 @@ typedef struct BackgroundWorker BGWH_POSTMASTER_DIED. + + If a background worker sends asynchronous notifications with the + NOTIFY command via the Server Programming Interface + (SPI), it should call + ProcessCompletedNotifies explicitly after committing + the enclosing transaction so that any notifications can be delivered. If a + background worker registers to receive asynchronous notifications with + the LISTEN through SPI, the worker + will log those notifications, but there is no programmatic way for the + worker to intercept and respond to those notifications. + + The worker_spi contrib module contains a working example, which demonstrates some useful techniques.