## Tcl9.0.3/Tk9.0.3 Documentation > tdbc::postgres Package Commands, version 1.1.13 > tdbc_postgres

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

  NAME
    tdbc::postgres — TDBC-POSTGRES bridge
  構文 SYNOPSIS
  説明 DESCRIPTION
  接続の指示項目CONNECTION OPTIONS
    -host hostname
    -hostaddr address
    -port number
    -user name
    -passwd password
    -password password
    -database name
    -db name
    -options opts
    -tty file
    -sslmode mode
    -requiressl flag
    -service name
  用例 EXAMPLES
  SEE ALSO
  KEYWORDS
  著作権 COPYRIGHT

### NAME

tdbc::postgres — TDBC-POSTGRES bridge

### 構文 SYNOPSIS

package require tdbc::postgres 1.0

tdbc::postgres::connection create db ?-option value...?
tdbc::postgres::connection new ?-option value...?

### 説明 DESCRIPTION

tdbc::postgres 駆動譜は､Tcl DataBase Connectivity (TDBC)に準拠する基礎データ対話機能を提供し､ Tcl 譜を Postgres 基礎データに接続することを許容する｡　　　　　　　 The tdbc::postgres driver provides a database interface that conforms to Tcl DataBase Connectivity (TDBC) and allows a Tcl script to connect to a Postgres database.

POSTGRES 基礎データへの接続は､tdbc::postgres::connection create を起動し､基礎データ操作子に与えるべき名前と､-option-value 対の群を渡して確立される｡利用できる指示項目は下の CONNECTION OPTIONS の処で列挙されている｡代替法として､tdbc::postgres::connection new が基礎データ接続の作成に使用することができ､名前は自動的に代入される｡ tdbc::postgres::connection new からの戻り値は､接続処理子の為に選択された名前である｡　　　　　　　 Connection to a POSTGRES database is established by invoking tdbc::postgres::connection create, passing it the name to give the database handle and a set of -option-value pairs. The available options are enumerated under CONNECTION OPTIONS below. As an alternative, tdbc::postgres::connection new may be used to create a database connection with an automatically assigned name. The return value from tdbc::postgres::connection new is the name that was chosen for the connection handle.

tdbc::postgres::connection create の副作用は新しい基礎データ接続の生成である｡基礎データの操作をする為に接続を如何に使うかの詳細に関しては tdbc::connection(n) を参照されたい｡　　　　　　　 The side effect of tdbc::postgres::connection create is to create a new database connection.. See tdbc::connection(n) for the details of how to use the connection to manipulate a database.

### 接続の指示項目CONNECTION OPTIONS

tdbc::postgres::connection create 対象 命令は全ての TDBC 駆動譜に共通に -encoding と -isolation と -readonly と -timeout の指示項目を運営している｡-timeout 指示項目は接続操作の課程でのみに効果があり､一たび接続された後は､この値は無視され変更はできない｡　　　　　　　 The tdbc::postgres::connection create object command supports the -encoding, -isolation, -readonly and -timeout options common to all TDBC drivers. The -timeout option will only affect connection process, once connected this value will be ignored and cannot be changed after connecting.

更に､次の指示項目が認識される(これらの指示項目は､最初の接続の生成時に設定しなければならない; それらは接続後は変更できない):　　　　　　　 In addition, the following options are recognized (these options must be set on the initial creation of the connection; they cannot be changed after connecting) :

-host hostname
  hostname によって指定されたホストに接続する｡無為設定は局所 Unix 領域接続対を使った接続である｡ (訳註 socket：接続対 ip番地とポート番号の対)　　　　　　　 Connects to the host specified by hostname. Default is to connect using a local Unix domain socket.

-hostaddr address
  与えられた IP 番地によって指定されたホストに接続する｡もし -host と -hostaddr の両方が与えられると､ -host の値は無視される｡無為設定は局所 Unix 領域接続対を使った接続である｡　　　　　　 Connects to the host specified by given IP address. If both -host and -hostaddr are given, the value of -host is ignored. Default is to connect using a local Unix domain socket.

-port number
  番号によって指定されたポート上に聴取している Postgres 中央集中処理装置に接続する｡ホストかホスト番地が指定されている場合のみ使用される｡　　　　　 Connects to a Postgres server listening on the port specified by number. It is used only when host or hostaddr is specified.

-user name
  使用者の名前として Postgres 中央集中処理装置に名前を与える｡無為設定は現在の使用者識別子である｡　　　　　　 Presents name as the user name to the Postgres server. Default is the current user ID.

-passwd password

