Enum MigrateError 

#[non_exhaustive]
pub enum MigrateError {
    InvalidSchema {
        schema: String,
    },
    Sqlx {
        source: MigrateError,
    },
    UnsupportedServerVersion {
        required: u32,
        detected: u32,
    },
}

migrate’s failure. Provider-owned, not a re-export of sqlx::migrate::MigrateError: a rejected schema identifier has no variant in sqlx’s own type to report it as, since that check happens before any sqlx::migrate code runs at all.

use reliar_store_postgres::{MigrateOptions, migrate};

let options = MigrateOptions::default().schema("Not-Lowercase");
if let Err(err) = migrate(&pool, options).await {
    eprintln!("migration failed: {err}");
}

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidSchema

options.schema is not a valid PostgreSQL identifier ([a-z_][a-z0-9_$]*, at most 63 bytes, lowercase only — PostgreSQL folds an unquoted identifier to lowercase, so an uppercase name would migrate into a schema the rest of the crate, and the host’s own search_path, can never consistently resolve; ADR 0040 §5). Checked before the name reaches dangerous_set_table_name, which is string interpolation into DDL.

Fields

schema: String

The rejected schema name.

Sqlx

Any failure from sqlx::migrate::Migrator::run or the dedicated connection’s own setup (a connection failure, a checksum mismatch against an already-applied file, …).

Fields

source: MigrateError

The underlying sqlx migration error.

UnsupportedServerVersion

The connected server’s server_version_num is below crate::MIN_SERVER_VERSION_NUM (PostgreSQL 18, ADR 0041 / human decision #47) — no older-version fallback. Checked as the first statement on migrate’s dedicated connection, before SET search_path, schema creation, or any migration file runs — a refused migrate() leaves the database exactly as it found it. migrate.rs declares its own copy of this variant rather than re-exporting crate::PostgresStoreError::UnsupportedServerVersion — the same shape as Self::InvalidSchema alongside crate::PostgresStoreError::InvalidSchema.

Fields

required: u32

crate::MIN_SERVER_VERSION_NUM, restated on the value.

detected: u32

The server_version_num this connection reported.

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(source: Error) -> Self

Converts to this type from the input type.

impl From<MigrateError> for MigrateError

fn from(source: MigrateError) -> Self

Converts to this type from the input type.