GF框架中实现数据库分表策略的实践指南

2025-05-19 14:49:58作者：毕习沙Eudora

项目地址：https://gitcode.com/gh_mirrors/gf1/gf

引言

在大型应用系统中，随着数据量的不断增长，单表存储所有数据会面临性能瓶颈。数据库分表是一种常见的数据水平拆分方案，能够有效解决单表数据量过大导致的查询性能下降问题。本文将详细介绍在GF框架中如何实现两种典型的分表策略：基于用户ID的哈希分表和基于时间维度的分表。

基于用户ID的哈希分表实现

分表原理

哈希分表是一种常见的分表策略，通过对关键字段（如用户ID）进行取模运算，将数据均匀分布到多张表中。例如将用户数据按照UID%10的结果分散到10张表中（game_best_0到game_best_9）。

GF框架中的实现步骤

生成基础DAO代码：使用gf gen dao命令生成基础DAO代码后，需要手动修改两个关键文件。
修改DAO内部文件：在internal/dao/internal/game_best.go中，我们需要扩展基础DAO结构，添加分表相关功能：

type GameBestDao struct {
    table      string          // 基础表名（不含数字后缀）
    group      string          // 数据库配置组名
    columns    GameBestColumns // 表字段定义
    tableCount int             // 分表总数
}

// 设置实际表名
func (dao *GameBestDao) setTable(uid int) string {
    remainder := uid % dao.tableCount
    return dao.table + strconv.Itoa(remainder)
}

// 带分表参数的上下文方法
func (dao *GameBestDao) Ctx(ctx context.Context, uid int) *gdb.Model {
    return dao.DB().Model(dao.setTable(uid)).Safe().Ctx(ctx)
}

修改DO模型文件：在internal/model/do/game_best.go中，我们需要为每个分表创建对应的结构体，并提供便捷的创建方法：

// 基础字段结构
type GameBestBase struct {
    Uid     interface{} // 玩家id
    Money   interface{} // 游戏币
    // 其他字段...
}

// 分表结构体
type GameBest0 struct {
    g.Meta `orm:"table:game_best_0, do:true"`
    GameBestBase
}
// 其他分表结构体...

// 根据UID创建对应分表的结构体实例
func CreateAndSetGameBest(uid int, in GameBestBase) (any, error) {
    tableIndex := uid % 10
    // 使用反射创建并设置对应分表的结构体
    // ...
}

使用示例

// 创建玩家信息
func CreateGameUserInfo(ctx context.Context, uid int) error {
    userinfo, err := do.CreateAndSetUserInfo(uid, do.UserInfoBase{
        Uid: uid,
        // 其他字段初始化...
    })
    if err != nil {
        return err
    }

    return dao.UserInfo.Transaction(ctx, uid, func(ctx context.Context, tx gdb.TX) error {
        _, err = dao.UserInfo.Ctx(ctx, uid).Data(userinfo).Insert()
        return err
    })
}

基于时间维度的分表实现

分表原理

时间维度分表是按照年、月、周、日等时间单位将数据分散到不同的表中。例如年表(order_sum_2024)、月表(order_202404)、周表(order_202434)、日表(order_20240425)等。

GF框架中的实现

DAO层修改：与哈希分表类似，但表名生成逻辑不同：

func (dao *OrderDao) setTable(timeSuffix string) string {
    return dao.table + timeSuffix
}

func (dao *OrderDao) Ctx(ctx context.Context, timeSuffix string) *gdb.Model {
    return dao.DB().Model(dao.setTable(timeSuffix)).Safe().Ctx(ctx)
}