Enum MigrationError 

pub enum MigrationError {
    SchemaDrift,
    IncompatibleType {
        table: String,
        column: String,
        old: DataTypeSnapshot,
        new: DataTypeSnapshot,
    },
    DefaultMissing {
        table: String,
        column: String,
    },
    ConstraintViolation {
        table: String,
        column: String,
        reason: String,
    },
    DestructiveOpDenied {
        op: String,
    },
    TransformAborted {
        table: String,
        column: String,
        reason: String,
    },
    WideningIncompatible {
        table: String,
        column: String,
        old_type: DataTypeSnapshot,
        new_type: DataTypeSnapshot,
    },
    TransformReturnedNone {
        table: String,
        column: String,
    },
    ForeignKeyViolation {
        table: String,
        column: String,
        target_table: String,
        value: String,
    },
}

Error variants produced by the migration planner and apply pipeline.

Variants

SchemaDrift

CRUD attempted while the DBMS is in drift state. Only ACL and migration entry points are allowed until MigrationOps are applied.

IncompatibleType

A column changed to a type that is neither in the widening whitelist nor handled by Migrate::transform_column.

Fields

table: String

Table the column belongs to.

column: String

Name of the offending column.

old: DataTypeSnapshot

Stored data type.

new: DataTypeSnapshot

Compiled data type.

DefaultMissing

AddColumn on a non-nullable column has neither a #[default] attribute nor a Migrate::default_value override.

Fields

table: String

Table the column belongs to.

column: String

Name of the offending column.

ConstraintViolation

A tightening AlterColumn op (e.g. nullable: false, unique: true, add FK) found existing data that violates the new constraint.

Fields

table: String

Table the column belongs to.

column: String

Name of the offending column.

reason: String

Human-readable description of which row(s) violated the constraint.

DestructiveOpDenied

Planner produced a destructive op while MigrationPolicy::allow_destructive is false.

Fields

op: String

Short tag for the offending op (e.g. "DropTable", "DropColumn").

TransformAborted

User-supplied Migrate::transform_column returned Err.

Fields

table: String

Table the column belongs to.

column: String

Name of the column being transformed.

reason: String

Reason propagated from the user transform.

WideningIncompatible

Type change is outside the widening whitelist (IntN→IntM, UintN→UintM, UintN→IntM, Float32→Float64) and no Migrate::transform_column impl handled it.

Fields

table: String

Table the column belongs to.

column: String

Name of the offending column.

old_type: DataTypeSnapshot

Stored data type before widening.

new_type: DataTypeSnapshot

Compiled data type after widening.

TransformReturnedNone

User Migrate::transform_column returned Ok(None) while a transform was required (no widening rule available).

Fields

table: String

Table the column belongs to.

column: String

Name of the column being transformed.

ForeignKeyViolation

Add-FK tightening found a row whose value is absent from the target table’s referenced column.

Fields

table: String

Source table that holds the foreign key column.

column: String

Source column carrying the foreign key.

target_table: String

Target table the FK references.

value: String

Stringified value that failed the lookup.

Trait Implementations

impl Clone for MigrationError

fn clone(&self) -> MigrationError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MigrationError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MigrationError

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for MigrationError

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

Formats the value using the given formatter.

impl Error for MigrationError

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<MigrationError> for DbmsError

fn from(source: MigrationError) -> Self

Converts to this type from the input type.

impl PartialEq for MigrationError

fn eq(&self, other: &MigrationError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for MigrationError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for MigrationError

impl StructuralPartialEq for MigrationError