PostgreSQL Elephant Logo
2025年9月25日: PostgreSQL 18 发布!
dblink_close
上一步  上一级 F.11. dblink — 连接到其他 PostgreSQL 数据库 首页  下一步

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(省略时默认为 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)

上一步  上一级  下一步
dblink_fetch  首页  dblink_get_connections