用於golang database/sql 的PostgreSQL驅動
Go Version Support
PostgreSQL Version Support
安裝
go get github.com/blusewang/pg
使用
db, err := sql.Open("pg", "postgresql://user:password@host_name/database_name?application_name=app_name")
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/....
特性
-
在
Scan()
時,對null
值寬容。不推薦使用sql.Null
系列類型,接受null
值!- 以字符串字段的
null
值爲例:向Scan()
中傳string
型的變量,得到""
,傳*string
型的變量,得到nil
。
- 以字符串字段的
- 常見
Array
類型直接兼容golang的數組類型。如PG的:integer[]
,對應golang的:[]int64
-
數據源格式,既支持鍵值對,又支持URI。書寫格式遵守:PG官方規範。
- URI格式,支持
pg://
前綴。 - 其中用戶名、端口、主機名,在數據源中未指定時,有默認值。用戶名默認爲操作系統當前用戶的用戶名
- URI格式,支持
-
積極標記並緩存所有預備語句[包括
db.Query
、db.Exec
、db.Prepare()
等的語句],遇到相同的語句請求時,自動複用。這能提高1倍的執行速度!!!- 爲了發揮好此功能,需要最大可能地允許數據庫連接空閒。
- 配置上推薦將
sql.SetMaxIdleConns(x)
、sql.SetMaxOpenConns(x)
兩處的x設置爲相同的值!
協議實現
- 此驅動更適合服務於Web
狀態 | 功能 | 備註 |
---|---|---|
<ul><li>- [x] </li></ul> | 啓動 | 必備,實現:無密碼,明文密碼和md5密碼三種認證 |
<ul><li>- [x] </li></ul> | 簡單查詢 | 必備 |
<ul><li>- [x] </li></ul> | 擴展查詢 | 必備 |
<ul><li>- [x] </li></ul> | 取消正在處理的請求 | 必備 |
<ul><li>- [x] </li></ul> | 終止 | 必備 |
<ul><li>- [ ] </li></ul> | 函數調用 | PG官方推薦使用查詢去調用函數 |
<ul><li>- [ ] </li></ul> | SASL 認證 | 不常用 |
<ul><li>- [ ] </li></ul> | 異步操作 | 不常用 |
<ul><li>- [ ] </li></ul> | COPY操作 | 不常用 |
<ul><li>- [ ] </li></ul> | SSL會話加密 | 低效 |