dblink_connect(text connstr) returns text
dblink_connect(text connname, text connstr) returns text
dblink_connect()はリモートのPostgreSQLデータベースへの接続を確立します。
接続先のサーバとデータベースは標準のlibpq接続文字列を通して識別されます。
省略可能ですが、名前を接続に割り当てることも可能です。
複数の名前付きの接続を一度に開くことができますが、無名の接続は同時に1つしか許されません。
接続は、閉ざされるまで、または、データベースセッションが終わるまで永続します。
接続文字列は同時に既存の外部サーバ名であっても構いません。
対応する外部データラッパーを定義する場合、postgresql_fdw_validatorを使用することを推奨します。後述の例と以下の一覧を参照してください。
CREATE FOREIGN DATA WRAPPER, CREATE SERVER, CREATE USER MAPPING
接続に使用する名前です。省略した場合、既存の無名の接続を閉ざし、無名の接続を開きます。
例えばhostaddr=127.0.0.1 port=5432 dbname=mydb user=postgres password=mypasswdといったlibpq形式の接続情報文字列です。
詳細は項30.1の PQconnectdbを参照してください。
スーパーユーザのみがパスワード認証がない接続を作成するために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)
-- 外部データラッパー(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 USER dblink_regression_test WITH PASSWORD 'secret';
CREATE FOREIGN DATA WRAPPER postgresql VALIDATOR postgresql_fdw_validator;
CREATE SERVER fdtest FOREIGN DATA WRAPPER postgresql OPTIONS (hostaddr '127.0.0.1', dbname 'contrib_regression');
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;
DROP FOREIGN DATA WRAPPER postgresql;