PostgreSQL 8.4.1文書
前のページ | 巻戻し |  | 早送り | 次のページ

# dblink_connect

## 名前

dblink_connect -- リモートデータベースへの永続的な接続を開きます。

## 概要

        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

## 引数

`conname`

  接続に使用する名前です。省略した場合、既存の無名の接続を閉ざし、無名の接続を開きます。

`connstr`

  例えば`hostaddr=127.0.0.1 port=5432 dbname=mydb user=postgres password=mypasswd`といったlibpq形式の接続情報文字列です。 詳細は項30.1の `PQconnectdb`を参照してください。

## 戻り値

状態を返します。 これは常に`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)

     -- 外部データラッパー（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;

前のページ | ホーム | 次のページ
dblink | 上に戻る | dblink_connect_u