dblink_connect — リモートデータベースへの永続的な接続を開きます
dblink_connect(text connstr) returns text dblink_connect(text connname, text connstr) returns text
dblink_connect()
はリモートのPostgreSQLデータベースへの接続を確立します。
接続先のサーバとデータベースは標準のlibpq接続文字列を通して識別されます。
省略可能ですが、名前を接続に割り当てることも可能です。
複数の名前付きの接続を一度に開くことができますが、無名の接続は同時に1つしか許されません。
接続は、閉ざされるまで、または、データベースセッションが終わるまで永続します。
接続文字列は同時に既存の外部サーバ名であっても構いません。
外部サーバを定義する場合、外部データラッパーdblink_fdw
を使用することを推奨します。
後述の例とCREATE SERVER、CREATE USER MAPPINGを参照してください。
connname
接続に使用する名前です。省略した場合、既存の無名の接続を閉ざし、無名の接続を開きます。
connstr
例えばhostaddr=127.0.0.1 port=5432 dbname=mydb user=postgres password=mypasswd
といったlibpq形式の接続情報文字列です。
詳細は34.1.1を参照してください。
もしくは外部サーバ名です。
状態を返します。
これは常に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;