01
介绍
beego ORM 是一个强大的 Go 语言 ORM 框架。她的灵感主要来自
Django ORM 和 SQLAlchemy。
已支持的数据库驱动有MySQL、PostgreSQL 和 Sqlite3。
beego v2.x 和 beego v1.x 在 ORM 上的区别是,beego v2.x 的 ORM 对象被设计为无状态的,它是线程安全的,建议大家在使用时,一个数据库只对应一个 ORM 对象。
本文全篇都是以 MySQL 为例。
02
安装
如果您使用的是 beego 框架,beego ORM 已默认安装,如果您没有使用 beego 框架,可使用 go get 安装 beego ORM:
03
注册
注册驱动
参数 1 是驱动名称,参数 2 是驱动类型,需要注意的是,不要忘记导入 MySQL 驱动。
注册数据库
beego ORM 必须注册一个别名为 default 的数据库,作为默认使用。参数 1 是数据库的别名,用来在 ORM 中切换数据库使用,参数 2 是驱动名称,参数 3 是对应的 dataSource。
设置数据库最大空闲连接数
根据数据库的别名,设置数据库的最大空闲连接数。
设置数据库最大连接数
注册模型
注册模型,同时注册多个模型,使用英文逗号分隔。
使用表前缀注册模型
使用表前缀注册模型,同时注册多个模型,使用英文逗号分隔。
注册模型和使用表前缀注册模型,不可同时使用,重复注册模型,会导致成程序 panic。
04
自动建表
默认表名
自定义表名
如果设置了表前缀,自定义表名会在开头拼接上前缀。
自定义存储引擎
默认使用 MySQL 数据库设置的存储引擎,如果您需要在程序中指定存储引擎,可以使用以上方式设置。
设置参数
在结构体中,可以使用 orm 标签设置数据库的属性,限于篇幅,具体使用方法请参考官方手册。
自动建表
参数 1 是数据库别名,参数 2 是布尔类型的 force,参数 3 是布尔类型的 verbose。force 为 true 代表 drop table 后再建表;verbose 为 true 代表打印建表的执行过程。
自动建表功能在 force 为 false 时,会自动创建新增的字段和索引。删除或修改操作,需要用户自行手动处理。
05
新增
单条插入:
Insert 方法插入单条数据,接收参数必须是指针类型,返回值有两个,分别是自增id 和 err。
批量插入:
InsertMulti 方法批量插入数据,参数 1 是批量插入的数量,参数 2 是 slice,参数 1 的值为 1 时,将会按照顺序插入 slice 中的数据。返回值有两个,分别是插入行数和 err。
06
修改
Update 方法更新数据,参数 1 是更新对象,参数 2 是更新的字段,多个字段用英文逗号分隔,默认更新多有字段。返回值有两个,分别是更新行数和err。
07
删除
Delete 方法删除数据,参数是删除对象,返回值有两个,分别是更新行数和 err。
08
总结
本文开篇介绍了 beego ORM 的设计思路和已支持的数据库驱动,并且介绍了 v2 和 v1 的区别,然后详细介绍了 beego ORM 的安装和使用方法。关于更多细节,请参阅官方手册。
参考资料:
https://beego.me/docs