The fantastic ORM library for Golang aims to be developer friendly.

特性

  • 全功能 ORM
  • 关联 (Has One，Has Many，Belongs To，Many To Many，多态，单表继承)
  • Create，Save，Update，Delete，Find 中钩子方法
  • 支持 Preload、Joins 的预加载
  • 事务，嵌套事务，Save Point，Rollback To Saved Point
  • Context、预编译模式、DryRun 模式
  • 批量插入，FindInBatches，Find/Create with Map，使用 SQL 表达式、Context Valuer 进行 CRUD
  • SQL 构建器，Upsert，数据库锁，Optimizer/Index/Comment Hint，命名参数，子查询
  • 复合主键，索引，约束
  • Auto Migration
  • 自定义 Logger
  • 灵活的可扩展插件 API：Database Resolver（多数据库，读写分离）、Prometheus…
  • 每个特性都经过了测试的重重考验
  • 开发者友好

安装

  1. go get -u gorm.io/gorm
  2. go get -u gorm.io/driver/sqlite

快速入门

  1. package main
  3. import (
  4.   "gorm.io/gorm"
  5.   "gorm.io/driver/sqlite"
  6. )
  8. type Product struct {
  9.   gorm.Model
  10.   Code  string
  11.   Price uint
  12. }
  14. func main() {
  15.   db, err := gorm.Open(sqlite.Open("test.db"), &gorm.Config{})
  16.   if err != nil {
  17.     panic("failed to connect database")
  18.   }
  20.   // 迁移 schema
  21.   db.AutoMigrate(&Product{})
  23.   // Create
  24.   db.Create(&Product{Code: "D42", Price: 100})
  26.   // Read
  27.   var product Product
  28.   db.First(&product, 1) // 根据整型主键查找
  29.   db.First(&product, "code = ?", "D42") // 查找 code 字段值为 D42 的记录
  31.   // Update - 将 product 的 price 更新为 200
  32.   db.Model(&product).Update("Price", 200)
  33.   // Update - 更新多个字段
  34.   db.Model(&product).Updates(Product{Price: 200, Code: "F42"}) // 仅更新非零值字段
  35.   db.Model(&product).Updates(map[string]interface{}{"Price": 200, "Code": "F42"})
  37.   // Delete - 删除 product
  38.   db.Delete(&product, 1)
  39. }