1. 程式人生 > >golang mysql資料庫基本操作筆記

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()

}

如有不對歡迎指正,相互學習,共同進步。 參考連線