PG Driver

作者 bluse wang 日期 2019-07-11
PG Driver

pg driver for golang

  • 用于golang database/sql 的PostgreSQL驱动

GoDoc
license

Go Version Support

Go version

PostgreSQL Version Support

PostgreSQL version
PostgreSQL version

安装

go get github.com/blusewang/pg

使用

1
2
3
4
5
6
7
8
9
10
11

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 bluse where id>$1", 0)
if err != nil {
return err
}
...

文档

更多的细节及使用示例,参见: https://godoc.org/github.com/blusewang/pg.

特性

  • 送入Scan()处理null值时支持传指针类型的指针!!
  • 常见Array类型直接兼容golang的数组类型。如PG的:integer[],对应golang的:[]int64
  • 数据源格式,既支持键值对,又支持URI。书写格式遵守:PG官方规范
    • URI格式,支持pg://前缀。
    • 其中用户名、端口、主机名,在数据源中未指定时,有默认值。用户名默认为操作系统当前用户的用户名
    • DSN配置中,strict项是独立于PG后端之外的。它默认为true
      • 若置为false;在遇到null值时,宽容处理。例:向Scan()中传 string型的指针,得到 "",传 *string型的指针,得到 ""
  • 积极标记并缓存所有预备语句[包括db.Querydb.Execdb.Prepare()等的语句],遇到相同的语句请求时,自动复用。这能提高1倍的执行速度!!!
    • 为了发挥好此功能,需要最大可能地允许数据库连接空闲。
    • 配置上推荐将sql.SetMaxIdleConns(x)sql.SetMaxOpenConns(x)两处的x设置为相同的值!

协议实现

  • 此驱动更适合服务于Web
状态 功能 备注
OK 启动 必备,实现:无密码,明文密码和md5密码三种认证
OK 简单查询 必备
OK 扩展查询 必备
OK 取消正在处理的请求 必备
OK 终止 必备
OK SSL会话加密 远程安全