本文共 10324 字,大约阅读时间需要 34 分钟。
Go语言中的database/sql
包提供了保证SQL或类SQL数据库的泛用接口,并不提供具体的数据库驱动。使用database/sql
包时必须注入(至少)一个数据库驱动。
我们常用的数据库基本上都有完整的第三方实现。
go get -u github.com/go-sql-driver/mysql
func Open(driverName, dataSourceName string) (*DB, error)
Open打开一个dirverName指定的数据库,dataSourceName指定数据源,一般至少包括数据库文件名和其它连接必要的信息。
import ( "database/sql" _ "github.com/go-sql-driver/mysql")func main() { // DSN:Data Source Name dsn := "user:password@tcp(127.0.0.1:3306)/dbname" //user填数据库用户名,password填数据库密码,daname填要连接的数据库名 db, err := sql.Open("mysql", dsn) if err != nil { panic(err) } defer db.Close() // 注意这行代码要写在上面err判断的下面}
sql包内置的Open方法,第一个参数传入数据库类型名,实际上github引入的sql驱动包中init ()函数注册了,我们才能使用。
返回了一个DB数据库对象。db.Ping()可进行链接,验证数据库配置是否正确。
Open函数可能只是验证其参数格式是否正确,实际上并不创建与数据库的连接。如果要检查数据源的名称是否真实有效,应该调用Ping方法。
返回的DB对象可以安全地被多个goroutine并发使用,并且维护其自己的空闲连接池。因此,Open函数应该仅被调用一次,很少需要关闭这个DB对象。
// 定义一个全局对象dbvar db *sql.DB// 定义一个初始化数据库的函数func initDB() (err error) { // DSN:Data Source Name dsn := "root:123456@tcp(127.0.0.1:3306)/test" // 不会校验账号密码是否正确 // 注意!!!这里不要使用:=,我们是给全局变量赋值,然后在main函数中使用全局变量db db, err = sql.Open("mysql", dsn) if err != nil { return err } // 尝试与数据库建立连接(校验dsn是否正确) err = db.Ping() if err != nil { return err } return nil}func main() { err := initDB() // 调用输出化数据库的函数 if err != nil { fmt.Printf("init db failed,err:%v\n", err) return }}
其中sql.DB
是表示连接的数据库对象(结构体实例),它保存了连接数据库相关的所有信息。它内部维护着一个具有零到多个底层连接的连接池,它可以安全地被多个goroutine同时使用。
SetMaxOpenConns
设置与数据库建立连接的最大数目。 如果n大于0且小于最大闲置连接数,会将最大闲置连接数减小到匹配最大开启连接数的限制。 如果n<=0,不会限制最大开启连接数,默认为0(无限制)。
先在MySQL中创建一个名为test
的数据库
CREATE DATABASE test;
进入该数据库:
use test;
执行以下命令创建一张用于测试的数据表:
CREATE TABLE `user` ( `id` BIGINT(20) NOT NULL AUTO_INCREMENT, `name` VARCHAR(20) DEFAULT '', `age` INT(11) DEFAULT '0', PRIMARY KEY(`id`))ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4;
为了方便查询,我们事先定义好一个结构体来存储user表的数据。
type user struct { id int age int name string}
单行查询
单行查询db.QueryRow()
执行一次查询,并期望返回最多一行结果(即Row)。QueryRow总是返回非nil的值,直到返回值的Scan方法被调用时,才会返回被延迟的错误。(如:未找到结果)
func (db *DB) QueryRow(query string, args ...interface{ }) *Row
数据库信息如下:
func query(param int ) { var u user //1.写SQL语句 sqlStr := "select id,name ,age from user where id=?" //执行SQL,查询单行数据,根据sql语句的顺序赋值 rowObj :=db.QueryRow(sqlStr,param) err :=rowObj.Scan(&u.id,&u.name,&u.age) if err != nil { fmt.Printf("query failed,err:%v\n", err) return } fmt.Printf("id:%d name:%s age:%d\n", u.id, u.name, u.age)}
多行查询
多行查询db.Query()
执行一次查询,返回多行结果(即Rows),一般用于执行select命令。参数args表示query中的占位参数。
func (db *DB) Query(query string, args ...interface{ }) (*Rows, error)
具体示例代码:
// 查询多条数据示例func queryMultiRowDemo() { sqlStr := "select id, name, age from user where id > ?" rows, err := db.Query(sqlStr, 0) if err != nil { fmt.Printf("query failed, err:%v\n", err) return } // 非常重要:关闭rows释放持有的数据库链接 defer rows.Close() // 循环读取结果集中的数据 for rows.Next() { var u user err := rows.Scan(&u.id, &u.name, &u.age) if err != nil { fmt.Printf("scan failed, err:%v\n", err) return } fmt.Printf("id:%d name:%s age:%d\n", u.id, u.name, u.age) }}
插入、更新和删除操作都使用Exec
方法。
func (db *DB) Exec(query string, args ...interface{ }) (Result, error)
Exec执行一次命令(包括查询、删除、更新、插入等),返回的Result是对已执行的SQL命令的总结。参数args表示query中的占位参数。
具体插入数据示例代码如下:
func Insert(name string, age int) { sqlStr := `insert into user(name,age) values(?,?)` ret,err:=db3.Exec(sqlStr,name,age) if err != nil { fmt.Printf("insert failed, err:%v\n", err) return } Id, err := ret.LastInsertId() 新插入数据的id if err != nil { fmt.Printf("get lastinsert ID failed, err:%v\n", err) return } fmt.Printf("insert success, the id is %d.\n", Id)}
更新,删除时,ret.RowsAffected() 返回影响的行数
func update(id int,name string ,age int) { sqlStr := `update user set name=?,age=? where id=? ` ret ,err :=db3.Exec(sqlStr,name,age,id) if err != nil { fmt.Printf("update failed, err:%v\n", err) return } n, err :=ret.RowsAffected() // 操作影响的行数 if err != nil { fmt.Printf("ret.RowsAffected( failed, err:%v\n", err) return } fmt.Printf("update success, Affected roes is %d.\n", n)}
func Delete(id int) { sqlStr := `delete from user where id=?` ret ,err :=db3.Exec(sqlStr,id) if err != nil { fmt.Printf("Delete failed, err:%v\n", err) return } n, err :=ret.RowsAffected() // 操作影响的行数 if err != nil { fmt.Printf("ret.RowsAffected( failed, err:%v\n", err) return } fmt.Printf("Delete success, Affected roes is %d.\n", n)}
什么是预处理?
普通SQL语句执行过程:
预处理执行过程:
为什么要预处理?
database/sql
中使用下面的Prepare
方法来实现预处理操作。
func (db *DB) Prepare(query string) (*Stmt, error)
Prepare
方法会先将sql语句发送给MySQL服务端,返回一个准备好的状态用于之后的查询和命令。返回值可以同时执行多个查询和命令。
查询操作的预处理示例代码如下:
func prepareQueryDemo() { sqlStr := "select id, name, age from user where id > ?" stmt, err := db.Prepare(sqlStr) if err != nil { fmt.Printf("prepare failed, err:%v\n", err) return } defer stmt.Close() rows, err := stmt.Query(0) if err != nil { fmt.Printf("query failed, err:%v\n", err) return } defer rows.Close() for rows.Next(){ var u user err := rows.Scan(&u.id, &u.name, &u.age) if err != nil { fmt.Printf("scan failed, err:%v\n", err) return } fmt.Printf("id:%d name:%s age:%d\n", u.id, u.name, u.age) }}
插入、更新和删除操作的预处理十分类似,这里以插入操作的预处理为例:
import ( "database/sql" "fmt" _ "github.com/go-sql-driver/mysql" "test/mysql/test/mysqlInit" "time")var db *sql.DBfunc prepareInsertDemo() { sqlStr := `insert into user(name,age) values(?,?)` stmt ,err := db.Prepare(sqlStr) //返回对象 if err != nil { fmt.Printf("prepare failed, err:%v\n", err) return } start := time.Now() for i:=0;i<300 ;i++ { _, err := stmt.Exec("guo",i) if err != nil { fmt.Printf("insert failed, err:%v\n", err) return } } fmt.Println(time.Since(start)) //404.6629ms}func main() { var err error db, err = mysqlInit.InitDB() if err != nil { fmt.Printf("connected mysql failed, err:%v\n", err) return } prepareInsertDemo()}
对比原生的每次执行SQL语句
func prepareInsertDemo() { sqlStr := `insert into user(name,age) values(?,?)` start := time.Now() for i:=0;i<300 ;i++ { _, err := db.Exec(sqlStr,"guo",i) if err != nil { fmt.Printf("insert failed, err:%v\n", err) return } } fmt.Println(time.Since(start)) //435.3734ms}
时间上效率高了一点
什么是事务?
事务:一个最小的不可再分的工作单元;通常一个事务对应一个完整的业务(例如银行账户转账业务,该业务就是一个最小的工作单元),同时这个完整的业务需要执行多次的DML(insert、update、delete)语句共同联合完成。A转账给B,这里面就需要执行两次update操作。
在MySQL中只有使用了Innodb
数据库引擎的数据库或表才支持事务。事务处理可以用来维护数据库的完整性,保证成批的SQL语句要么全部执行,要么全部不执行。
Go语言中使用以下三个方法实现MySQL中的事务操作。 开始事务
func (db *DB) Begin() (*Tx, error)
提交事务
func (tx *Tx) Commit() error
回滚事务
func (tx *Tx) Rollback() error
下面的代码演示了一个简单的事务操作,该事物操作能够确保两次更新操作要么同时成功要么同时失败,不会存在中间状态。
import ( "database/sql" "fmt" _ "github.com/go-sql-driver/mysql" "test/mysql/test/mysqlInit")var db *sql.DB// 事务操作示例func transactionDemo() { tx, err := db.Begin() // 开启事务 if err != nil { if tx != nil { tx.Rollback() // 回滚 } fmt.Printf("begin trans failed, err:%v\n", err) return } sqlStr1 := "Update user set age=age+2 where id=?" ret1, err := tx.Exec(sqlStr1, 1) if err != nil { tx.Rollback() // 回滚 fmt.Printf("exec sql1 failed, err:%v\n", err) return } affRow1, err := ret1.RowsAffected() if err != nil || affRow1 ==0 { tx.Rollback() // 回滚 fmt.Printf("exec ret1.RowsAffected() failed, err:%v\n", err) return } sqlStr2 := "Update user set age=age-2 where id=?" ret2, err := tx.Exec(sqlStr2, 3) if err != nil { tx.Rollback() // 回滚 fmt.Printf("exec sql2 failed, err:%v\n", err) return } affRow2, err := ret2.RowsAffected() if err != nil || affRow2 ==0 { tx.Rollback() // 回滚 fmt.Printf("exec ret1.RowsAffected() failed, err:%v\n", err) return } fmt.Println(affRow1, affRow2) if affRow1 == 1 && affRow2 == 1 { fmt.Println("事务提交啦...") tx.Commit() // 提交事务 } else { tx.Rollback() fmt.Println("事务回滚啦...") } fmt.Println("exec trans success!")}func main() { var err error db, err = mysqlInit.InitDB() if err != nil { fmt.Printf("connected mysql failed, err:%v\n", err) return } transactionDemo()}
我们任何时候都不应该自己拼接SQL语句!
这里我们演示一个自行拼接SQL语句的示例,编写一个根据name字段查询user表的函数如下:
package mainimport ( "database/sql" "fmt" _ "github.com/go-sql-driver/mysql" "test/mysql/test/mysqlInit")type User struct { id int name string age int}var db *sql.DBfunc InjectDemo(name string) { sqlStr := fmt.Sprintf("select id, name, age from user where name='%s'", name) fmt.Printf("SQL:%s\n", sqlStr) // select id, name, age from user where name='xxx' or 1=1#' rows,err :=db.Query(sqlStr) if err != nil { fmt.Printf("query failed, err:%v\n", err) return } defer rows.Close() //千万记得放回连接池 for rows.Next(){ var u User err := rows.Scan(&u.id,&u.name,&u.age) if err != nil { fmt.Printf("scan failed, err:%v\n", err) return } fmt.Printf("id:%d name:%s age:%d\n", u.id, u.name, u.age) }}func main() { var err error db ,err = mysqlInit.InitDB() //工具包下载驱动 if err != nil { fmt.Printf("query failed, err:%v\n", err) return } InjectDemo("xxx' or 1=1#")}
select id, name, age from user where name=’ ’ //等待用户输入name
然后输入 xxx’ or 1=1#
成为select id, name, age from user where name=‘xxx’ or 1=1# ’
恶意拼接,查询不到xxx这个name,而后1=1 恒成立。 #代表注释,后面的内容无效。 造成整个数据库全部输出
转载地址:http://cgcq.baihongyu.com/