DBLINK_GET_NOTIFY(3) PostgreSQL 9.2.7 Documentation DBLINK_GET_NOTIFY(3)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) and NOTIFY(7).
ARGUMENTS
conname
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)
PostgreSQL 9.2.7 2014-02-17 DBLINK_GET_NOTIFY(3)
Check Out this Related Man Page
DBLINK_FETCH(3) PostgreSQL 9.2.7 Documentation DBLINK_FETCH(3)NAME
dblink_fetch - returns rows from an open cursor in a remote database
SYNOPSIS
dblink_fetch(text cursorname, int howmany [, bool fail_on_error]) returns setof record
dblink_fetch(text connname, text cursorname, int howmany [, bool fail_on_error]) returns setof record
DESCRIPTION
dblink_fetch fetches rows from a cursor previously established by dblink_open.
ARGUMENTS
conname
Name of the connection to use; omit this parameter to use the unnamed connection.
cursorname
The name of the cursor to fetch from.
howmany
The maximum number of rows to retrieve. The next howmany rows are fetched, starting at the current cursor position, moving forward.
Once the cursor has reached its end, no more rows are produced.
fail_on_error
If true (the default when omitted) then an error thrown on the remote side of the connection causes an error to also be thrown locally.
If false, the remote error is locally reported as a NOTICE, and the function returns no rows.
RETURN VALUE
The function returns the row(s) fetched from the cursor. To use this function, you will need to specify the expected set of columns, as
previously discussed for dblink.
NOTES
On a mismatch between the number of return columns specified in the FROM clause, and the actual number of columns returned by the remote
cursor, an error will be thrown. In this event, the remote cursor is still advanced by as many rows as it would have been if the error had
not occurred. The same is true for any other error occurring in the local query after the remote FETCH has been done.
EXAMPLES
SELECT dblink_connect('dbname=postgres');
dblink_connect
----------------
OK
(1 row)
SELECT dblink_open('foo', 'select proname, prosrc from pg_proc where proname like ''bytea%''');
dblink_open
-------------
OK
(1 row)
SELECT * FROM dblink_fetch('foo', 5) AS (funcname name, source text);
funcname | source
----------+----------
byteacat | byteacat
byteacmp | byteacmp
byteaeq | byteaeq
byteage | byteage
byteagt | byteagt
(5 rows)
SELECT * FROM dblink_fetch('foo', 5) AS (funcname name, source text);
funcname | source
-----------+-----------
byteain | byteain
byteale | byteale
bytealike | bytealike
bytealt | bytealt
byteane | byteane
(5 rows)
SELECT * FROM dblink_fetch('foo', 5) AS (funcname name, source text);
funcname | source
------------+------------
byteanlike | byteanlike
byteaout | byteaout
(2 rows)
SELECT * FROM dblink_fetch('foo', 5) AS (funcname name, source text);
funcname | source
----------+--------
(0 rows)
PostgreSQL 9.2.7 2014-02-17 DBLINK_FETCH(3)