DBD-Pg-1.22 > DBD::Pg

DBD-Pg-1.22

名前¶

DBD::Pg - DBIモジュールのためのPostgreSQL データベース・ドライバ

概要¶

  use DBI;

  $dbh = DBI->connect("dbi:Pg:dbname=$dbname", "", "");

  # より高度な使い方のためにはPostgreSQLのデータ型の値が必要かもしれません:
  use DBD::Oracle qw(:pg_types);

  # 完全な詳細についてはDBIモジュールのドキュメントをご覧ください

説明¶

DBD::Pg はDBIモジュールと一緒に機能し、PostgreSQLデータベースへのアクセスを提供するPerl モジュールです。

モジュール・ドキュメント¶

このドキュメントはドライバ独自の動きおよび制限を説明します。ユーザのための唯一のリファレンスとして使われることを想定していません。いかなる場合でも、まずDBIのドキュメントを調べてください。

DBIクラス¶

DBIクラス・メソッド¶

connect

最小限のパラメータでデータベースに接続するには、以下のように書きます：

  $dbh = DBI->connect("dbi:Pg:dbname=$dbname", "", "");

これはローカルにあるデータベース$dbnameに、ユーザの認証なしに接続します。 PostgreSQLのデフォルトには、これで十分です。

以下のconnectステートメントは、すべての使用可能なパラメータを表しています：

  $dbh = DBI->connect("dbi:Pg:dbname=$dbname;host=$host;port=$port;" .
                      "options=$options;tty=$tty", "$username", "$password");

パラメータが未定義であれば、PostgreSQLはまず特定の環境変数を探し、それからハード・コードされたデフォルトを使います:

    パラメータ 環境変数　　　　　    ハード・コードされたデフォルト
    --------------------------------------------------
    dbname     PGDATABASE            現在のユーザID
    host       PGHOST                localhost
    port       PGPORT                5432
    options    PGOPTIONS             ""
    tty        PGTTY                 ""
    username   PGUSER                現在のユーザID
    password   PGPASSWORD            ""

