dblink_connect

Name

dblink_connect -- opens a persistent connection to a remote database

Synopsis

    dblink_connect(text connstr)
    dblink_connect(text connname, text connstr)
   

Inputs

connname

if 2 arguments ar given, the first is used as a name for a persistent connection

connstr

standard libpq format connection string, e.g. "hostaddr=127.0.0.1 port=5432 dbname=mydb user=postgres password=mypasswd"

if only one argument is given, the connection is unnamed; only one unnamed connection can exist at a time

Outputs

Returns status = "OK"

Example

 select dblink_connect('dbname=postgres');
  dblink_connect
 ----------------
  OK
 (1 row)
 
 select dblink_connect('myconn','dbname=postgres');
  dblink_connect
 ----------------
  OK
 (1 row)