Skip to content

Commit 6a1e2b3

Browse files
committed
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.
1 parent cb659ec commit 6a1e2b3

File tree

9 files changed

+556
-185
lines changed

9 files changed

+556
-185
lines changed

contrib/dblink/README.dblink

Lines changed: 15 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -30,13 +30,11 @@
3030
*
3131
*/
3232

33-
Version 0.6 (14 June, 2003):
34-
Completely removed previously deprecated functions. Added ability
35-
to create "named" persistent connections in addition to the single global
36-
"unnamed" persistent connection.
37-
Tested under Linux (Red Hat 9) and PostgreSQL 7.4devel.
38-
3933
Release Notes:
34+
Version 0.7 (as of 25 Feb, 2004)
35+
- Added new version of dblink, dblink_exec, dblink_open, dblink_close,
36+
and, dblink_fetch -- allows ERROR on remote side of connection to
37+
throw NOTICE locally instead of ERROR
4038
Version 0.6
4139
- functions deprecated in 0.5 have been removed
4240
- added ability to create "named" persistent connections
@@ -85,7 +83,7 @@ Installation:
8583

8684
You can use dblink.sql to create the functions in your database of choice, e.g.
8785

88-
psql -U postgres template1 < dblink.sql
86+
psql template1 < dblink.sql
8987

9088
installs following functions into database template1:
9189

@@ -104,40 +102,40 @@ Installation:
104102

105103
cursor
106104
------------
107-
dblink_open(text,text) RETURNS text
105+
dblink_open(text,text [, bool fail_on_error]) RETURNS text
108106
- opens a cursor using unnamed connection already opened with
109107
dblink_connect() that will persist for duration of current backend
110108
or until it is closed
111-
dblink_open(text,text,text) RETURNS text
109+
dblink_open(text,text,text [, bool fail_on_error]) RETURNS text
112110
- opens a cursor using a named connection already opened with
113111
dblink_connect() that will persist for duration of current backend
114112
or until it is closed
115-
dblink_fetch(text, int) RETURNS setof record
113+
dblink_fetch(text, int [, bool fail_on_error]) RETURNS setof record
116114
- fetches data from an already opened cursor on the unnamed connection
117-
dblink_fetch(text, text, int) RETURNS setof record
115+
dblink_fetch(text, text, int [, bool fail_on_error]) RETURNS setof record
118116
- fetches data from an already opened cursor on a named connection
119-
dblink_close(text) RETURNS text
117+
dblink_close(text [, bool fail_on_error]) RETURNS text
120118
- closes a cursor on the unnamed connection
121-
dblink_close(text,text) RETURNS text
119+
dblink_close(text,text [, bool fail_on_error]) RETURNS text
122120
- closes a cursor on a named connection
123121

124122
query
125123
------------
126-
dblink(text,text) RETURNS setof record
124+
dblink(text,text [, bool fail_on_error]) RETURNS setof record
127125
- returns a set of results from remote SELECT query; the first argument
128126
is either a connection string, or the name of an already opened
129127
persistant connection
130-
dblink(text) RETURNS setof record
128+
dblink(text [, bool fail_on_error]) RETURNS setof record
131129
- returns a set of results from remote SELECT query, using the unnamed
132130
connection already opened with dblink_connect()
133131

134132
execute
135133
------------
136-
dblink_exec(text, text) RETURNS text
134+
dblink_exec(text, text [, bool fail_on_error]) RETURNS text
137135
- executes an INSERT/UPDATE/DELETE query remotely; the first argument
138136
is either a connection string, or the name of an already opened
139137
persistant connection
140-
dblink_exec(text) RETURNS text
138+
dblink_exec(text [, bool fail_on_error]) RETURNS text
141139
- executes an INSERT/UPDATE/DELETE query remotely, using connection
142140
already opened with dblink_connect()
143141

@@ -169,7 +167,6 @@ Documentation:
169167
doc/query
170168
doc/execute
171169
doc/misc
172-
doc/deprecated
173170

174171
==================================================================
175172
-- Joe Conway

0 commit comments

Comments
 (0)
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy