历史版本。 PostgreSQL 8.3 已结束支持。 请参阅 当前版本手册.
dblink_connect
dblink_connect — 打开到远程数据库的持久连接
大纲
dblink_connect(text connstr) returns text dblink_connect(text connname, text connstr) returns text
描述
dblink_connect() 建立到远程
PostgreSQL 数据库的连接。要联系的服务器和数据库通过标准的
libpq 连接字符串标识。可以为该连接指定一个名称。可同时打开多个命名连接,但同一时间只允许存在一个未命名连接。该连接会一直保留到被关闭或数据库会话结束。
参数
connname用于该连接的名称;如果省略,则打开一个未命名连接,并替换现有的未命名连接。
connstr一种 libpq 风格的连接信息字符串,例如
hostaddr=127.0.0.1 port=5432 dbname=mydb user=postgres password=mypasswd。细节见第 30.1 节中的PQconnectdb。
返回值
返回状态,总是 OK(因为任何错误都会导致该函数抛出错误,而不是返回)。
注解
只有超级用户才能使用 dblink_connect 创建不使用密码认证的连接。如果非超级用户需要这种能力,请改用
dblink_connect_u。
选择包含等号的连接名称并不明智,因为这会导致在其他
dblink 函数中与连接信息字符串产生混淆风险。
Example
select dblink_connect('dbname=postgres');
dblink_connect
----------------
OK
(1 row)
select dblink_connect('myconn', 'dbname=postgres');
dblink_connect
----------------
OK
(1 row)