dblink_open — 在远程数据库中打开一个游标
dblink_open(text cursorname, text sql [, bool fail_on_error]) returns text dblink_open(text connname, text cursorname, text sql [, bool fail_on_error]) returns text
dblink_open()
在远程数据库中打开一个游标。随后可以使用 dblink_fetch()
和 dblink_close()
操作游标。
connname
要使用的连接的名称;省略此参数以使用未命名连接。
cursorname
要分配给此游标的名称。
sql
您希望在远程数据库中执行的 SELECT
语句,例如 select * from pg_class
。
fail_on_error
如果为真(省略时为默认值),则连接远程端抛出的错误会导致本地也抛出错误。如果为假,则远程错误在本地报告为 NOTICE,并且函数的返回值设置为 ERROR
。
返回状态,即 OK
或 ERROR
。
由于游标只能在事务中持续存在,因此,dblink_open
在远程端启动一个显式事务块 (BEGIN
),如果远程端尚未处于事务中。当匹配的 dblink_close
执行时,该事务将再次关闭。请注意,如果您使用 dblink_exec
在 dblink_open
和 dblink_close
之间更改数据,然后出现错误或您在 dblink_close
之前使用 dblink_disconnect
,您的更改 将丢失,因为事务将中止。
SELECT dblink_connect('dbname=postgres options=-csearch_path='); dblink_connect ---------------- OK (1 row) SELECT dblink_open('foo', 'select proname, prosrc from pg_proc'); dblink_open ------------- OK (1 row)