Postgresql 中文操作指南

dblink_close

dblink_close — 在远程数据库中关闭游标

Synopsis

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

Description

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

Arguments

  • connname

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

  • cursorname

    • 要关闭的游标的名称。

  • fail_on_error

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

Return Value

返回状态，可能是 OK 或 ERROR 。

Notes

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

Examples

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)