hostが指定されている場合、そのホストのpostmasterは-iオプション (TCP/IPソケット）で開始されている必要があります。

optionパラメータは、Postgresバックエンドのための実行時(runtime)オプションを指定します。よく使われるのは-Bオプションでバッファの数を増加させることです。同様に重要なのは-Fオプションで、これは各トランザクションの後、自動的なfsync()呼び出しを無効にします。さらに詳細なことについては、postgresを参照してください。

ユーザ名とパスワードによる認証のために、適切なエントリがpg_hba.confで作られている必要があります。異なるタイプの認証に付いては、pg_hba.confとpg_passwdを参照して下さい。これら２つのパラメータについて、DBIは空と未定義を区別することに注意してください。DBIは、これらのパラメータが未定義であれば、もしあれば環境変数DBI_USERとDBI_PASSの値で置き換えます。

available_drivers

  @driver_names = DBI->available_drivers;

DBIによって実装されており、ドライバ独自の影響はありません。

data_sources

  @data_sources = DBI->data_sources('Pg');

ドライバはこのメソッドをサポートしています。データベースtemplate1への必要なデータベース接続が、ローカルホストへ、ユーザ認証なしに行われることに注意してください。その他の選択は環境変数PGHOST、DBI_USER、DBI_PASS.を設定することによってのみ可能です。

trace

  DBI->trace($trace_level, $trace_file)

DBIによって実装されており、ドライバ特有の影響はありません。

DBI動的属性¶

共通のメソッドをご覧下さい。

すべてのハンドルに共通のメソッド¶

err

  $rv = $h->err;

DBIで提案されているよう、ドライバによってサポートされています。 connectメソッドでは、これはPQstatusを返します。その他の場合には、これは現在のハンドルのPQresultStatusを返します。

errstr

  $str = $h->errstr;

DBIで提案されているよう、ドライバによってサポートされています。現在のハンドルに関連しているPQerrorMessageを返します。

state

  $str = $h->state;

このドライバは（まだ）stateメソッドをサポートしていません。

trace

  $h->trace($trace_level, $trace_filename);

DBIによって実装されており、ドライバ特有の影響はありません。

trace_msg

  $h->trace_msg($message_text);

DBIによって実装されており、ドライバ特有の影響はありません。

func

このドライバはfuncインターフェースを通してアクセスすることができる各種のドライバ独自の関数をサポートしています：

  $attrs = $dbh->func($table, 'table_attributes');

このメソッドは指定されたテーブルについてのハッシュの配列へのリファレンスを返します：

  NAME        属性名
  TYPE        属性データ型
  SIZE        属性の大きさ (可変長では-1)
  NULLABLE    NULLが可能であるか(nullable)のフラグ
  DEFAULT     デフォルト値
  CONSTRAINT  制約
  PRIMARY_KEY プライマリキーであるか(is_primary_key)のフラグ

  $lobjId = $dbh->func($mode, 'lo_creat');

これは新しくラージ・オブジェクトを作成し、そのオブジェクトIDを返します。 $modeは新しいオブジェクトの異なる属性を記述するビット・マスクです。以下の定数を使ってください：

  $dbh->{pg_INV_WRITE}
  $dbh->{pg_INV_READ}

失敗した場合には、undefを返します。

  $lobj_fd = $dbh->func($lobjId, $mode, 'lo_open');

既存のラージ・オブジェクトをオープンし、後のlo_*で利用するためのオブジェクト記述子を返します。modeのビットについてはlo_createをご覧下さい。失敗したときにはundefを返します。0はオブジェクト記述子としては完全に正しいことに注意してください。

  $nbytes = $dbh->func($lobj_fd, $buf, $len, 'lo_write');

ラージ・オブジェクト$lobj_fdに$bufの$lenバイトを書き込みます。書き込まれたバイト数を返し、失敗したときにはundefを返します。

  $nbytes = $dbh->func($lobj_fd, $buf, $len, 'lo_read');

ラージ・オブジェクト$lobj_fdから$bufに$lenバイト読み込みます。読み込んだバイト数を返し、失敗したときにはundefを返します。

  $loc = $dbh->func($lobj_fd, $offset, $whence, 'lo_lseek');

ラージ・オブジェクト$obj_idでの読み込みあるいは書き込み位置を変更します。現在、$whenceには0（L_SET）だけが指定できます。現在の位置を返し、失敗したときにはundefを返します。

  $loc = $dbh->func($lobj_fd, 'lo_tell');

ラージ・オブジェクト$obj_ｆdでの読み込みあるいは書き込み位置を返します。失敗したときにはundefを返します。

  $lobj_fd = $dbh->func($lobj_fd, 'lo_close');

既にあるラージ・オブジェクトをクローズします。成功すればtrue、失敗すればfalseを返します。

  $lobj_fd = $dbh->func($lobj_fd, 'lo_unlink');

既存のラージ・オブジェクトを削除します。成功すればtrue、失敗すれば falseを返します。

  $lobjId = $dbh->func($filename, 'lo_import');

UNIXファイルをラージ・オブジェクトとしてインポートし、新しいオブジェクトのオブジェクトIDを返します。失敗したときにはundefを返します。

  $ret = $dbh->func($lobjId, 'lo_export', 'filename');

ラージ・オブジェクトをUNIXファイルにエキスポートします。失敗すればfalseを、そうでなければtrueを返します。

  $ret = $dbh->func($line, 'putline');

単発のinsertコマンドを使ったオーバーヘッドなく、テーブルに大量のデータをコピーするために、SQL-コマンド 'COPY table FROM STDIN' と一緒に使われます。アプリケーションは、そのデータの送信が完了したことをバックエンドに示すため明示的に"\."という2文字を送信しなければいけません。この関数の使い方の例についてはtest.plをご覧ください。

  $ret = $dbh->func($buffer, length, 'getline');

テーブル全体をダンプするために、SQL-コマンド 'COPY table TO STDOUT'と一緒に使われます。この関数の使い方の例についてはtest.plをご覧ください。

  $ret = $dbh->func('pg_notifies');

undefあるいは、非同期通知を受け取る[ $table, $backend_pid ]という２つの要素の配列へのリファレンスを返します。

  $fd = $dbh->func('getfd');

サーバーへの実際の接続のfdを返します。select() と func('pg_notifies')と一緒に使うことができます。

すべてのハンドルに共通の属性¶

Warn (boolean, inherited): DBIによって実装されており、ドライバ特有の影響はありません。
Active (boolean, read-only): DBIで提案されているように、ドライバによってサポートされています。データベース・ハンドルは、それが接続されていればアクティブであり、ステートメント・ハンドルはそれがfinishするまではアクティブです。
Kids (integer, read-only): DBIによって実装されており、ドライバ特有の影響はありません。
ActiveKids (integer, read-only): DBIによって実装されており、ドライバ特有の影響はありません。
CachedKids (hash ref): DBIによって実装されており、ドライバ特有の影響はありません。
CompatMode (boolean, inherited): このドライバでは使われません。
InactiveDestroy (boolean): DBIによって実装されており、ドライバ特有の影響はありません。
PrintError (boolean, inherited): DBIによって実装されており、ドライバ特有の影響はありません。
RaiseError (boolean, inherited): DBIによって実装されており、ドライバ特有の影響はありません。
HandleError (boolean, inherited): DBIによって実装されており、ドライバ特有の影響はありません。
ChopBlanks (boolean, inherited): DBIで提案されているように、ドライバによってサポートされています。このメソッドはSQL関数RTRIMと同じです。
LongReadLen (integer, inherited): DBIによって実装されており、ドライバ特有の影響はありません。
LongTruncOk (boolean, inherited): DBIによって実装されており、ドライバ特有の影響はありません。
Taint (boolean, inherited): DBIによって実装されており、ドライバ特有の影響はありません。
private_*: DBIによって実装されており、ドライバ特有の影響はありません。

DBIデータベース・ハンドル・オブジェクト¶

データベース・ハンドル・メソッド¶

selectrow_array

  @row_ary = $dbh->selectrow_array($statement, \%attr, @bind_values);

DBIによって実装されており、ドライバ特有の影響はありません。

selectrow_arrayref

  $ary_ref = $dbh->selectrow_arrayref($statement, \%attr, @bind_values);

DBIによって実装されており、ドライバ特有の影響はありません。

selectrow_hashref

  $hash_ref = $dbh->selectrow_hashref($statement, \%attr, @bind_values);

DBIによって実装されており、ドライバ特有の影響はありません。

selectall_arrayref

  $ary_ref = $dbh->selectall_arrayref($statement, \%attr, @bind_values);

DBIによって実装されており、ドライバ特有の影響はありません。

selectall_hashref

  $hash_ref = $dbh->selectall_hashref($statement, $key_field);

DBIによって実装されており、ドライバ特有の影響はありません。

selectcol_arrayref

  $ary_ref = $dbh->selectcol_arrayref($statement, \%attr, @bind_values);

DBIによって実装されており、ドライバ特有の影響はありません。

prepare

  $sth = $dbh->prepare($statement, \%attr);

PostgreSQLはステートメントをprepareするという概念を持っていません。このためprepareメソッドは単にプレースホルダをチェックしたあとに、そのステートメントを格納するだけです。prepareした後、利用可能なステートメントに関する情報はありません。

prepare_cached

  $sth = $dbh->prepare_cached($statement, \%attr);

DBIによって実装されており、ドライバ特有の影響はありません。このメソッドは、ステートメントをprepareすることが、データベースとの相互関係を持っていないために、このドライバにとっては有効ではありません。

do

  $rv  = $dbh->do($statement, \%attr, @bind_values);

DBIによって実装されており、ドライバ特有の影響はありません。このドキュメントの別の場所にあるexecuteメソッドの注意をご覧下さい。

commit

  $rc  = $dbh->commit;

DBIで提案されているように、ドライバによってサポートされています。このドキュメントの別の場所にあるトランザクションについての注意もご覧下さい。

rollback

  $rc  = $dbh->rollback;

disconnect

  $rc  = $dbh->disconnect;

DBIで提案されているように、ドライバによってサポートされています。

ping

  $rc = $dbh->ping;

このドライバはpingメソッドをサポートしています、これはデータベース・ハンドルの妥当性をチェックするために使うことができます。pingメソッドは空の問い合わせを発行し、結果ステータスをチェックします。

table_info

  $sth = $dbh->table_info;

DBIで提案されているように、ドライバによってサポートされています。このメソッドは、現在のユーザによって所有されているすべてのテーブルとビューを返します。インデックスとシーケンスはセレクトしません。同様にシステムテーブルもセレクトされません。TABLE_QUALIFIERと同様に、reltype属性が返され、REMARKSは未定義です。

foreign_key_info

  $sth = $dbh->foreign_key_info( $pk_catalog, $pk_schema, $pk_table,
                                 $fk_catalog, $fk_schema, $fk_table );

DBIで提案されているように、ドライバによってサポートされています。 Postgresサーバー 7.3以前では実装されていません(undefを返します）。現在は複数カラムのキーの先頭のカラムについての情報だけを返します。

tables

  @names = $dbh->tables;

DBIで提案されているように、ドライバによってサポートされています。このメソッドは、現在のユーザによって所有されているすべてのテーブルとビューを返します。インデックスとシーケンスはセレクトしません。同様にシステムテーブルもセレクトされません。

type_info_all

  $type_info_all = $dbh->type_info_all;

DBIで提案されているように、ドライバによってサポートされています。 SQLデータ型と、よく使われるデータ型の情報だけが提供されます。 PostgreSQL型名とSQL92データ型（可能であれば）とのマッピングは以下の表のように行われます：

        +---------------+------------------------------------+
        | データ型名    | SQL92                              |
        |---------------+------------------------------------|
        | bool          | BOOL                               |
        | text          | /                                  |
        | bpchar        | CHAR(n)                            |
        | varchar       | VARCHAR(n)                         |
        | int2          | SMALLINT                           |
        | int4          | INT                                |
        | int8          | /                                  |
        | money         | /                                  |
        | float4        | FLOAT(p)   p<7=float4, p<16=float8 |
        | float8        | REAL                               |
        | abstime       | /                                  |
        | reltime       | /                                  |
        | tinterval     | /                                  |
        | date          | /                                  |
        | time          | /                                  |
        | datetime      | /                                  |
        | timespan      | TINTERVAL                          |
        | timestamp     | TIMESTAMP                          |
        +---------------+------------------------------------+

PostgreSQL特有のデータ型に関する、さらに詳細についてはpgbuiltinをお読みください。

type_info

  @type_info = $dbh->type_info($data_type);

DBIによって実装されており、ドライバ特有の影響はありません。

quote

  $sql = $dbh->quote($value, $data_type);

このモジュールはそれ自身のquoteメソッドを実装しています。DBIメソッドに加えて、 PostgreSQLがバックスラッシュをエスケープ文字として扱うのでバックスラッシュも二重化します。

注意: 公式にはSQL_BINARYデータ型のドキュメント化されていない（そして不正な）サポートは反対されています。代わりにbind_param()で PG_BYTEAを使ってください:

  $rv = $sth->bind_param($param_num, $bind_value,
                         { pg_type => DBD::Pg::PG_BYTEA });

データベース・ハンドル属性¶

AutoCommit (boolean)

DBIで提案されているように、ドライバによってサポートされています。 DBIの分類に従えば、PostgreSQLはトランザクションが明示的に開始されなければならないデータベースです。トランザクションを開始しなければ、すべての変更はそのまま永続化します。AutoCommitのデフォルトはオンで、これはPostgreSQLのデフォルトの動きに対応しています。AutoCommitをオフにすると、トランザクションは開始され、各コミットまたはロールバックが自動的に新しいトランザクションを開始します。詳細については、このドキュメントのトランザクションをご覧ください。

Driver (handle)

DBIによって実装されており、ドライバ特有の影響はありません。

Name (string, read-only)

DBIのデフォルトのメソッドはドライバ独自のメソッドで置き換えられています。それはデータベース名だけを返します。接続文字列からのそれ以外のものは、すべて切り捨てられます。このメソッドはDBI仕様に反して、読み込みのみであることに注意してください。

RowCacheSize (integer)

DBIによって実装されており、ドライバによって使われていません。.

pg_auto_escape (boolean)

PostgreSQL独自の属性。もしTrueであれば、すべてのパラメータのクォートとバックスラッシュは以下のような方法でエスケープされます:

  クォートはquote(SQL)でエスケープ
  バックスラッシュはバックシュラッシュでエスケープ

デフォルトはオンです。PostgreSQLはクォートも受け付けることに注意してください。それらはバックスラッシュでエスケープされます。他のASCIIは文字列定数で直接使うことができます。

pg_enable_utf8 (boolean)

PostgreSQL独自の属性。もしtrueであれば、（もしデータが正しいutf8であれば）返される文字データのためのutf8フラグが設定されます。utf8フラグの詳細については、Encodeをご覧ください。これはperl 5.8以上にもに関連があります。

NB: This attribute is experimental and may be subject to change.

pg_INV_READ (integer, read-only)

lo_creat と lo_openでのモードとして使われる定数。

pg_INV_WRITE (integer, read-only)

lo_creat と lo_openでのモードとして使われる定数。

DBI ステートメント・ハンドル・オブジェクト¶

ステートメント・ハンドル・メソッド¶

bind_param

  $rv = $sth->bind_param($param_num, $bind_value, \%attr);

DBIで提案されているように、ドライバによってサポートされています。

注意: SQL_BINARYSQLデータ型のドキュメント化されていない（そして不正な）サポートは公式には反対されています。代わりに PG_BYTEAを使ってください:

  $rv = $sth->bind_param($param_num, $bind_value,
                         { pg_type => DBD::Pg::PG_BYTEA });

bind_param_inout

このドライバではサポートされていません。

execute

  $rv = $sth->execute(@bind_values);

DBIで提案されているように、ドライバによってサポートされています。 'UPDATE', 'DELETE', 'INSERT' ステートメントという、常に影響を受けた行を返すものに加えて、executeメソッドを'SELECT ... INTO table' ステートメントのためにも使うことができます。

fetchrow_arrayref

  $ary_ref = $sth->fetchrow_arrayref;

DBIで提案されているように、ドライバによってサポートされています。

fetchrow_array

  @ary = $sth->fetchrow_array;

DBIで提案されているように、ドライバによってサポートされています。

fetchrow_hashref

  $hash_ref = $sth->fetchrow_hashref;

DBIで提案されているように、ドライバによってサポートされています。

fetchall_arrayref

  $tbl_ary_ref = $sth->fetchall_arrayref;

DBIによって実装されており、ドライバ特有の影響はありません。

finish

  $rc = $sth->finish;

DBIで提案されているように、ドライバによってサポートされています。

rows

  $rv = $sth->rows;

DBIで提案されているように、ドライバによってサポートされています。他の多くのドライバとは異なり、ステートメントを実行した直後に行の数が利用可能です。

bind_col

  $rc = $sth->bind_col($column_number, \$var_to_bind, \%attr);

DBIで提案されているように、ドライバによってサポートされています。

bind_columns

  $rc = $sth->bind_columns(\%attr, @list_of_refs_to_vars_to_bind);

DBIで提案されているように、ドライバによってサポートされています。

dump_results

  $rows = $sth->dump_results($maxlen, $lsep, $fsep, $fh);

DBIによって実装されており、ドライバ特有の影響はありません。

blob_read

  $blob = $sth->blob_read($id, $offset, $len);

DBI実装によって提案されているようにドライバがサポートしています。 DBIによって実装されていますが、ドキュメントにはありません。そのため、このメソッドは変更されるかもしれません。

このメソッドはOracleでのblobの現在の実装によって大きな影響を受けているように見えます。それでもできる限り互換性を保つようにします。blobがテーブルに関連し、テーブルは１つしかblobを持つことができない(データ型LONG)という制限によって Oracleは苦しめられていますが、PostgreSQLは、いわゆるオブジェクト識別子を使うことによって、そのblobを各テーブルとは独立に扱います。これにより、なぜblob_readメソッドがSTATEMENTパッケージに入れられ、DATABASEパッケージの一部でなかったかを説明できます。fieldパラメータ（訳者注：idの間違い？）はこのオブジェクト識別子を扱うために使われています。offsetとlenパラメータは、ドライバが一度にblob全体を取り出す場合には、0にすることができます。

PostgreSQL-6.5で開始すると、blobへのすべてのアクセスはトランザクションのなかで行わなければなりません。これは読み込みのみのアクセスでも維持されます。

funcインターフェースを通して利用できるblob関連のPostgreSQL特有の関数もご覧ください。

blobについてのさらに詳細な情報と例は、PostgreSQLプログラマーズ・ガイドのラージ・オブジェクト(Large Object)の章を読んでください

ステートメント・ハンドル属性¶

NUM_OF_FIELDS (integer, read-only): DBIによって実装されており、ドライバ特有の影響はありません。
NUM_OF_PARAMS (integer, read-only): DBIによって実装されており、ドライバ特有の影響はありません。
NAME (array-ref, read-only): DBIで提案されているように、ドライバによってサポートされています。
NAME_lc (array-ref, read-only): DBIによって実装されており、ドライバ特有の影響はありません。
NAME_uc (array-ref, read-only): DBIによって実装されており、ドライバ特有の影響はありません。
TYPE (array-ref, read-only): DBIで提案されているようにドライバがサポートしています。国際標準に対応しないPostgreSQL特有のデータ型は、制限されます。
PRECISION (array-ref, read-only): このドライバはサポートしていません。
SCALE (array-ref, read-only): このドライバはサポートしていません。
NULLABLE (array-ref, read-only): このドライバはサポートしていません。
CursorName (string, read-only): このドライバはサポートしていません。このドキュメントでのカーソルについての注意をご覧ください。
Statement (string, read-only): DBIで提案されているように、ドライバによってサポートされています。
RowCache (integer, read-only): このドライバはサポートしていません。
pg_size (array-ref, read-only): PostgreSQL独自の属性。各カラムの整数値の配列へのリファレンスを返します。整数値はカラムのバイトでの大きさをあらわします。可変長のカラムは-1であらわされます。
pg_type (hash-ref, read-only): PostgreSQL独自の属性。各カラムのための文字列の配列へのリファレンスを返します。文字列はデータ型の名前を表します。
pg_oid_status (integer, read-only): PostgreSQL独自の属性。最後のINSERTコマンドのOIDを返します。
pg_cmd_status (integer, read-only): PostgreSQL特有の属性。最後のコマンドのタイプを返します。可能なタイプは以下のものがあります： INSERT, DELETE, UPDATE, SELECT.

詳細な情報¶

トランザクション¶

トランザクションの動きは、今やAutoCommit属性で制御されます。AutoCommitの完全な定義はDBIのドキュメントを参照してください。

DBIの仕様にしたがって、AutoCommitのデフォルトはTRUEです。このモードでは、データベースへのいかなる変更もすぐに適用されます。 'begin', 'commit' または 'rollback' ステートメントは、すべて拒否されます。

AutoCommitがオフであれば、トランザクションは'begin'ステートメントを発行することによって直ちに開始されます。'commit'や'rollback'は新しいトランザクションを開始します。disconnectは'rollback'ステートメントを発行します。

ラージ・オブジェクト¶

ドライバは、funcインターフェースを通したlibpqによって実行される関数に関連する全てのラージ・オブジェクト(large-object)をサポートします。PostgreSQL 6.5からであることにどうぞご注意ください。ラージ・オブジェクトへのアクセスは−たとえ読みこみのみであっても−トランザクションの中でなければなりません。

カーソル¶

PostgreSQLはカーソルという概念を持っていますが、現在の実装ではこれは使われていません。PostgreSQLでのカーソルはトランザクション・ブロックの内側でのみ使うことができます。一時には１つのトランザクション・ブロックだけが許されるので、これは暗黙のうちに、ネストしたSELECTステートメントの使用が制限されます。このためexecuteメソッドはすべてのデータをフロント・エンド・アプリケーションに置かれるデータ構造体に取り出します。これは大量のデータをセレクトするときに注意しなければなりません！

データ型 bool¶

PostgreSQLの現在の実装は、trueならば't'、falseならば'f'を返します。 Perlの視点からはどちらかといえば不幸な選択です。DBD-Pgモジュールはデータ型 boolの結果をPerl的な方法：'f'-> '0'、't'->'1' に変換します。この方法では Perlは'0'をfalseに'1'をtrueに扱うため、データ型boolのためにデータベース特有の戻り値をチェックする必要がありません。

ブール値はPostgreSQLに、 trueとしてTRUE,'t', 'true', 'y', 'yes' あるいは '1'で、 falseとしてFALSE, 'f', 'false', 'n', 'no' あるいは '0'で渡すことができます。

スキーマ・サポート¶

PostgreSQLバージョン7.3はスキーマ・サポートを堂給しました。PostgreSQLスキーマの概念は他のデータベースとは違うかもしれないことに注意してください。さらなる詳細についてはPostgreSQLドキュメントを参照してください。

現在、DBD::PgはPostgreSQLスキーマの明確なサポートを提供していません。しかしスキーマの機能は、スキーマ・オブジェクトについて明示的に記述する何も制限なく使うことが出来ます。例えば

  my $res = $dbh->selectall_arrayref("SELECT * FROM my_schema.my_table");

あるいはSET search_pathでスキーマ検索パスを扱うことによって、例えば

  $dbh->do("SET search_path TO my_schema, public");

注意: (pg_catalogスキーマに含まれているような)PostgreSQLシステム・オブジェクトと同じ名前のオブジェクトを生成し、明示的に検索パスをpg_calalogが新しいオブジェクトのスキーマの後に来るよう設定すると、いくつかのDBD::Pgメソッド（特にPostgreSQLシステムオブジェクトを問い合わせるようなもの）は失敗するかもしれません。この問題はDBD::Pgの将来のリリースでは修正されるはずです。システム・オブジェクトと同じ名前を持った（あるいは'pg_'で始まる）オブジェクトの生成は、推奨されませんし、いかなる場合であっても避けるべきです。

参考資料¶

DBI

作者¶

DBI and DBD-Oracle by Tim Bunce ([email protected])

DBD-Pg by Edmund Mergl ([email protected]) and Jeffrey W. Baker ([email protected]). By David Wheeler <[email protected]>, Jason Stewart <[email protected]> and Bruce Momjian <[email protected]> after v1.13.

Major parts of this package have been copied from DBI and DBD-Oracle.

著作権(=COPYRIGHT)¶

The DBD::Pg module is free software. You may distribute under the terms of either the GNU General Public License or the Artistic License, as specified in the Perl README file.

謝辞¶

DBI/ACKNOWLEDGMENTSをご覧ください。