-password password
  これら二つの指示項目は類義語である｡これらは､与えられた暗証番号を使用者の暗証番号として Postgres 中央集中処理装置に与える｡無為設定は暗証番号を与えないことである｡　　　　　　 These two options are synonymous. They present the given password as the user's password to the Postgres server. Default is not to present a password.

-database name

-db name
  これら二つの指示項目は類義語である｡これらは､Postgres 問合せの中で使う為に 与えられた名前を無為設定の基礎データの名前として提供する｡指定されない場合は､現在の使用者の為の無為設定の基礎データが使用される｡　　　　　　　 These two options are synonymous. They present the given name as the name of the default database to use in Postgres queries. If not specified, the default database for the current user is used.

-options opts
  これは中央集中処理装置に送る追加の命令行指示項目として opts を設定する｡　　　　　　　 This sets opts as additional command line options send to the server.

-tty file
  この指示項目は 何時も 中央集中処理装置上で無視される｡以前は､これは瑕疵修繕出力の送り先を指定していた｡この指示項目は古い中央集中処理装置との互換性の為に残されている｡　　　　　　　 This option is ignored on never servers. Formerly this specified where to send debug output. This option is left for compatibility with older servers.

-sslmode mode
  この指示項目は､どのような優先的 SSL 接続をするか､またはしないかを中央集中処理装置と取り決める｡四つの様式がある: 不能は非暗号化SSL 接続のみを試みる ;許容は､最初に非-SSL接続を試み､失敗すると､ SSL 接続を試みることを取り決める; 優先(無為設定)は､最初に SSL 接続を試み､もし失敗すると､正規の非-SSL接続を試みることを取決める; 要求 は SSL 接続のみを試みる｡もし PostgreSQL が SSL の運営なしに機械語翻訳されている場合､要求 を指定すると不都合を生じ､許容と優先の指定は許容されているが､駆動譜は SSL 接続の取り決めはできない｡(訳註 SSL（Secure Sockets Layer）はインターネット上の通信を暗号化する技術)　　　　　　　 This option determines whether or with what priority an SSL connection will be negotiated with the server. There are four modes: disable will attempt only an unencrypted SSL connection; allow will negotiate, trying first a non-SSL connection, then if that fails, trying an SSL connection; prefer (the default) will negotiate, trying first an SSL connection, then if that fails, trying a regular non-SSL connection; require will try only an SSL connection. If PostgreSQL is compiled without SSL support, using option require will cause an error, and options allow and prefer will be tolerated but the driver will be unable to negotiate an SSL connection.

-requiressl flag
  この指示項目は -sslmode 設定の支持に反対する｡この flag 値は論理値でなければならない｡もし真値(又はそれに等価な値)であると､駆動譜は､中央集中処理が SSL 接続を受け付けない場合は､接続を拒絶する｡無為設定は偽値(又はそれに等価な値)であり､ -sslmode preffered と同じ振舞いをする｡　　　　　　 This option is deprecated in favor of the -sslmode setting. The flag value must be a Boolean value. If it is true (or any equivalent), driver will then refuse to connect if the server does not accept an SSL connection. The default value is false (or any equivalent), and acts the same like -sslmode preffered

-service name
  追加の接続媒介変数を保有する pg_service.conf ファイル内の役務処理名を指定する｡これにより､応用譜に役務処理名のみの指定を許容し､それ故､接続媒介変数が中心に維持されることが可能になる｡詳細は PostgreSQL 取扱説明書､又は､PREFIX/share/pg_service.conf.sample ファイルを参照されたい｡ 　　　　　　 It specifies a service name in pg_service.conf file that holds additional connection parameters. This allows applications to specify only a service name so connection parameters can be centrally maintained. Refer to PostgreSQL Documentation or PREFIX/share/pg_service.conf.sample file for details.

### 用例 EXAMPLES

    tdbc::postgres::connection -user joe -passwd sesame -db joes_database

局所ホスト上の Postgres 中央集中処理装置に､無為設定の方法を使って接続し､使用者識別子 'joe' と暗証番号 'sesame' を提供する｡ 'joes_database' を無為設定の基礎データ名として使用する｡ 　　　　　　 Connects to the Postgres server on the local host using the default connection method, presenting user ID 'joe' and password 'sesame'. Uses 'joes_database' as the default database name.

### SEE ALSO

tdbc, tdbc::connection, tdbc::resultset, tdbc::statement

### KEYWORDS

TDBC, SQL, Postgres, database, connectivity, connection

### 著作権 COPYRIGHT

Copyright (c) 2009 by Slawomir Cygan