mirror of
https://github.com/postgres/postgres.git
synced 2025-07-28 23:42:10 +03:00
Added new versions of dblink, dblink_exec, dblink_open, dblink_close,
and, dblink_fetch -- allows ERROR on remote side of connection to throw NOTICE locally instead of ERROR. Also removed documentation for previously deprecated, now removed, functions.
This commit is contained in:
@ -5,8 +5,8 @@ dblink_open -- Opens a cursor on a remote database
|
||||
|
||||
Synopsis
|
||||
|
||||
dblink_open(text cursorname, text sql)
|
||||
dblink_open(text connname, text cursorname, text sql)
|
||||
dblink_open(text cursorname, text sql [, bool fail_on_error])
|
||||
dblink_open(text connname, text cursorname, text sql [, bool fail_on_error])
|
||||
|
||||
Inputs
|
||||
|
||||
@ -23,6 +23,13 @@ Inputs
|
||||
sql statement that you wish to execute on the remote host
|
||||
e.g. "select * from pg_class"
|
||||
|
||||
fail_on_error
|
||||
|
||||
If true (default when not present) 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 treated as a NOTICE, and the return value is set
|
||||
to 'ERROR'.
|
||||
|
||||
Outputs
|
||||
|
||||
Returns status = "OK"
|
||||
@ -56,8 +63,8 @@ dblink_fetch -- Returns a set from an open cursor on a remote database
|
||||
|
||||
Synopsis
|
||||
|
||||
dblink_fetch(text cursorname, int32 howmany)
|
||||
dblink_fetch(text connname, text cursorname, int32 howmany)
|
||||
dblink_fetch(text cursorname, int32 howmany [, bool fail_on_error])
|
||||
dblink_fetch(text connname, text cursorname, int32 howmany [, bool fail_on_error])
|
||||
|
||||
Inputs
|
||||
|
||||
@ -75,6 +82,12 @@ Inputs
|
||||
starting at the current cursor position, moving forward. Once the cursor
|
||||
has positioned to the end, no more rows are produced.
|
||||
|
||||
fail_on_error
|
||||
|
||||
If true (default when not present) 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 treated as a NOTICE, and no rows are returned.
|
||||
|
||||
Outputs
|
||||
|
||||
Returns setof record
|
||||
@ -132,8 +145,8 @@ dblink_close -- Closes a cursor on a remote database
|
||||
|
||||
Synopsis
|
||||
|
||||
dblink_close(text cursorname)
|
||||
dblink_close(text connname, text cursorname)
|
||||
dblink_close(text cursorname [, bool fail_on_error])
|
||||
dblink_close(text connname, text cursorname [, bool fail_on_error])
|
||||
|
||||
Inputs
|
||||
|
||||
@ -145,6 +158,13 @@ Inputs
|
||||
|
||||
a reference name for the cursor
|
||||
|
||||
fail_on_error
|
||||
|
||||
If true (default when not present) 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 treated as a NOTICE, and the return value is set
|
||||
to 'ERROR'.
|
||||
|
||||
Outputs
|
||||
|
||||
Returns status = "OK"
|
||||
|
Reference in New Issue
Block a user