# dblink_connect ## Name dblink_connect?--?打開到遠程數據庫的持久連接 ## Synopsis ``` dblink_connect(text connstr) returns text dblink_connect(text connname, text connstr) returns text ``` ## 描述 `dblink_connect()`建立了遠程PostgreSQL數據庫的連接。 連接的服務器和數據庫是通過標準libpq連接字符串被標識。 隨意的，給連接分配名字。可以一次打開多個命名的連接，但是每次僅僅允許一個未命名連接。 連接將持續直到關閉或者數據庫會話結束為止。 連接字符串也可能是已存在外服務器的名字。當定義外服務器時，推薦使用外數據包`dblink_fdw`。 請看下面的例子，以及[CREATE SERVER](#calibre_link-6)和[CREATE USER MAPPING](#calibre_link-68)。 ## 參數 `conname` 用于連接的名稱；如果忽略，那么打開一個未命名的連接， 替換任何已存在未命名連接。 `connstr` libpq-形式連接信息字符串，比如`hostaddr=127.0.0.1 port=5432 dbname=mydb user=postgres password=mypasswd`。 更多詳情請參閱[Section 31.1.1](#calibre_link-458)。 另外，外服務器名稱。 ## 返回值 返回狀態總是`OK`（因為任何錯誤導致函數拋出錯誤而不是返回）。 ## 注意 只有超級用戶可能使用`dblink_connect`創建非口令認證連接。如果 非超級用戶需要這個能力，使用`dblink_connect_u`。 選擇包含等號的連接名是不明智的，正如這在其他`dblink`函數中打開 與連接信息字符串混淆的風險。 ## 例子 ``` SELECT dblink_connect('dbname=postgres'); dblink_connect ---------------- OK (1 row) SELECT dblink_connect('myconn', 'dbname=postgres'); dblink_connect ---------------- OK (1 row) -- 外數據封裝功能 -- 注意: 本地連接必須要求密碼認證工作正常 -- 否則，你將接收到來自dblink_connect()的下面的錯誤: -- ---------------------------------------------------------------------- -- ERROR: 需要密碼 -- DETAIL: 如果服務器不需要密碼，那么非超級用戶無法連接。 -- HINT: 必須改變目標服務器的身份驗證方法。 CREATE SERVER fdtest FOREIGN DATA WRAPPER dblink_fdw OPTIONS (hostaddr '127.0.0.1', dbname 'contrib_regression'); CREATE USER dblink_regression_test WITH PASSWORD 'secret'; CREATE USER MAPPING FOR dblink_regression_test SERVER fdtest OPTIONS (user 'dblink_regression_test', password 'secret'); GRANT USAGE ON FOREIGN SERVER fdtest TO dblink_regression_test; GRANT SELECT ON TABLE foo TO dblink_regression_test; \set ORIGINAL_USER :USER \c - dblink_regression_test SELECT dblink_connect('myconn', 'fdtest'); dblink_connect ---------------- OK (1 row) SELECT * FROM dblink('myconn','SELECT * FROM foo') AS t(a int, b text, c text[]); a | b | c ----+---+--------------- 0 | a | {a0,b0,c0} 1 | b | {a1,b1,c1} 2 | c | {a2,b2,c2} 3 | d | {a3,b3,c3} 4 | e | {a4,b4,c4} 5 | f | {a5,b5,c5} 6 | g | {a6,b6,c6} 7 | h | {a7,b7,c7} 8 | i | {a8,b8,c8} 9 | j | {a9,b9,c9} 10 | k | {a10,b10,c10} (11 rows) \c - :ORIGINAL_USER REVOKE USAGE ON FOREIGN SERVER fdtest FROM dblink_regression_test; REVOKE SELECT ON TABLE foo FROM dblink_regression_test; DROP USER MAPPING FOR dblink_regression_test SERVER fdtest; DROP USER dblink_regression_test; DROP SERVER fdtest; ```