GRDB.swift 中实现同一模型多表存储的技术方案

背景介绍

在使用 GRDB.swift 进行数据库操作时，开发者有时会遇到需要将相同结构的数据存储到不同数据库表中的场景。例如，学校管理系统可能需要将学生记录分别存储到不同班级的表中（ClassA 和 ClassB），而这些表具有完全相同的结构。

技术挑战

GRDB.swift 的 PersistableRecord 协议虽然允许我们定义关联的表名，但默认情况下一个模型只能关联一个表。这给需要将同一模型数据存储到多个表的需求带来了挑战。

解决方案

方案一：动态修改表名

通过动态修改模型的 databaseTableName 属性，可以在运行时指定要操作的表：

func insertStudents(_ students: [Student], to tableName: String) async throws {
    Student.databaseTableName = tableName
    try await dbWriter.write { db in
        try students.forEach { student in
            try student.insert(db)
        }
    }
}

注意事项：

1. 表名修改必须在数据库写操作闭包内部进行，确保线程安全
2. 写操作是串行执行的，可以避免并发修改表名的问题

方案二：使用 Table 类型进行查询

对于查询操作，可以使用 GRDB 的 Table 类型来实现多表查询：

let classATable = Table<Student>("ClassA")
let classBTable = Table<Student>("ClassB")

// 查询 ClassA 表中的所有学生
let classAStudents = try classATable.fetchAll(db)

数据库迁移建议

当需要为多个表创建相同结构时，建议使用 GRDB 的迁移机制而非 IF NOT EXISTS：

var migrator = DatabaseMigrator()
migrator.registerMigration("v1") { db in
    try ["ClassA", "ClassB"].forEach { tableName in
        try db.create(table: tableName) { t in
            t.autoIncrementedPrimaryKey("id")
            t.column("name", .text).notNull()
            // 其他列定义...
        }
    }
}

迁移的优势：

1. 更符合数据库版本管理的理念
2. 支持后续表结构的变更（如添加/删除列）
3. 执行一次后不会重复运行

总结

GRDB.swift 虽然不直接支持同一模型对应多个表，但通过动态表名和 Table 类型的组合使用，可以优雅地实现这一需求。在实际开发中，建议：

1. 写操作时动态修改表名，并确保在写闭包内完成
2. 读操作使用 Table 类型进行类型安全的查询
3. 使用迁移机制而非条件创建来初始化表结构

这种方案既保持了代码的类型安全，又避免了直接使用原始 SQL 字符串，符合 GRDB.swift 的设计理念。