pg

用于golang database/sql 的PostgreSQL驱动

Go Version Support

PostgreSQL Version Support

特性

• Scan() 时允许传入指针，完美对应数据库中的null
• 所有查询全部自动prepare并缓存。
• 支持pg://前缀的URI
• 支持Listen式的异步消息订阅

安装

go get github.com/blusewang/pg/v2

使用

通用查询

sql.Register("pg", pg.Driver{})
db, err := sql.Open("pg", "pg://user:password@dbhost.yourdomain.com/database_name?application_name=app_name&sslmode=verify-full")
if err != nil {
return err
}
defer db.Close()
rows, err := db.Query("select * from table_name where id>$1", 0)
if err != nil {
return err
}
...

异步订阅

    l, err := pg.NewListener("pg://user:password@dbhost.yourdomain.com/database_name?application_name=app_name&sslmode=verify-full")
if err != nil {
return
}

if err := l.Listen("channel_name")); err != nil {
return
}
go func () {
time.Sleep(time.Minute)
_ = l.Terminate()
}()
for {
pid, channel, message, err := l.GetNotification()
if err == io.EOF {
return err
} else if err != nil {
return err
}
log.Println(pid, channel, message)
}

文档

更多的细节及使用示例，参见： https://pkg.go.dev/github.com/blusewang/pg/v2.

配置要求

• 配置上需将sql.SetMaxIdleConns(x)、sql.SetMaxOpenConns(x)两处的x设置为相同的值，才能让缓存实现价值。

协议实现

• 本驱动是为Web服务而设计

状态	功能	备注
	启动	支持：无密码、明文密码、md5、SCRAM-SHA-256
	简单查询	必备
	扩展查询	必备
	取消正在处理的请求	必备
	终止	必备
	SSL会话加密	远程安全
	异步	listen/notify
	copy	支持

暂不支持SCRAM-SHA-256-PLUS。当pg_hba.conf使用：

hostssl all             all             0.0.0.0/0               scram-sha-256 clientcert=verify-full

时，Server会发类型为SCRAM-SHA-256-PLUS类型的请求。此时客户端将自动降级至SCRAM-SHA-256。

License