Name
connect -- データベースサーバへの接続を開始する
Synopsis
connect([dbname], [host], [port], [opt], [tty], [user], [passwd])
引数
- dbname
接続するデータベース名(文字列/None)
- host
サーバホスト名(文字列/None)
- port
データベースサーバによって使用されているポート番号(整数/-1)
- opt
サーバのオプション(文字列/None)
- tty
バックエンドからのオプショナルなデバッグ出力用ファイル、またはtty(文字列/None)
- user
PostgreSQLユーザ(文字列/None)
- passwd
ユーザのパスワード(文字列/None)
返り値
- pgobject
成功した場合、データベース接続を管理しているオブジェクトが返る
例外
- TypeError
型が合わない、もしくは引数が多過ぎ
- SyntaxError
引数定義の複製
- pg.error
データベース接続定義の際にエラー発生
すべての例外はオブジェクト配置に関連しています。
説明
このメソッドでは与えられたPostgreSQLサーバでの
特定のデータベースとの接続を開始します。Pythonの
チュートリアルで説明されているキーワードを使用することができます。
キーワード名は、シンタックスの行で与えられた引数名となります。
引数に関するより詳細な説明はPostgreSQLの
ユーザマニュアルを参照して下さい。
例
import pg
con1 = pg.connect('testdb', 'myhost', 5432, None, None, 'bob', None)
con2 = pg.connect(dbname='testdb', host='localhost', user='bob')