psycopg2.connect()
功能描述
此方法创建新的数据库会话并返回新的connection对象。
原型
import os
conn=psycopg2.connect(dbname="test",user=os.getenv('user'),password=os.getenv('password'),host="127.0.0.1",port="5432")
参数
|
关键字 |
参数说明 |
|---|---|
|
dbname |
数据库名称。 |
|
user |
用户名。 |
|
password |
密码。 |
|
host |
数据库IP地址，默认为UNIX socket类型。 |
|
port |
连接端口号，默认为5432。 |
|
sslmode |
ssl模式，ssl连接时用。 |
|
sslcert |
客户端证书路径，ssl连接时用。 |
|
sslkey |
客户端密钥路径，ssl连接时用。 |
|
sslrootcert |
根证书路径，ssl连接时用。 |
|
hostaddr |
数据库IP地址。 |
|
connect_timeout |
客户端连接超时时间。 |
|
client_encoding |
客户端编码格式。 |
|
application_name |
application_name的参数值。 |
|
fallback_application_name |
application_name参数的回退值。 |
|
keepalives |
控制是否客户端tcp保持连接，默认为1，表示打开；值为0时，表示关闭。若UNIX域套接字连接，则忽略。 |
|
options |
连接开始时发送给服务器的命令行选项。 |
|
keepalives_idle |
控制向服务器发送keepalive消息之前不活动的描述，若keepalive被禁用，则忽略此参数。 |
|
keepalives_interval |
控制未得到服务器确认的keepalive消息应重新传输的描述，若keepalive被禁用，则忽略此参数。 |
|
keepalives_count |
控制客户端与服务端连接断开之前可能丢失的tcp保持连接的数量。 |
|
replication |
确认连接使用的是复制协议而不是普通协议。 |
|
requiressl |
支持sslmode设置。 |
|
sslcompression |
ssl压缩。设置为1，则通过ssl连接发送的数据将被压缩；设置为0，则禁用压缩。若没有建立ssl的连接，则忽略此参数。 |
|
sslcrl |
证书吊销列表文件路径，验证ssl服务端证书是否可用。 |
|
requirepeer |
指定服务器的操作系统用户名。 |
返回值
connection对象（连接GaussDB数据库实例的对象）。
示例
请参见示例：常用操作。
