golang mysql資料庫基本操作筆記
mysql目前來說是使用最為流行的關係型資料庫,在程式設計過程中得到廣泛應用。golang操作mysql使用最多的包go-sql-driver/mysql。sqlx包是作為database/sql包的一個額外擴充套件包,在原有的database/sql加了很多擴充套件,如直接將查詢的資料轉為結構體,大大簡化了程式碼書寫,當然database/sql包中的方法同樣起作用。
github地址:
https://github.com/go-sql-driver/mysql
https://github.com/jmoiron/sqlx
golang sql使用:
database/sql documentation go-database-sql tutorial
安裝
go get "github.com/go-sql-driver/mysql"
go get "github.com/jmoiron/sqlx"
連線資料庫
var Db *sqlx.DB
db, err := sqlx.Open("mysql","username:[email protected](ip:port)/database?charset=utf8")
Db = db
處理型別(Handle Types)
sqlx設計和database/sql使用方法是一樣的。包含有4中主要的handle types:
sqlx.DB - 和sql.DB相似,表示資料庫。 sqlx.Tx - 和sql.Tx相似,表示事物。 sqlx.Stmt - 和sql.Stmt相似,表示prepared statement。 sqlx.NamedStmt - 表示prepared statement(支援named parameters)
所有的handler types都提供了對database/sql的相容,意味著當你呼叫sqlx.DB.Query時,可以直接替換為sql.DB.Query.這就使得sqlx可以很容易的加入到已有的資料庫專案中。
此外,sqlx還有兩個cursor型別:
sqlx.Rows - 和sql.Rows類似,Queryx返回。
sqlx.Row - 和sql.Row類似,QueryRowx返回。
相比database/sql方法還多了新語法,也就是實現將獲取的資料直接轉換結構體實現。
Get(dest interface{}, …) error Select(dest interface{}, …) error
建表
以下所有示例均已以下表結構作為操作基礎。
CREATE TABLE `userinfo` (
`uid` INT(10) NOT NULL AUTO_INCREMENT,
`username` VARCHAR(64) DEFAULT NULL,
`password` VARCHAR(32) DEFAULT NULL,
`department` VARCHAR(64) DEFAULT NULL,
`email` varchar(64) DEFAULT NULL,
PRIMARY KEY (`uid`)
)ENGINE=InnoDB DEFAULT CHARSET=utf8
Exec使用
Exec和MustExec從連線池中獲取一個連線然後只想對應的query操作。對於不支援ad-hoc query execution的驅動 ,在操作執行的背後會建立一個prepared statement。在結果返回前這個connection會返回到連線池中。
需要注意的是不同的資料庫型別使用的佔位符不同,mysql採用?作為佔位符號。
MySQL 使用?
PostgreSQL 使用1,1,2等等
SQLite 使用?或$1
Oracle 使用:name
Exec增刪改示例
查詢語法使用Query後續會提到
package main
import (
_ "github.com/go-sql-driver/mysql"
"github.com/jmoiron/sqlx"
"fmt"
)
var Db *sqlx.DB
func init() {
db,err:=sqlx.Open("mysql","username:[email protected](ip:port)/database?charset=utf8")
if err != nil {
fmt.Println("open mysql failed,", err)
return
}
Db = db
}
func main() {
result, err := Db.Exec("INSERT INTO userinfo (username, password,department,email) VALUES (?, ?,?,?)","TigerwolfC","666666","it","[email protected]")
if err != nil{
fmt.Println("insert failed,error: ", err)
return
}
id,_ := result.LastInsertId()
fmt.Println("insert id is :",id)
_, err1 := Db.Exec("update userinfo set username = ? where uid = ?","chen_peggy",1)
if err1 != nil{
fmt.Println("update failed error:",err1)
} else {
fmt.Println("update success!")
}
_, err2 := Db.Exec("delete from userinfo where uid = ? ", 1)
if err2 != nil{
fmt.Println("delete error:",err2)
}else{
fmt.Println("delete success")
}
}
//insert id is : 1
//update success!
//delete success
sql預宣告(Prepared Statements)
對於大部分的資料庫來說,當一個query執行的時候,在sql語句資料庫內部宣告已經宣告過了,其宣告是在資料庫中,我們可以提前進行宣告,以便在其他地方重用。
stmt, err := db.Prepare(`SELECT * FROM place WHERE telcode=?`)
row = stmt.QueryRow(65)
tx, err := db.Begin()
txStmt, err := tx.Prepare(`SELECT * FROM place WHERE telcode=?`)
row = txStmt.QueryRow(852)
當然sqlx還提供了Preparex()進行擴充套件,可直接用於結構體轉換
stmt, err := db.Preparex(`SELECT * FROM place WHERE telcode=?`)
var p Place
err = stmt.Get(&p, 852)
Query
Query是database/sql中執行查詢主要使用的方法,該方法返回row結果。Query返回一個sql.Rows物件和一個error物件。
在使用的時候應該吧Rows當成一個遊標而不是一系列的結果。儘管資料庫驅動快取的方法不一樣,通過Next()迭代每次獲取一列結果,對於查詢結果非常巨大的情況下,可以有效的限制記憶體的使用,Scan()利用reflect把sql每一列結果對映到go語言的資料型別如string,[]byte等。如果你沒有遍歷完全部的rows結果,一定要記得在把connection返回到連線池之前呼叫rows.Close()。
Query返回的error有可能是在server準備查詢的時候發生的,也有可能是在執行查詢語句的時候發生的。例如可能從連線池中獲取一個壞的連級(儘管資料庫會嘗試10次去發現或建立一個工作連線)。一般來說,錯誤主要由錯誤的sql語句,錯誤的類似匹配,錯誤的域名或表名等。
在大部分情況下,Rows.Scan()會把從驅動獲取的資料進行拷貝,無論驅動如何使用快取。特殊型別sql.RawBytes可以用來從驅動返回的資料總獲取一個zero-copy的slice byte。當下一次呼叫Next的時候,這個值就不在有效了,因為它指向的記憶體已經被驅動重寫了別的資料。
Query使用的connection在所有的rows通過Next()遍歷完後或者呼叫rows.Close()後釋放。
示例:
package main
import (
_ "github.com/go-sql-driver/mysql"
"github.com/jmoiron/sqlx"
"fmt"
)
var Db *sqlx.DB
func init() {
db, err := sqlx.Open("mysql", "user:[email protected](localhost:3306)/dbname?charset=utf8")
if err != nil {
fmt.Println("open mysql failed,", err)
return
}
Db = db
}
func main() {
rows, err := Db.Query("SELECT username,password,email FROM userinfo")
if err != nil{
fmt.Println("query failed,error: ", err)
return
}
for rows.Next() { //迴圈結果
var username,password,email string
err = rows.Scan(&username, &password, &email)
println(username,password,email)
}
}
// TigerwolfC 666666 [email protected]
// chen_peggy 888888 [email protected]
Queryx
Queryx和Query行為很相似,不過返回一個sqlx.Rows物件,支援擴充套件的scan行為,同時可將對資料進行結構體轉換。
示例:
package main
import (
_ "github.com/go-sql-driver/mysql"
"github.com/jmoiron/sqlx"
"fmt"
)
var Db *sqlx.DB
type stu struct {
Username string `db:"username"`
Password string `db:"password"`
Department string `db:"department"`
Email string `db:"email"`
}
func init() {
db, err := sqlx.Open("mysql", "user:[email protected](localhost:3306)/dbname?charset=utf8")
if err != nil {
fmt.Println("open mysql failed,", err)
return
}
Db = db
}
func main() {
rows, err := Db.Queryx("SELECT username,password,email FROM userinfo")
if err != nil{
fmt.Println("Qeryx failed,error: ", err)
return
}
for rows.Next() { //迴圈結果
var stu1 stu
err = rows.StructScan(&stu1)// 轉換為結構體
fmt.Println("stuct data:",stu1.Username,stu1.Password)
}
}
//stuct data: TigerwolfC 666666
//stuct data: chen_peggy 888888
QueryRow和QueryRowx
QueryRow和QueryRowx都是從資料庫中獲取一條資料,但是QueryRowx提供scan擴充套件,可直接將結果轉換為結構體。
package main
import (
_ "github.com/go-sql-driver/mysql"
"github.com/jmoiron/sqlx"
"fmt"
)
var Db *sqlx.DB
type stu struct {
Username string `db:"username"`
Password string `db:"password"`
Department string `db:"department"`
Email string `db:"email"`
}
func init() {
db, err := sqlx.Open("mysql", "user:[email protected](localhost:3306)/dbname?charset=utf8")
if err != nil {
fmt.Println("open mysql failed,", err)
return
}
Db = db
}
func main() {
row := Db.QueryRow("SELECT username,password,email FROM userinfo where uid = ?",1) // QueryRow返回錯誤,錯誤通過Scan返回
var username,password,email string
err :=row.Scan(&username,&password,&email)
if err != nil{
fmt.Println(err)
}
fmt.Printf("this is QueryRow res:[%s:%s:%s]\n",username,password,email)
var s stu
err1 := Db.QueryRowx("SELECT username,password,email FROM userinfo where uid = ?",2).StructScan(&s)
if err1 != nil{
fmt.Println("QueryRowx error :",err1)
}else {
fmt.Printf("this is QueryRowx res:%v",s)
}
}
//this is QueryRow res:[TigerwolfC:666666:[email protected]]
//this is QueryRowx res:{chen_peggy 888888 [email protected]}
Get 和Select(非常常用)
Get和Select是一個非常省時的擴充套件,可直接將結果賦值給結構體,其內部封裝了StructScan進行轉化。Get用於獲取單個結果然後Scan,Select用來獲取結果切片。
示例:
package main
import (
_ "github.com/go-sql-driver/mysql"
"github.com/jmoiron/sqlx"
"fmt"
)
var Db *sqlx.DB
type stu struct {
Username string `db:"username"`
Password string `db:"password"`
Department string `db:"department"`
Email string `db:"email"`
}
func init() {
db, err := sqlx.Open("mysql", "user:[email protected](localhost:3306)/dbname?charset=utf8")
if err != nil {
fmt.Println("open mysql failed,", err)
return
}
Db = db
}
func main() {
var stus []stu
err := Db.Select(&stus,"SELECT username,password,email FROM userinfo")
if err != nil{
fmt.Println("Select error",err)
}
fmt.Printf("this is Select res:%v\n",stus)
var s stu
err1 := Db.Get(&s,"SELECT username,password,email FROM userinfo where uid = ?",2)
if err1 != nil{
fmt.Println("GET error :",err1)
}else {
fmt.Printf("this is GET res:%v",s)
}
}
//this is Select res:[{TigerwolfC 666666 [email protected]} {chen_peggy 888888 [email protected]}]
//this is GET res:{chen_peggy 888888 [email protected]}
事務(Transactions)
事務操作是通過三個方法實現:
Begin():開啟事務
Commit():提交事務(執行sql)
Rollback():回滾
使用流程:
tx, err := db.Begin()
err = tx.Exec(...)
err = tx.Commit()
//或者使用sqlx擴充套件的事務
tx := db.MustBegin()
tx.MustExec(...)
err = tx.Commit()
由於事務是一個一直連線的狀態,所以Tx物件必須繫結和控制單個連線。一個Tx會在整個生命週期中儲存一個連線,然後在呼叫commit或Rollback()的時候釋放掉。在呼叫這幾個函式的時候必須十分小心,否則連線會一直被佔用直到被垃圾回收。
使用示例:
package main
import (
_ "github.com/go-sql-driver/mysql"
"github.com/jmoiron/sqlx"
"fmt"
)
var Db *sqlx.DB
func init() {
db, err := sqlx.Open("mysql", "user:[email protected](localhost:3306)/dbname?charset=utf8")
if err != nil {
fmt.Println("open mysql failed,", err)
return
}
Db = db
}
func main() {
tx, err := Db.Beginx()
_, err = tx.Exec("insert into userinfo(username,password) values(?,?)", "Rose","2223")
if err != nil {
tx.Rollback()
}
_, err = tx.Exec("insert into userinfo(username,password) values(?,?)", "Mick",222)
if err != nil {
fmt.Println("exec sql error:",err)
tx.Rollback()
}
err = tx.Commit()
if err != nil {
fmt.Println("commit error")
}
}
連線池設定
預設情況下,連線池增長無限制,並且只要連線池中沒有可用的空閒連線,就會建立連線。我們可以使用DB.SetMaxOpenConns設定池的最大大小。未使用的連線標記為空閒,如果不需要則關閉。要避免建立和關閉大量連線,可以使用DB.SetMaxIdleConns設定最大空閒連線。
DB.SetMaxIdleConns(n int) 設定最大空閒連線數
DB.SetMaxOpenConns(n int) 設定最大開啟的連線數
示例:
package main
import (
_ "github.com/go-sql-driver/mysql"
"github.com/jmoiron/sqlx"
"fmt"
)
var Db *sqlx.DB
func init() {
db, err := sqlx.Open("mysql", "user:[email protected](localhost:3306)/dbname?charset=utf8")
if err != nil {
fmt.Println("open mysql failed,", err)
return
}
Db = db
Db.SetMaxOpenConns(30)
Db.SetMaxIdleConns(15)
Db.Ping()
}
如有不對歡迎指正,相互學習,共同進步。 參考連線