Documentation PostgreSQL 9.1.24 > Annexes > Modules supplémentaires fournis > dblink > dblink_close
dblink_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');
 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)

AltStyle によって変換されたページ (->オリジナル) /