Migrator class
Runs migrations declared by a MigrationStrategy.
Constructors
- Migrator(GeneratedDatabase database, [VersionedSchema? _fixedVersion])
- Used internally by drift when opening the database.
Properties
- database → GeneratedDatabase
-
The instance of the GeneratedDatabase class generated by
drift_devthat this migrator is connected to.final - hashCode → int
-
The hash code for this object.
no setterinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
Methods
-
addColumn(
TableInfo< Table, dynamic> table, GeneratedColumn<Object> column) → Future<void> - Adds the given column to the specified table.
-
alterTable(
TableMigration migration) → Future< void> - Alter columns of an existing table.
-
create(
DatabaseSchemaEntity entity) → Future< void> -
Creates the given
entity, which can be a table, a view, a trigger, an index or an OnCreateQuery. -
createAll(
) → Future< void> - Creates all tables, triggers, views, indexes and everything else defined in the database, if they don't exist.
-
createAllTables(
) → Future< void> - Creates all tables specified for the database, if they don't exist
-
createIndex(
Index index) → Future< void> -
Executes a
CREATE INDEXstatement to create theindex. -
createTable(
TableInfo< Table, dynamic> table) → Future<void> - Creates the given table if it doesn't exist
-
createTrigger(
Trigger trigger) → Future< void> -
Executes the
CREATE TRIGGERstatement that created thetrigger. -
createView(
ViewInfo< HasResultSet, dynamic> view) → Future<void> -
Executes a
CREATE VIEWstatement to create theview. -
deleteTable(
String name) → Future< void> -
Deletes the table with the given name. Note that this function does not
escape the
nameparameter. -
drop(
DatabaseSchemaEntity entity) → Future< void> - Drops a table, trigger or index.
-
dropColumn(
TableInfo< Table, dynamic> table, String column) → Future<void> -
Attempts to alter
tableto drop thecolumn. -
issueCustomQuery(
String sql, [List? args]) → Future< void> - Executes the custom query.
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
recreateAllViews(
) → Future< void> - Drops and re-creates all views known to the database.
-
renameColumn(
TableInfo< Table, dynamic> table, String oldName, GeneratedColumn<Object> column) → Future<void> -
Changes the name of a column in a
table. -
renameTable(
TableInfo< Table, dynamic> table, String oldName) → Future<void> -
Changes the
tablename fromoldNameto the current TableInfo.actualTableName. -
runMigrationSteps(
{required int from, required int to, required MigrationStepWithVersion steps}) → Future< void> -
Allows customizing step-by-step migrations (like the
OnUpgradecallback returned by the generatedstepByStepfunction) by invoking thestepsfunction for each intermediate schema version fromfromuntiltois reached. -
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited
Static Methods
-
stepByStepHelper(
{required MigrationStepWithVersion step}) → OnUpgrade - A helper used by drift internally to implement the step-by-step migration feature.