Go语言从入门到精通 -【web项目实战篇】- MySQL的初始化

本节核心内容

• 介绍链接MySQL有哪些必备条件
• 介绍Mysql配置文件的配置规则
• 介绍如何连接数据库
• 讲解在初始化时的注意事项和常见问题

本小节视频教程和代码：百度网盘

可先下载视频和源码到本地，边看视频边结合源码理解后续内容，边学边练。

简介

Golang 提供了database/sql包用于对SQL数据库的访问, 作为操作数据库的入口对象sql.DB, 主要为我们提供了两个重要的功能:

• sql.DB 通过数据库驱动为我们提供管理底层数据库连接的打开和关闭操作.
• sql.DB 为我们管理数据库连接池

需要注意的是，sql.DB表示操作数据库的抽象访问接口,而非一个数据库连接对象;它可以根据driver打开关闭数据库连接，管理连接池。正在使用的连接被标记为繁忙，用完后回到连接池等待下次使用。所以，如果你没有把连接释放回连接池，会导致过多连接使系统资源耗尽。

导入MySQL数据库驱动

import (
   "database/sql"
   _ "github.com/go-sql-driver/mysql"
)

通常来说, 不应该直接使用驱动所提供的方法, 而是应该使用 sql.DB, 因此在导入 mysql 驱动时, 这里使用了匿名导入的方式(在包路径前添加 _), 当导入了一个数据库驱动后, 此驱动会自行初始化并注册自己到Golang的database/sql上下文中, 因此我们就可以通过 database/sql 包提供的方法访问数据库了.

MySQL配置文件规则

在使用MySQL之前，我们需要先来进行一些配置

mysql:
  #最大空闲连接数
  max_idle_conns: 50
  #链接
  source_name: root:root@tcp(127.0.0.1:3306)/test?parseTime=true&charset=utf8&loc=Local

它的配置规则如下:

 账号:密码@tcp(IP:端口号)/数据库名?parseTime=true&charset=utf8&loc=Local

在有了正确的配置文件后，我们就可以通过读取配置文件来进行MySQL的初识化工作，从而使程序能链接访问MySQL数据库。

连接数据库

package model

import (
	"database/sql"
	"log"

	"mysql/config"

	_ "github.com/go-sql-driver/mysql" //这个引用是必不可少的，因为需要调用driver.go文件里的init方法来提供一个数据库驱动程序
	"github.com/spf13/viper"
)

var DB *sql.DB     //全局变量，这样可以在别处调用

func Init() *sql.DB {

	var err error
	//加载配置文件
	config.Init()

	//这行代码的作用就是初始化一个sql.DB对象
	DB ,err = sql.Open("mysql", viper.GetString("mysql.source_name"))
	if nil != err {
		panic(err)
	}

	//设置最大超时时间
	DB.SetMaxIdleConns(viper.GetInt("mysql.max_idle_conns"))

	//建立链接
	err = DB.Ping()
	if nil != err{
		panic(err)
	}else{
		log.Println("Mysql Startup Normal!")
	}
	return DB
}

在看完上边的代码之后，是不是感觉很简单，总结上面代码我们可以发现，我们想建立一个MySQL链接只需要以下这四步：

• 导入_ "github.com/go-sql-driver/mysql"进行数据库驱动的注册
• 读取配置信息，调用sql.Open初始化一个DB对象
• 对DB对象进行属性设置
• 调用DB.Ping()方法测试链接是否通畅

注意事项

Open()函数

在上面的代码中，我们通过调用sql.Open函数返回一个sql.DB指针; sql.Open函数原型如下:

func Open(driverName, dataSourceName string) (*DB, error)

参数为：

• driverName: 使用的驱动名. 这个名字其实就是数据库驱动注册到 database/sql 时所使用的名字.
• dataSourceName: 数据库连接信息，这个连接包含了数据库的用户名, 密码, 数据库主机以及需要连接的数据库名等信息.

注意事项

1. sql.Open并不会立即建立一个数据库的网络连接, 也不会对数据库链接参数的合法性做检验, 它仅仅是初始化一个sql.DB对象. 当真正进行第一次数据库查询操作时, 此时才会真正建立网络连接;
2. sql.DB表示操作数据库的抽象接口的对象，但不是所谓的数据库连接对象，sql.DB对象只有当需要使用时才会创建连接，如果想立即验证连接，需要用Ping()方法;
3. sql.Open返回的sql.DB对象是协程并发安全的.
4. sql.DB的设计就是用来作为长连接使用的。不要频繁Open, Close。比较好的做法是，为每个不同的datastore建一个DB对象，保持这些对象Open。如果需要短连接，那么把DB作为参数传入function，而不要在function中Open, Close。

Mysql日期时间类型报错

sql: Scan error on column index 1: unsupported Scan, storing driver.Value type []uint8 into type *time.Time

原因是在调用sql.Open()时没有将parseTime设置为True。加入parseTime即可修复问题：

db, err := sql.Open(“mysql”, “user:password@tcp(127.0.0.1:3306)/dbname?parseTime=true”)

小节

本小节主要演示了在Go语言中，如何去编写MySQL配置文件和对MySQL的初始化链接，以及讲解了在初见数据库链接时的一些注意事项。