Enum MigrateError 

pub enum MigrateError {
    Io(Error),
    Json(Error),
    Sqlx(Error),
    NoChanges,
    UnsupportedChange(String),
    UnsafeAlter {
        model: String,
        column: String,
        reason: String,
    },
    DriftDetected {
        missing: Vec<(String, String)>,
    },
    SchemaUnsupportedOnSqlite {
        schema: String,
    },
    UnknownPlugin {
        requested: String,
        known: Vec<String>,
    },
}

Errors the migration engine can produce.

Variants

Io(Error)

IO error reading or writing a migration file or directory.

Json(Error)

JSON parse error on a migration file.

Sqlx(Error)

sqlx error executing a migration’s SQL or touching the tracking table.

NoChanges

make ran but found no differences against the latest snapshot, so there’s nothing to write. Surfaced so the CLI can print “no changes detected” instead of an empty migration file.

UnsupportedChange(String)

The current models diverge from the snapshot in a way M5 v1 can’t represent yet (anything other than create/drop table). M5.1 lifts this when column-level ops land.

UnsafeAlter

A column-level change the engine can’t apply automatically: type change, or a nullable flip on a populated SQLite table. Surfaces from diff so the build stops before producing a migration that would lose data or fail to apply. The user resolves by hand-writing the migration with the appropriate data-preserving steps. Carries the model / column / reason.

Fields

model: String

column: String

reason: String

DriftDetected

The tracking table records migrations that no longer have corresponding files on disk. Carries the list of missing names. The operator must either restore the files from VCS or run with --allow-drift to proceed despite the inconsistency.

Fields

missing: Vec<(String, String)>

SchemaUnsupportedOnSqlite

A schema-scoped migration (run_for_schema) was requested against a SQLite pool. SQLite has no schemas, so schema-per-tenant is Postgres-only (mirrors how Inet/Cidr gate on backend). Carries the schema name.

Fields

schema: String

UnknownPlugin

makemigrations --empty <plugin> named a plugin that isn’t registered. Carries the requested name and the registered set so the CLI can list the valid choices.

Fields

requested: String

known: Vec<String>

Trait Implementations

impl Debug for MigrateError

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

Formats the value using the given formatter.

impl Display for MigrateError

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

Formats the value using the given formatter.

impl Error for MigrateError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for MigrateError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MigrateError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MigrateError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<MigrateError> for InspectError

fn from(e: MigrateError) -> Self

Converts to this type from the input type.