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
-
conname
-
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');
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)