A boolean value indicating whether the database refers to unregistered migrations.
func hasBeenSuperseded(_ db: Database) throws -> Bool s4GRDB16DatabaseMigratorV17hasBeenSupersededySbAA0B0CKF What are these?1W42YA database connection.
A DatabaseError whenever an SQLite error occurs.
When the result is true, the database has likely been migrated by a more recent migrator.
import GRDBA toolkit for SQLite databases, with a focus on application development
struct DatabaseMigratorA DatabaseMigrator registers and applies database migrations.
final class DatabaseAn SQLite connection.
@frozen struct BoolA value type whose instances are either true or false.
struct DatabaseErrorA DatabaseError describes an SQLite error.
var migrations: [String] { get }The list of registered migration identifiers, in the same order as they have been registered.
func appliedIdentifiers(_ db: Database) throws -> Set<String> Returns the applied migration identifiers, even unregistered ones.
func appliedMigrations(_ db: Database) throws -> [String] Returns the identifiers of registered and applied migrations, in the order of registration.
func completedMigrations(_ db: Database) throws -> [String] Returns the identifiers of registered and completed migrations, in the order of registration.
func hasCompletedMigrations(_ db: Database) throws -> Bool A boolean value indicating whether all registered migrations, and only registered migrations, have been applied.
init() A new migrator.
var eraseDatabaseOnSchemaChange: BoolA boolean value indicating whether the migrator recreates the whole database from scratch if it detects a change in the definition of migrations.
func asyncMigrate(_ writer: any DatabaseWriter, completion: @escaping (Result<Database, Error>) -> Void) Schedules unapplied migrations for execution, and returns immediately.
func disablingDeferredForeignKeyChecks() -> DatabaseMigrator Returns a migrator that disables foreign key checks in all newly registered migrations.
func hasSchemaChanges(_ db: Database) throws -> Bool Returns a boolean value indicating whether the migrator detects a change in the definition of migrations.
func migrate(_ writer: any DatabaseWriter) throws Runs all unapplied migrations, in the same order as they were registered.
func migrate(_ writer: any DatabaseWriter, upTo targetIdentifier: String) throws Runs all unapplied migrations, in the same order as they were registered, up to the target migration identifier (included).
mutating func registerMigration(_ identifier: String, foreignKeyChecks: ForeignKeyChecks = .deferred, migrate: @escaping (Database) throws -> Void) Registers a migration.
enum ForeignKeyChecksControls how a migration handle foreign keys constraints.