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

package main

import (
  "context"
  "gorm.io/driver/sqlite"
  "gorm.io/gorm"
)

type Product struct {
  gorm.Model
  Code  string
  Price uint
}

func main() {
  db, err := gorm.Open(sqlite.Open("test.db"), &gorm.Config{})
  if err != nil {
    panic("failed to connect database")
  }

  ctx := context.Background()

  // Migrate the schema
  db.AutoMigrate(&Product{})

  // Create
  err = gorm.G[Product](db).Create(ctx, &Product{Code: "D42", Price: 100})

  // Read
  product, err := gorm.G[Product](db).Where("id = ?", 1).First(ctx) // find product with integer primary key
  products, err := gorm.G[Product](db).Where("code = ?", "D42").Find(ctx) // find product with code D42

  // Update - update product's price to 200
  err = gorm.G[Product](db).Where("id = ?", product.ID).Update(ctx, "Price", 200)
  // Update - update multiple fields
  err = gorm.G[Product](db).Where("id = ?", product.ID).Updates(ctx, map[string]interface{}{"Price": 200, "Code": "F42"})

  // Delete - delete product
  err = gorm.G[Product](db).Where("id = ?", product.ID).Delete(ctx)
}

type User struct {
    ID           uint           // 標(biāo)準(zhǔn)字段，用作主鍵
    Name         string         // 普通字符串字段
    Email        *string        // 指向字符串的指針，允許為空（NULL）
    Age          uint8          // 無符號8位整數(shù)
    Birthday     *time.Time     // 指向時(shí)間的指針，可以為空（NULL）
    MemberNumber sql.NullString // 使用 sql.NullString 來處理可為空的字符串
    ActivatedAt  sql.NullTime   // 使用 sql.NullTime 來處理可為空的時(shí)間字段
    CreatedAt    time.Time      // GORM 自動(dòng)管理的創(chuàng)建時(shí)間
    UpdatedAt    time.Time      // GORM 自動(dòng)管理的更新時(shí)間
    ignored      string         // 未導(dǎo)出的字段會被 GORM 忽略
}

func (User) TableName() string {
    return "user_profiles" // 自定義表名
}

db, _ := gorm.Open(mysql.Open(dsn), &gorm.Config{
    NamingStrategy: schema.NamingStrategy{
        TablePrefix:     "tbl_", // 表名前綴
        SingularTable:   true,   // 使用單數(shù)表名
        NoLowerCase:     false,  // 使用小寫
        NameReplacer:    strings.NewReplacer("ID", "Id"), // 替換特定名稱
    },
})

// gorm.Model 的定義
type Model struct {
  ID        uint           `gorm:"primaryKey"`
  CreatedAt time.Time
  UpdatedAt time.Time
  DeletedAt gorm.DeletedAt `gorm:"index"`
}

package model

import (
    "database/sql"
    "time"

    "gorm.io/gorm"
)

type User struct {
    gorm.Model
    ID           uint           // 標(biāo)準(zhǔn)字段，用作主鍵
    Name         string         // 普通字符串字段
    Email        *string        // 指向字符串的指針，允許為空（NULL）
    Age          uint8          // 無符號8位整數(shù)
    Birthday     *time.Time     // 指向時(shí)間的指針，可以為空（NULL）
    MemberNumber sql.NullString // 使用 sql.NullString 來處理可為空的字符串
    ActivatedAt  sql.NullTime   // 使用 sql.NullTime 來處理可為空的時(shí)間字段
    ignored      string         // 未導(dǎo)出的字段會被 GORM 忽略
}

type User struct {
  Name string `gorm:"<-:create"` // 允許讀和創(chuàng)建
  Name string `gorm:"<-:update"` // 允許讀和更新
  Name string `gorm:"<-"`        // 允許讀和寫（創(chuàng)建和更新）
  Name string `gorm:"<-:false"`  // 允許讀，禁止寫
  Name string `gorm:"->"`        // 只讀（除非有自定義配置，否則禁止寫）
  Name string `gorm:"->;<-:create"` // 允許讀和寫
  Name string `gorm:"->:false;<-:create"` // 僅創(chuàng)建（禁止從 db 讀）
  Name string `gorm:"-"`  // 通過 struct 讀寫會忽略該字段
  Name string `gorm:"-:all"`        // 通過 struct 讀寫、遷移會忽略該字段
  Name string `gorm:"-:migration"`  // 通過 struct 遷移會忽略該字段
}

type Author struct {
  Name  string
  Email string
}

type Blog struct {
  Author
  ID      int
  Upvotes int32
}
// equals
type Blog struct {
  ID      int64
  Name    string
  Email   string
  Upvotes int32
}

type Author struct {
    Name  string
    Email string
}

