beego框架 ORM 数据库连接设置

在 beego 框架中,model 主要利用 ORM 进行数据库操作。ORM 是指对象-关系映射,在 Go 语言中就是将 struct数据类型和数据库记录进行映射。

本章介绍 beego ORM 数据库连接相关设置。

1. beego支持的数据库类型

目前 ORM 支持三种数据库,分别是:

  • mysql
  • sqlite3
  • Postgres

使用不通的数据库,需要导入不通的数据库驱动:

import (
    // 导入mysql驱动
    _ "github.com/go-sql-driver/mysql"
    // 导入sqlite3驱动
    _ "github.com/mattn/go-sqlite3"
    // 导入Postgres驱动
    _ "github.com/lib/pq"
)

根据需要导入自己想要的驱动即可。

2. mysql数据库连接

这里介绍mysql数据库的详细链接参数,要想连接mysql数据库,首先得注册一个数据库,在调用查询函数会自动创建连接。

ORM 必须注册一个别名为 default 的数据库,作为默认使用的数据库。

注册数据库的函数原型:

func RegisterDataBase(aliasName, driverName, dataSource string, params ...int) error

参数说明

参数名说明
aliasName数据库的别名,用来在 ORM 中切换数据库使用
driverName驱动名字
dataSource数据库连接字符串
params附加参数

例子:

// 注册默认数据库,驱动为mysql, 第三个参数就是我们的数据库连接字符串。
orm.RegisterDataBase("default", "mysql", "root:123456@tcp(localhost:3306)/tizi?charset=utf8")

mysql数据库连接字符串DSN (Data Source Name)详解:

格式:

username:password@protocol(address)/dbname?param=value

参数说明

参数名说明
username数据库账号
password数据库密码
protocol连接协议,一般就是tcp
address数据库地址,可以包含端口。例: localhost:3306 , 127.0.0.1:3306
dbname数据库名字
param=value最后面问号(?)之后可以包含多个键值对的附加参数,多个参数之间用&连接。

常用附加参数说明:

参数名默认值说明
charsetnone设置字符集,相当于 SET NAMES <value> 语句
locUTC设置时区,可以设置为Local,表示根据本地时区走
parseTimefalse是否需要将 mysql的 DATE 和 DATETIME 类型值转换成GO的time.Time类型。
readTimeout0I/O 读超时时间, sql查询超时时间. 单位 ("ms", "s", "m", "h"), 例子: "30s", "0.5m" or "1m30s".
timeout0连接超时时间,单位("ms", "s", "m", "h"), 例子: "30s", "0.5m" or "1m30s".

例子:

root:123456@(123.180.11.30:3306)/tizi?charset=utf8&timeout=5s&loc=Local&parseTime=true

3. 数据库连接池设置

数据库连接词参数主要有下面两个:

1) SetMaxIdleConns

根据数据库的别名,设置数据库的最大空闲连接:

orm.SetMaxIdleConns("default", 20)

2) SetMaxOpenConns

根据数据库的别名,设置数据库的最大数据库连接

orm.SetMaxOpenConns("default", 100)

14 数据库调试模式

打开调试模式,当执行 orm 查询的时候,会打印出对应的 sql 语句。

orm.Debug = true

下一章:beego框架 高级查询

beego ORM 高级查询:针对业务比较复杂,涉及复杂的查询条件的场景,beego orm为我们提供了QuerySeter 对象,用来组织复杂的查询条件。