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
如果为 true(省略时为默认值),则连接远程端抛出的错误将导致本地也抛出错误。如果为 false,则远程错误在本地将作为 NOTICE 报告,并且函数的返回值将设置为 ERROR
。
返回状态,可能是 OK
或 ERROR
。
由于游标只能在事务中持久存在,dblink_open
在远程端(如果该端当前不在事务中)启动一个显式的事务块(BEGIN
)。当执行匹配的 dblink_close
时,此事务将会再次关闭。请注意,如果在 dblink_open
和 dblink_close
之间使用 dblink_exec
更改数据,而后发生错误,或者在 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)