---
name: "dblink_get_notify"
section: "3"
platform: "linux"
package: "postgresql"
version: "18.6-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/dblink_get_notify"
---

# dblink\_get\_notify(3)

retrieve async notifications on a connection

## NAME

dblink\_get\_notify - retrieve async notifications on a connection

## SYNOPSIS

```
dblink_get_notify() returns setof (notify_name text, be_pid int, extra text)
dblink_get_notify(text connname) returns setof (notify_name text, be_pid int, extra text)
```

## DESCRIPTION

**dblink\_get\_notify** retrieves notifications on either the unnamed connection, or on a named connection if specified. To receive notifications via dblink, **LISTEN** must first be issued, using **dblink\_exec**. For details see [**LISTEN**(7)](/LISTEN/7.md) and [**NOTIFY**(7)](/NOTIFY/7.md).

## ARGUMENTS

*connname*

The name of a named connection to get notifications on.

## RETURN VALUE

Returns setof (notify\_name text, be\_pid int, extra text), or an empty set if none.

## EXAMPLES

```
SELECT dblink_exec('LISTEN virtual');
 dblink_exec
-------------
 LISTEN
(1 row)
SELECT * FROM dblink_get_notify();
 notify_name | be_pid | extra
-------------+--------+-------
(0 rows)
NOTIFY virtual;
NOTIFY
SELECT * FROM dblink_get_notify();
 notify_name | be_pid | extra
-------------+--------+-------
 virtual     |   1229 |
(1 row)
```