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)