编辑“︁Gin数据库迁移”︁（章节）

== Gin中实现数据库迁移 ==

=== 使用GORM进行迁移 ===
GORM是Go语言中最流行的ORM库之一，与Gin框架集成良好。以下是使用GORM实现迁移的示例：

<syntaxhighlight lang="go">
package main

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

type User struct {
	gorm.Model
	Name  string
	Email string `gorm:"unique"`
}

func main() {
	// 连接SQLite数据库（也可以是MySQL/PostgreSQL等）
	db, err := gorm.Open(sqlite.Open("test.db"), &gorm.Config{})
	if err != nil {
		panic("failed to connect database")
	}

	// 自动迁移User结构体
	err = db.AutoMigrate(&User{})
	if err != nil {
		panic("failed to migrate database")
	}
}
</syntaxhighlight>

'''代码解释'''：
1. 定义了一个User模型，包含ID、CreatedAt等标准字段（来自gorm.Model）
2. 使用AutoMigrate方法自动创建或更新表结构
3. 如果数据库不存在会自动创建
4. 如果表已存在但结构不同，会自动修改表结构

=== 使用Goose进行高级迁移 ===
对于更复杂的迁移需求，可以使用专门的迁移工具如Goose：

<syntaxhighlight lang="bash">
# 安装Goose
go install github.com/pressly/goose/v3/cmd/goose@latest
</syntaxhighlight>

创建迁移文件：
<syntaxhighlight lang="bash">
goose create add_users_table sql
</syntaxhighlight>

这会生成一个类似`20230601000000_add_users_table.sql`的文件，包含up和down两个部分：

<syntaxhighlight lang="sql">
-- +goose Up
CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    name TEXT NOT NULL,
    email TEXT UNIQUE NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- +goose Down
DROP TABLE users;
</syntaxhighlight>

然后在Go代码中执行迁移：
<syntaxhighlight lang="go">
import "github.com/pressly/goose/v3"

func main() {
    db, _ := gorm.Open(sqlite.Open("test.db"), &gorm.Config{})
    sqlDB, _ := db.DB()
    
    // 执行所有待处理的迁移
    if err := goose.Up(sqlDB, "migrations"); err != nil {
        panic(err)
    }
}
</syntaxhighlight>