dblink_close

名称

dblink_close -- 关闭远程数据库中的游标

大纲

dblink_close(text cursorname [, bool fail_on_error]) returns text
dblink_close(text connname, text cursorname [, bool fail_on_error]) returns text

描述

dblink_close关闭先前使用dblink_open打开的游标。

参数

conname

要使用的连接名称;省略这个参数使用未命名连接。

cursorname

关闭的游标名称。

fail_on_error

如果真(忽略时缺省)那么在连接的远程端抛出的错误也会导致本地抛出错误, 如果假,那么远程错误在本地作为NOTICE被报告, 并且函数的返回值被设置为ERROR

返回值

返回状态,OK或者ERROR

注意

如果dblink_open启动了一个显式事务块,并且这是在该连接中最后保持打开的游标。 dblink_close将提交匹配的COMMIT

例子

SELECT dblink_connect('dbname=postgres');
 dblink_connect
----------------
 OK
(1 row)

SELECT dblink_open('foo', 'select proname, prosrc from pg_proc');
 dblink_open
-------------
 OK
(1 row)

SELECT dblink_close('foo');
 dblink_close
--------------
 OK
(1 row)