dblink_close#
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)