GORM 官方支持的数据库类型有: MySQL, PostgreSQL, SQlite, SQL Server

MySQL

  1. import (
  2. "gorm.io/driver/mysql"
  3. "gorm.io/gorm"
  4. )
  5. func main() {
  6. // 参考 https://github.com/go-sql-driver/mysql#dsn-data-source-name 获取详情
  7. dsn := "user:pass@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local"
  8. db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
  9. }

注意:

想要 Gorm 正确的处理 time.Time ,您需要带上 parseTime 参数。 (查看更多参数)

想要支持完整的 UTF-8 编码,您需要将 charset=utf8 更改为 charset=utf8mb4。 查看 此文章 获取详情

MySQl 驱动程序提供了 一些高级配置 可以在初始化过程中使用,例如:

  1. db, err := gorm.Open(mysql.New(mysql.Config{
  2. DSN: "gorm:gorm@tcp(127.0.0.1:3306)/gorm?charset=utf8&parseTime=True&loc=Local", // DSN data source name
  3. DefaultStringSize: 256, // string 类型字段的默认长度
  4. DisableDatetimePrecision: true, // 禁用 datetime 精度,MySQL 5.6 之前的数据库不支持
  5. DontSupportRenameIndex: true, // 重命名索引时采用删除并新建的方式,MySQL 5.7 之前的数据库和 MariaDB 不支持重命名索引
  6. DontSupportRenameColumn: true, // 用 `change` 重命名列,MySQL 8 之前的数据库和 MariaDB 不支持重命名列
  7. SkipInitializeWithVersion: false, // 根据版本自动配置
  8. }), &gorm.Config{})

PostgreSQL

  1. import (
  2. "gorm.io/driver/postgres"
  3. "gorm.io/gorm"
  4. )
  5. dsn := "user=gorm password=gorm dbname=gorm port=9920 sslmode=disable TimeZone=Asia/Shanghai"
  6. db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{})

我们使用 pgx 作为 postgres 的 database/sql 驱动器,默认情况下,它会启用 prepared statement 缓存,你可以这样禁用它:

  1. // https://github.com/go-gorm/postgres
  2. db, err := gorm.Open(postgres.New(postgres.Config{
  3. DSN: "user=gorm password=gorm dbname=gorm port=9920 sslmode=disable TimeZone=Asia/Shanghai",
  4. PreferSimpleProtocol: true, // 禁用隐式 prepared statement
  5. }), &gorm.Config{})

SQLite

  1. import (
  2. "gorm.io/driver/sqlite"
  3. "gorm.io/gorm"
  4. )
  5. // github.com/mattn/go-sqlite3
  6. db, err := gorm.Open(sqlite.Open("gorm.db"), &gorm.Config{})

注意: 您也可以使用 file::memory:?cache=shared 替代文件路径。 这会告诉 SQLite 在系统内存中使用一个临时数据库。 (查看 SQLite 文档 获取详情)

SQL Server

  1. import (
  2. "gorm.io/driver/sqlserver"
  3. "gorm.io/gorm"
  4. )
  5. // github.com/denisenkom/go-mssqldb
  6. dsn := "sqlserver://gorm:LoremIpsum86@localhost:9930?database=gorm"
  7. db, err := gorm.Open(sqlserver.Open(dsn), &gorm.Config{})

Microsoft 为 GO (GORM) 使用 SQL Server 提供了 一份指南

连接池

GORM 使用 database/sql 来维护连接池

  1. sqlDB, err := db.DB()
  2. // SetMaxIdleConns 设置空闲连接池中连接的最大数量
  3. sqlDB.SetMaxIgleConns(10)
  4. // SetMaxOpenConns 设置打开数据库连接的最大数量
  5. sqlDB.SetMaxOpenConns(100)
  6. // SetConnMaxLifetime 设置了连接可复用的最大时间
  7. sqlDB.SetConnMaxLifetime(time.Hour)

查看 通用接口 获取详情。

不支持的数据库

有些数据库可能兼容 mysqlpostgres 的方言,在这种情况下,你可以直接使用这些数据库的方言。

对于其它不支持的数据,我们鼓励且欢迎大家伙开发更多数据库类型的驱动!