pg.ddx.io  pgsql-committers@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Tom Lane <tgl@sss.pgh.pa.us>
To: pgsql-committers@lists.postgresql.org
Subject: pgsql: Optimize LISTEN/NOTIFY via shared channel map and direct advance
Date: Thu, 15 Jan 2026 19:12:26 +0000
Message-ID: <E1vgSld-000fFk-2J@gemulon.postgresql.org> (raw)

Optimize LISTEN/NOTIFY via shared channel map and direct advancement.

This patch reworks LISTEN/NOTIFY to avoid waking backends that have
no need to process the notification messages we just sent.

The primary change is to create a shared hash table that tracks
which processes are listening to which channels (where a "channel" is
defined by a database OID and channel name).  This allows a notifying
process to accurately determine which listeners are interested,
replacing the previous weak approximation that listeners in other
databases couldn't be interested.

Secondly, if a listener is known not to be interested and is
currently stopped at the old queue head, we avoid waking it at all
and just directly advance its queue pointer past the notifications
we inserted.

These changes permit very significant improvements (integer multiples)
in NOTIFY throughput, as well as a noticeable reduction in latency,
when there are many listeners but only a few are interested in any
specific message.  There is no improvement for the simplest case where
every listener reads every message, but any loss seems below the noise
level.

Author: Joel Jacobson <joel@compiler.org>
Reviewed-by: Tom Lane <tgl@sss.pgh.pa.us>
Discussion: https://postgr.es/m/6899c044-4a82-49be-8117-e6f669765f7e@app.fastmail.com

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/282b1cde9dedf456ecf02eb27caf086023a7bb71

Modified Files
--------------
src/backend/commands/async.c                    | 1141 +++++++++++++++++++----
src/backend/utils/activity/wait_event_names.txt |    1 +
src/include/storage/lwlocklist.h                |    1 +
src/test/isolation/expected/async-notify.out    |  124 ++-
src/test/isolation/specs/async-notify.spec      |   72 ++
src/tools/pgindent/typedefs.list                |    6 +
6 files changed, 1161 insertions(+), 184 deletions(-)



Message-ID: <E1vgSld-000fFk-2J@gemulon.postgresql.org>
Permalink:  ../E1vgSld-000fFk-2J@gemulon.postgresql.org/
Also on:    postgresql.org/message-id/E1vgSld-000fFk-2J@gemulon.postgresql.org

 · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-committers@postgresql.org
  Cc: tgl@sss.pgh.pa.us, pgsql-committers@lists.postgresql.org
  Subject: Re: pgsql: Optimize LISTEN/NOTIFY via shared channel map and direct advance
  In-Reply-To: <E1vgSld-000fFk-2J@gemulon.postgresql.org>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox