dblink_close
Prev UpF.11. dblink — conectarse a otras bases de datos PostgreSQLHome Next

dblink_close

dblink_close — cierra un cursor en una base de datos remota

Synopsis

dblink_close(text cursorname [, bool fail_on_error]) returns text
dblink_close(text connname, text cursorname [, bool fail_on_error]) returns text

Descripción

dblink_close cierra un cursor abierto previamente con dblink_open.

Argumentos

connname

Nombre de la conexión a utilizar; omite este parámetro para usar la conexión sin nombre.

cursorname

El nombre del cursor que se desea cerrar.

fail_on_error

Si es true (el valor por defecto cuando se omite), entonces un error lanzado en el lado remoto de la conexión hace que también se lance un error localmente. Si es false, el error remoto se reporta localmente como una NOTICE, y el valor de retorno de la función se establece en ERROR.

Valor de retorno

Devuelve el estado, ya sea OK o ERROR.

Notas

Si dblink_open inició un bloque de transacción explícito, y este es el último cursor abierto restante en esta conexión, dblink_close emitirá el COMMIT correspondiente.

Ejemplos

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)

Prev Up Next
dblink_fetch Home dblink_get_connections