dblink_close

примечание

Эта страница переведена при помощи нейросети GigaChat.

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)