type Blog struct {
  ID      int
  Author  Author `gorm:"embedded"`
  Upvotes int32
}
// 等效于
type Blog struct {
  ID    int64
  Name  string
  Email string
  Upvotes  int32
}

type Blog struct {
  ID      int
  Author  Author `gorm:"embedded;embeddedPrefix:author_"`
  Upvotes int32
}
// 等效于
type Blog struct {
  ID          int64
  AuthorName string
  AuthorEmail string
  Upvotes     int32
}

import (
  "gorm.io/driver/mysql"
  "gorm.io/gorm"
)

func main() {
  // 參考 https://github.com/go-sql-driver/mysql#dsn-data-source-name 獲取詳情
  dsn := "user:pass@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local"
  db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
}

package main

import (
        "fmt"
        "time"

        "gorm.io/driver/mysql"
        "gorm.io/gorm"
        "gorm.io/gorm/clause"
)

// 定義符合 GORM 約定的 User 模型（嵌入 gorm.Model）
type User struct {
        gorm.Model // 自動(dòng)包含 ID, CreatedAt, UpdatedAt, DeletedAt

        Name         string         `gorm:"size:255"` // 可指定字段長度
        Email        *string        `gorm:"unique"`   // 唯一索引
        Age          uint8          `gorm:"default:18"` // 默認(rèn)值
        Birthday     *time.Time     // 指向時(shí)間的指針
        MemberNumber sql.NullString // 處理可為空的字符串
        ActivatedAt  sql.NullTime   // 處理可為空的時(shí)間字段
        ignored      string         // 未導(dǎo)出字段會被 GORM 忽略
}

func main() {
        // 1. 連接 MySQL 數(shù)據(jù)庫
        dsn := "root:root@tcp(127.0.0.1:3306)/gorm_demo?charset=utf8mb4&parseTime=True&loc=Local"
        db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
        if err != nil {
                panic("數(shù)據(jù)庫連接失敗: " + err.Error())
        }

        // 2. 自動(dòng)遷移（創(chuàng)建表）
        db.AutoMigrate(&User{})

        // 3. 創(chuàng)建操作 (Create)
        fmt.Println("\n=== 創(chuàng)建用戶 ===")
        user1 := User{
                Name:      "張三",
                Email:     &[]string{"zhangsan@example.com"}[0],
                Age:       30,
                Birthday:  &time.Date(1990, 1, 1, 0, 0, 0, 0, time.UTC),
                MemberNumber: sql.NullString{String: "M12345", Valid: true},
                ActivatedAt:  sql.NullTime{Time: time.Now(), Valid: true},
        }
        if err := db.Create(&user1).Error; err != nil {
                panic("創(chuàng)建用戶失敗: " + err.Error())
        }
        fmt.Printf("創(chuàng)建成功! ID: %d\n", user1.ID)

        // 4. 查詢操作 (Read)
        fmt.Println("\n=== 查詢用戶 ===")
        var user2 User
        // 查詢單個(gè)記錄
        if err := db.First(&user2, user1.ID).Error; err != nil {
                panic("查詢用戶失敗: " + err.Error())
        }
        fmt.Printf("查詢到用戶: %s (ID: %d, 年齡: %d)\n", user2.Name, user2.ID, user2.Age)

        // 查詢多個(gè)記錄
        var users []User
        db.Where("age > ?", 25).Find(&users)
        fmt.Printf("年齡大于25的用戶: %d 個(gè)\n", len(users))

        // 使用條件查詢
        var user3 User
        db.Where("name = ?", "張三").First(&user3)
        fmt.Printf("條件查詢: %s (ID: %d)\n", user3.Name, user3.ID)

        // 5. 更新操作 (Update)
        fmt.Println("\n=== 更新用戶 ===")
        user2.Age = 31
        if err := db.Save(&user2).Error; err != nil {
                panic("更新用戶失敗: " + err.Error())
        }
        fmt.Printf("更新成功! 年齡: %d\n", user2.Age)

        // 更新特定字段
        db.Model(&user2).Update("age", 32)
        fmt.Printf("更新特定字段: 年齡: %d\n", user2.Age)

        // 6. 刪除操作 (Delete)
        fmt.Println("\n=== 刪除用戶 ===")
        // 軟刪除（默認(rèn)）
        if err := db.Delete(&user2).Error; err != nil {
                panic("軟刪除失敗: " + err.Error())
        }
        fmt.Printf("軟刪除成功! ID: %d\n", user2.ID)

        // 硬刪除（需要設(shè)置 DeleteMode 為 HardDelete）
        if err := db.Unscoped().Delete(&user2).Error; err != nil {
                panic("硬刪除失敗: " + err.Error())
        }
        fmt.Printf("硬刪除成功! ID: %d\n", user2.ID)

        // 7. 其他常用操作
        fmt.Println("\n=== 其他常用操作 ===")
        // 創(chuàng)建或更新（如果存在則更新，不存在則創(chuàng)建）
        user4 := User{Name: "李四", Age: 25}
        db.FirstOrCreate(&user4, User{Name: "李四"})
        fmt.Printf("創(chuàng)建或更新: %s (ID: %d)\n", user4.Name, user4.ID)

        // 通過 ID 查詢
        var user5 User
        db.First(&user5, 1) // 通過 ID 查詢
        fmt.Printf("通過 ID 查詢: %s\n", user5.Name)

        // 分頁查詢
        var usersPage []User
        db.Limit(2).Offset(0).Find(&usersPage)
        fmt.Printf("分頁查詢: %d 個(gè)用戶\n", len(usersPage))

        // 計(jì)數(shù)
        var count int64
        db.Model(&User{}).Where("age > ?", 25).Count(&count)
        fmt.Printf("年齡大于25的用戶總數(shù): %d\n", count)
}

