Class DatabaseMigrator

Migrator implementation that tracks applied migrations in a database table.

Todo

allow configuring more of this

Hierarchy

Migrator
- DatabaseMigrator

Index

Constructors

constructor

new DatabaseMigrator(): DatabaseMigrator
Returns DatabaseMigrator

Inherited from Migrator.constructor

Properties

`Protected` `Readonly` bus

bus: Bus<Event>

`Protected` `Readonly` db

db: DatabaseService

`Protected` initialized

initialized: boolean = false

True if we've initialized the migrator.

`Protected` `Readonly` injector

injector: Container

`Protected` `Readonly` migrations

migrations: Migrations

Methods

`Protected` applied

applied(migration: Migration): Promise<void>
Protected
Fire the AppliedMigrationEvent.
Parameters
- migration: Migration
Returns Promise<void>
Inherited from Migrator.applied
- Defined in src/orm/migrations/Migrator.ts:231

apply

apply(migration: Migration): Promise<void>
Apply a single migration.
Parameters
- migration: Migration
Returns Promise<void>
Inherited from Migrator.apply
- Defined in src/orm/migrations/Migrator.ts:146

`Protected` applying

applying(migration: Migration): Promise<void>
Protected
Fire the ApplyingMigrationEvent.
Parameters
- migration: Migration
Returns Promise<void>
Inherited from Migrator.applying
- Defined in src/orm/migrations/Migrator.ts:221

`Protected` builder

builder(): Builder
Protected
Get a query builder instance.

Returns Builder
- Defined in src/orm/migrations/DatabaseMigrator.ts:174

`Protected` filterAppliedMigrations

filterAppliedMigrations(identifiers: string[]): Promise<string[]>
Protected
Given a list of migration identifiers, filter out those that have been applied. to make this more efficient
Parameters
- identifiers: string[]
Returns Promise<string[]>
Overrides Migrator.filterAppliedMigrations
- Defined in src/orm/migrations/DatabaseMigrator.ts:139

`Protected` filterPendingMigrations

filterPendingMigrations(identifiers: string[]): Promise<string[]>
Protected
Given a list of migration identifiers, filter out those that have not been applied. to make this more efficient
Parameters
- identifiers: string[]
Returns Promise<string[]>
Overrides Migrator.filterPendingMigrations
- Defined in src/orm/migrations/DatabaseMigrator.ts:158

`Protected` getAllMigrationIdentifiers

getAllMigrationIdentifiers(): string[]
Protected
Get all registered migrations, by their string-form identifiers.

Returns string[]
Inherited from Migrator.getAllMigrationIdentifiers
- Defined in src/orm/migrations/Migrator.ts:174

getLastApplyGroup

getLastApplyGroup(): Promise<string[]>
Get the identifiers of the last group of migrations that were applied.

Returns Promise<string[]>
Overrides Migrator.getLastApplyGroup
- Defined in src/orm/migrations/DatabaseMigrator.ts:94

`Protected` getNextGroupIdentifier

getNextGroupIdentifier(): Promise<number>
Protected
Helper method to look up the next applygroup that should be used.

Returns Promise<number>
- Defined in src/orm/migrations/DatabaseMigrator.ts:122

has

has(migration: Migration): Promise<boolean>
Should resolve true if the given migration has already been applied.
Parameters
- migration: Migration
Returns Promise<boolean>
Overrides Migrator.has
- Defined in src/orm/migrations/DatabaseMigrator.ts:51

initialize

initialize(): Promise<void>
Do any initial setup required to get the migrator ready. This can be overridden by implementation classes to do any necessary setup.

Returns Promise<void>
Overrides Migrator.initialize
- Defined in src/orm/migrations/DatabaseMigrator.ts:20

markApplied

markApplied(migrations: Migration | Migration[], applyDate?: Date): Promise<void>
Should mark the given migrations as being applied.

If a date is specified, then that is the timestamp when the migrations were applied, otherwise, use new Date().
Parameters
- migrations: Migration | Migration[]
- applyDate: Date = ...
Returns Promise<void>
Overrides Migrator.markApplied
- Defined in src/orm/migrations/DatabaseMigrator.ts:60

migrate

migrate(identifiers?: string[]): Promise<void>
Apply pending migrations.

If identifiers are specified, only the pending migrations with those identifiers are applied. If none are specified, all pending migrations will be applied.
Parameters
- Optional identifiers: string[]
Returns Promise<void>
Inherited from Migrator.migrate
- Defined in src/orm/migrations/Migrator.ts:69

rollback

rollback(identifiers?: string[]): Promise<void>
Rollback applied migrations.

If specified, only applied migrations with the given identifiers will be rolled back. If not specified, then the last "batch" of applied migrations will be rolled back.
Parameters
- Optional identifiers: string[]
Returns Promise<void>
Inherited from Migrator.rollback
- Defined in src/orm/migrations/Migrator.ts:110

`Protected` rolledBack

rolledBack(migration: Migration): Promise<void>
Protected
Fire the RolledBackMigrationEvent.
Parameters
- migration: Migration
Returns Promise<void>
Inherited from Migrator.rolledBack
- Defined in src/orm/migrations/Migrator.ts:251

`Protected` rollingBack

rollingBack(migration: Migration): Promise<void>
Protected
Fire the RollingBackMigrationEvent.
Parameters
- migration: Migration
Returns Promise<void>
Inherited from Migrator.rollingBack
- Defined in src/orm/migrations/Migrator.ts:241

undo

undo(migration: Migration): Promise<void>
Rollback a single migration.
Parameters
- migration: Migration
Returns Promise<void>
Inherited from Migrator.undo
- Defined in src/orm/migrations/Migrator.ts:160

unmarkApplied

unmarkApplied(migrations: Migration | Migration[]): Promise<void>
Should un-mark the given migrations as being applied.
Parameters
- migrations: Migration | Migration[]
Returns Promise<void>
Overrides Migrator.unmarkApplied
- Defined in src/orm/migrations/DatabaseMigrator.ts:80