Enum PlanError 

pub enum PlanError {
    UnbreakableCycle(Vec<String>),
    UnexpectedCycleAfterFkExtraction(Vec<String>),
    UnexpectedDropCycle(Vec<String>),
    Internal(String),
    BodyCycle {
        nodes: Vec<NodeId>,
    },
    AstResolution(String),
    DependentViewsBlocked {
        views: Vec<QualifiedName>,
    },
}

Errors raised by the plan-ordering phase.

Variants

UnbreakableCycle(Vec<String>)

A dependency cycle remained after the planner attempted to break it by extracting FK constraints. Carries the rendered node identifiers participating in the cycle.

UnexpectedCycleAfterFkExtraction(Vec<String>)

After FK extraction the modify-graph topo sort still cycled. This indicates a non-FK cycle that the planner cannot resolve and is almost certainly a bug in upstream phases.

UnexpectedDropCycle(Vec<String>)

The drop-graph topo sort cycled. Drops never have legitimate cycles; this indicates a corrupt target catalog.

Internal(String)

An internal invariant was violated.

BodyCycle

Body-derived cycle in the dependency graph.

FK cycles between tables are auto-extracted into deferred FK adds (UnbreakableCycle is a different error). Body-derived cycles — view A queries view B that queries view A — have no general mechanical fix and surface here. User must edit source to break the cycle.

Fields

nodes: Vec<NodeId>

Nodes participating in the cycle, in graph-walk order.

AstResolution(String)

An AST resolution error escalated to plan time (e.g., a sub-spec resolver runs after the initial parse pass).

DependentViewsBlocked

The view_drop_create_dependents policy is false and at least one change would force dependent views to be dropped and recreated. Carries the names of the blocked views.

Resolution: either enable view_drop_create_dependents in the planner policy, or modify the migration to explicitly DROP + CREATE the listed views.

Fields

views: Vec<QualifiedName>

Views that would need to be recreated.

Trait Implementations

impl Debug for PlanError

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

Formats the value using the given formatter.

impl Display for PlanError

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

Formats the value using the given formatter.

impl Error for PlanError

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<PlanError> for Error

fn from(source: PlanError) -> Self

Converts to this type from the input type.

impl PartialEq for PlanError

fn eq(&self, other: &PlanError) -> 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 Eq for PlanError

impl StructuralPartialEq for PlanError