首页
/ GRDB.swift 中实现数据库字段不可变性的最佳实践

GRDB.swift 中实现数据库字段不可变性的最佳实践

2025-05-30 09:58:07作者:瞿蔚英Wynne

在数据库设计中,有时我们需要确保某些字段一旦创建就不能被修改。这种不可变性(immutability)对于维护数据一致性非常重要。GRDB.swift 作为 Swift 语言的 SQLite 封装库,提供了多种方式来实现这种需求。

使用 SQL 触发器保护字段

最直接的方式是使用 SQL 触发器(Trigger)。以下是一个保护 podcast 表中 feedURL 字段不被修改的实现示例:

try db.create(table: "podcast") { t in
    t.autoIncrementedPrimaryKey("id")
    t.column("feedURL", .text).unique().notNull().indexed()
    t.column("title", .text).notNull()
}

try db.execute(
    sql: """
    CREATE TRIGGER protectFeedURL
    BEFORE UPDATE OF feedURL ON podcast
    WHEN OLD.feedURL != NEW.feedURL
    BEGIN
    SELECT RAISE(ABORT, 'Updating podcast.feedURL is prohibited');
    END;
    """
)

这段代码创建了一个触发器,在尝试修改 feedURL 字段时会抛出错误并阻止修改操作。

封装为可重用方法

为了提升代码的可重用性和可读性,我们可以将其封装为一个扩展方法:

extension Database {
    func preventModifications(of column: String, in table: String) throws {
        let trigger = "protect_\(table)_\(column)"
        let errorMessage = "Modifying \(table).\(column) is prohibited"
        try execute(literal: """
            CREATE TRIGGER \(identifier: trigger)
            BEFORE UPDATE OF \(identifier: column) ON \(identifier: table)
            WHEN OLD.\(identifier: column) <> NEW.\(identifier: column)
            BEGIN
            SELECT RAISE(ABORT, \(errorMessage));
            END
            """)
    }
}

使用这种方式时,代码会更加简洁:

try db.create(table: "podcast") { ... }
try db.preventModifications(of: "feedURL", in: "podcast")

技术细节说明

  1. SQL 触发器:触发器是数据库中的一种特殊对象,它会在特定事件发生时自动执行。这里我们使用 BEFORE UPDATE 触发器在数据修改前进行检查。

  2. RAISE(ABORT):这是 SQLite 的错误抛出机制,会终止当前操作并回滚事务。

  3. SQL 字面量插值:使用 \(identifier: ...) 语法可以正确处理表名或列名是 SQL 关键字的情况,提高了代码的健壮性。

适用场景

这种技术特别适用于以下场景:

  • 需要确保某些关键字段的不可变性
  • 需要维护数据的历史一致性
  • 需要防止意外修改重要数据

总结

GRDB.swift 虽然不直接提供字段不可变性的高级抽象,但通过 SQL 触发器和适当的封装,我们可以轻松实现这一需求。这种方法既保持了灵活性,又能确保数据的安全性。

登录后查看全文
热门项目推荐
相关项目推荐