更新时间:2023-10-23 GMT+08:00

psycopg2.connect()

功能描述

此方法创建新的数据库会话并返回新的connection对象。

原型

conn=psycopg2.connect(dbname="test",user="postgres",password="secret",host="127.0.0.1",port="5432")

参数

表1 psycopg2.connect参数

关键字

参数说明

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数据库实例的对象)。

示例

请参见示例:常用操作