説明

dblink_connect()はリモートのPostgreSQLデータベースへの接続を確立します。 接続先のサーバとデータベースは標準のlibpq接続文字列を通して識別されます。 省略可能ですが、名前を接続に割り当てることも可能です。 複数の名前付きの接続を一度に開くことができますが、無名の接続は同時に1つしか許されません。 接続は、閉ざされるまで、または、データベースセッションが終わるまで永続します。

接続文字列は同時に既存の外部サーバ名であっても構いません。 外部サーバを定義する場合、外部データラッパーdblink_fdwを使用することを推奨します。 後述の例とCREATE SERVER、CREATE USER MAPPINGを参照してください。

引数

戻り値

状態を返します。 これは常にOKです（何らかのエラーが起きるとこの関数は戻らずエラーとなるためです）。

注釈

信頼できないユーザが、安全なスキーマ使用パターンを適用していないデータベースへアクセスする際には、セッション開始時にsearch_pathから、第三者が書き込みができるスキーマを削除してください。 これはたとえばoptionsパラメータキーワードに値-csearch_path=を設定することで可能となります。 このような配慮は、dblinkに限ったことではありません。 任意のSQLコマンドを実行するすべてのインタフェースに当てはまります。

スーパーユーザのみがパスワード認証がない接続を作成するためにdblink_connectを使用することができます。 スーパーユーザ以外でこの機能が必要ならばdblink_connect_uを代わりに使用してください。

他のdblink関数内で接続情報文字列が混乱する危険が発生しますので、等号記号を含む接続名を選択することは勧めません。

例

SELECT dblink_connect('dbname=postgres options=-csearch_path=');
 dblink_connect
----------------
 OK
(1 row)

SELECT dblink_connect('myconn', 'dbname=postgres options=-csearch_path=');
 dblink_connect
----------------
 OK
(1 row)


-- 外部データラッパー（FOREIGN DATA WRAPPER）の機能
-- 注意：これが正常に機能するにはローカル接続にパスワード認証が必須です。
--       さもないと、dblink_connect():から以下のエラーを受け取ります。
--       ----------------------------------------------------------------------
--       ERROR:  password is required
--       DETAIL:  Non-superuser cannot connect if the server does not request a password.
--       HINT:  Target server's authentication method must be changed.

CREATE SERVER fdtest FOREIGN DATA WRAPPER dblink_fdw OPTIONS (hostaddr '127.0.0.1', dbname 'contrib_regression');

CREATE USER regress_dblink_user WITH PASSWORD 'secret';
CREATE USER MAPPING FOR regress_dblink_user SERVER fdtest OPTIONS (user 'regress_dblink_user', password 'secret');
GRANT USAGE ON FOREIGN SERVER fdtest TO regress_dblink_user;
GRANT SELECT ON TABLE foo TO regress_dblink_user;

\set ORIGINAL_USER :USER
\c - regress_dblink_user
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 regress_dblink_user;
REVOKE SELECT ON TABLE foo FROM regress_dblink_user;
DROP USER MAPPING FOR regress_dblink_user SERVER fdtest;
DROP USER regress_dblink_user;
DROP SERVER fdtest;