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, удаленная ошибка сообщается локально как УВЕДОМЛЕНИЕ, а возвращаемое значение функции устанавливается равным 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)