数据库

连接数据库 {#dbc}

要连接到数据库首先要导入驱动程序。例如

  1. import _ "github.com/go-sql-driver/mysql"

为了方便记住导入路径,GORM包装了一些驱动。

  1. import _ "github.com/jinzhu/gorm/dialects/mysql"
  2. // import _ "github.com/jinzhu/gorm/dialects/postgres"
  3. // import _ "github.com/jinzhu/gorm/dialects/sqlite"
  4. // import _ "github.com/jinzhu/gorm/dialects/mssql"

MySQL

注:为了处理time.Time,您需要包括parseTime作为参数。 (更多支持的参数

  1. import (
  2. "github.com/jinzhu/gorm"
  3. _ "github.com/jinzhu/gorm/dialects/mysql"
  4. )
  5. func main() {
  6. db, err := gorm.Open("mysql", "user:password@/dbname?charset=utf8&parseTime=True&loc=Local")
  7. defer db.Close()
  8. }

PostgreSQL

  1. import (
  2. "github.com/jinzhu/gorm"
  3. _ "github.com/jinzhu/gorm/dialects/postgres"
  4. )
  5. func main() {
  6. db, err := gorm.Open("postgres", "host=myhost user=gorm dbname=gorm sslmode=disable password=mypassword")
  7. defer db.Close()
  8. }

Sqlite3

  1. import (
  2. "github.com/jinzhu/gorm"
  3. _ "github.com/jinzhu/gorm/dialects/sqlite"
  4. )
  5. func main() {
  6. db, err := gorm.Open("sqlite3", "/tmp/gorm.db")
  7. defer db.Close()
  8. }

不支持的数据库

GORM正式支持上述的数据库,如果您使用的是不受支持的数据库请按照下面的连接编写对应数据库支持文件。
https://github.com/jinzhu/gorm/blob/master/dialect.go

迁移 {#m}

自动迁移

自动迁移模式将保持更新到最新。

警告:自动迁移仅仅会创建表,缺少列和索引,并且不会改变现有列的类型或删除未使用的列以保护数据。

  1. db.AutoMigrate(&User{})
  2. db.AutoMigrate(&User{}, &Product{}, &Order{})
  3. // 创建表时添加表后缀
  4. db.Set("gorm:table_options", "ENGINE=InnoDB").AutoMigrate(&User{})

检查表是否存在

  1. // 检查模型`User`表是否存在
  2. db.HasTable(&User{})
  3. // 检查表`users`是否存在
  4. db.HasTable("users")

创建表

  1. // 为模型`User`创建表
  2. db.CreateTable(&User{})
  3. // 创建表`users'时将“ENGINE = InnoDB”附加到SQL语句
  4. db.Set("gorm:table_options", "ENGINE=InnoDB").CreateTable(&User{})

删除表

  1. // 删除模型`User`的表
  2. db.DropTable(&User{})
  3. // 删除表`users`
  4. db.DropTable("users")
  5. // 删除模型`User`的表和表`products`
  6. db.DropTableIfExists(&User{}, "products")

修改列

修改列的类型为给定值

  1. // 修改模型`User`的description列的数据类型为`text`
  2. db.Model(&User{}).ModifyColumn("description", "text")

删除列

  1. // 删除模型`User`的description列
  2. db.Model(&User{}).DropColumn("description")

添加外键

  1. // 添加主键
  2. // 1st param : 外键字段
  3. // 2nd param : 外键表(字段)
  4. // 3rd param : ONDELETE
  5. // 4th param : ONUPDATE
  6. db.Model(&User{}).AddForeignKey("city_id", "cities(id)", "RESTRICT", "RESTRICT")

索引

  1. // 为`name`列添加索引`idx_user_name`
  2. db.Model(&User{}).AddIndex("idx_user_name", "name")
  3. // 为`name`, `age`列添加索引`idx_user_name_age`
  4. db.Model(&User{}).AddIndex("idx_user_name_age", "name", "age")
  5. // 添加唯一索引
  6. db.Model(&User{}).AddUniqueIndex("idx_user_name", "name")
  7. // 为多列添加唯一索引
  8. db.Model(&User{}).AddUniqueIndex("idx_user_name_age", "name", "age")
  9. // 删除索引
  10. db.Model(&User{}).RemoveIndex("idx_user_name")