go get github.com/jinzhu/gorm
import _ "github.com/go-sql-driver/mysql"
import _ "github.com/jinzhu/gorm/dialects/mysql"
import (
"github.com/jinzhu/gorm"
_ "github.com/jinzhu/gorm/dialects/mysql"
)
func main () {
db, err := gorm.Open("mysql", "user:password@(127.0.0.1:3306)/dbname?charset=utf8&parseTime=True&loc=Local")
if err != nil {
panic(err)
}
}
模型(Models)通常只是正常的golang structs、基本的go类型或它们的指针。同时也支持sql.Scanner及driver.Valuer接口(interfaces)。
type User struct { // 表名默认使用结构体名称的复数 users
gorm.Model // 嵌入gorm.Model gorm.Model 是一个包含了ID,CreatedAt,UpdatedAt,DeletedAt四个字段的go结构体
Name string `gorm:"column:username;comment:'用户名'"` // 使用tag标记 column 定义字段的名称 使用tag标记 comment 定义字段注释
Age sql.NullInt64 `gorm:"comment:'年龄'"`
Birthday *time.Time `gorm:"comment:'生日'"`
Email string `gorm:"comment:'邮箱';unique_index;type:varchar(100)"` // 使用tag标记 type 定义字段类型和索引 使用tag标记 unique_index 设置唯一索引
Role string `gorm:"size:255;comment:'角色'"` // 使用tag标记 size 设置字段大小为255
MemberNumber *string `gorm:"unique;not null;comment:'会员卡号'"` // 使用tag标记 unique 设置唯一 使用tag标记 not null 设置字段属性不为空
Num int `gorm:"AUTO_INCREMENT;comment:'数量'"` // 使用tag标记 AUTO_INCREMENT 设置字段自增
Addres string `gorm:"index:addr;comment:'地址'"` // 使用tag标记 index 设置索引名为addr的普通索引
Ignore int `gorm:"-"` // 使用tag标记 - 忽略该字段
}
标记(tags)在声明模型时是可选项。
结构体标记(Tag) | 描述 |
---|---|
Column | 指定列名 |
Type | 指定列数据类型 |
Size | 指定列大小,默认值255 |
PRIMARY_KEY | 将列指定为主键 |
UNIQUE | 将列指定为唯一 |
DEFAULT | 指定列默认值 |
PRECISION | 指定列精度 |
NOT NULL | 将列指定为非NULL |
AUTO_INCREMENT | 指定列是否为自增类型 |
INDEX | 创建具有或不带名称的索引,如果多个索引同名则创建复合索引 |
UNIQUE_INDEX | 和INDEX类似,只不过创建的是唯一索引 |
EMBEDDED | 将结构设置为嵌入 |
EMBEDDED_PREFIX | 设置嵌入结构的前缀 |
- | 忽略此字段 |
补充: COMMENT 字段注释