package main

import (
        "fmt"
        "time"

        "gorm.io/driver/mysql"
        "gorm.io/gorm"
        "gorm.io/gorm/clause"
)

// 自定義表名模型（演示如何指定表名）
type EntityRobot struct {
        ID         uint           `gorm:"primary_key"`
        EntityID   uint           `gorm:"index:idx_entity_biz"`
        BizType    string         `gorm:"size:50;index:idx_entity_biz"`
        Params     map[string]interface{} `gorm:"type:json"` // 使用JSON存儲參數(shù)
        CreatedAt  time.Time
        UpdatedAt  time.Time
}

// 實(shí)現(xiàn)TableName方法指定表名
func (EntityRobot) TableName() string {
        return "entity_robot" // 自定義表名，與數(shù)據(jù)庫表名一致
}

func main() {
        // 1. 數(shù)據(jù)庫連接
        dsn := "root:root@tcp(127.0.0.1:3306)/gorm_demo?charset=utf8mb4&parseTime=True&loc=Local"
        db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
        if err != nil {
                panic("數(shù)據(jù)庫連接失敗: " + err.Error())
        }

        // 2. 自動(dòng)遷移（創(chuàng)建表）
        db.AutoMigrate(&EntityRobot{})

        // 3. 創(chuàng)建測試數(shù)據(jù)
        robot := EntityRobot{
                EntityID: 1001,
                BizType:  "user_profile",
                Params:   map[string]interface{}{"name": "張三", "age": 30},
        }
        db.Create(&robot)

        // 4. 演示您的示例：指定表名 + 條件更新
        entityId := uint(1001)
        bizType := "user_profile"
        params := map[string]interface{}{
                "params": map[string]interface{}{"name": "李四", "age": 32},
        }

        // 使用 Table() 指定表名 + Where 條件 + Update
        result := db.Table("entity_robot").
                Where("entity_id = ? AND biz_type = ?", entityId, bizType).
                Updates(params)

        // 檢查更新結(jié)果
        fmt.Printf("更新影響行數(shù): %d\n", result.RowsAffected)
        if result.Error != nil {
                panic("更新失敗: " + result.Error.Error())
        }

        // 5. 驗(yàn)證更新結(jié)果
        var updatedRobot EntityRobot
        db.Where("entity_id = ? AND biz_type = ?", entityId, bizType).First(&updatedRobot)
        fmt.Printf("更新后參數(shù): %+v\n", updatedRobot.Params)

        // 6. 其他常用操作演示

        // 6.1 創(chuàng)建（帶JSON參數(shù)）
        newRobot := EntityRobot{
                EntityID: 1002,
                BizType:  "order",
                Params:   map[string]interface{}{"order_id": "ORD1001", "amount": 199.9},
        }
        db.Create(&newRobot)

        // 6.2 查詢（帶條件）
        var robots []EntityRobot
        db.Where("biz_type = ?", "order").Find(&robots)
        fmt.Printf("查詢到 %d 個(gè)訂單記錄\n", len(robots))

        // 6.3 軟刪除（默認(rèn)）
        db.Delete(&newRobot)

        // 6.4 硬刪除（需要使用 Unscoped）
        db.Unscoped().Delete(&newRobot)

        // 6.5 批量更新（更新多個(gè)記錄）
        db.Table("entity_robot").
                Where("biz_type = ?", "user_profile").
                Updates(map[string]interface{}{
                        "params": map[string]interface{}{"status": "active"},
                })

        // 6.6 原生SQL查詢
        var rawResult []struct {
                EntityID uint
                BizType  string
        }
        db.Raw("SELECT entity_id, biz_type FROM entity_robot WHERE params->>'$.age' > ?", 30).Scan(&rawResult)
        fmt.Printf("查詢到 %d 條年齡>30的記錄\n", len(rawResult))
}