PostgreSQLLa base de données la plus sophistiquée au monde.

Version anglaise
Documentation PostgreSQL 9.6.24 > Annexes > Modules supplémentaires fournis > dblink > dblink_close
Précédentdblink_fetch dblink_get_connectionsSuivant

dblink_close

dblink_close — ferme un curseur sur une base de données distante

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 ferme un curseur précédemment ouvert avec dblink_open.

Arguments

connname

Le nom de la connexion à utiliser ; ce paramètre doit être omis pour utiliser une connexion sans nom.

cursorname

Nom du curseur à fermer.

fail_on_error

Si true (valeur par défaut en cas d'omission), une erreur distante est reportée localement comme une erreur. Dans le cas contraire, un message d'erreur distant est traité localement comme un message de type NOTICE, et la valeur de retour est positionnée à ERROR.

Valeur de retour

Renvoie le statut, soit OK soit ERROR.

Notes

Si dblink_open a ouvert un bloc de transaction explicite, et que c'est le dernier curseur ouvert restant dans cette connexion, dblink_close exécute le COMMIT correspondant.

Exemple 

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)