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打开的游标。

参数

connname

要使用的连接名称；省略此参数以使用未命名连接。

cursorname

要关闭的游标的名称。

fail_on_error

如果为 true（省略时为默认值），则连接远程端抛出的错误会导致本地也抛出错误。如果为 false，则远程错误在本地报告为 NOTICE，并且函数的返回值设置为 ERROR。

返回值

返回状态，OK或ERROR。

注释

如果dblink_open启动了一个显式事务块，并且这是此连接中最后一个保持打开状态的游标，则dblink_close将发出匹配的COMMIT。

示例

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)

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