Struct sqlx::migrate::Migrator

pub struct Migrator {
    pub migrations: Cow<'static, [Migration]>,
    pub ignore_missing: bool,
}

Fields

migrations: Cow<'static, [Migration]>

ignore_missing: bool

Implementations

impl Migrator

pub async fn new<'s, S>(source: S) -> Result<Migrator, MigrateError> where
    S: MigrationSource<'s>, 

Creates a new instance with the given source.

Examples

use std::path::Path;

// Read migrations from a local folder: ./migrations
let m = Migrator::new(Path::new("./migrations")).await?;

See MigrationSource for details on structure of the ./migrations directory.

pub fn set_ignore_missing(&mut self, ignore_missing: bool) -> &Migrator

Specify should ignore applied migrations that missing in the resolved migrations.

pub fn iter(&self) -> Iter<'_, Migration>

Get an iterator over all known migrations.

pub async fn run<'a, A>(&'_ self, migrator: A) -> Result<(), MigrateError> where
    A: Acquire<'a>,
    <<A as Acquire<'a>>::Connection as Deref>::Target: Migrate, 

Run any pending migrations against the database; and, validate previously applied migrations against the current migration source to detect accidental changes in previously-applied migrations.

Examples

let m = Migrator::new(std::path::Path::new("./migrations")).await?;
let pool = sqlx_core::sqlite::SqlitePoolOptions::new().connect("sqlite::memory:").await?;
m.run(&pool).await

Trait Implementations

impl Debug for Migrator

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.