nodedb-physical 0.3.0

Shared PhysicalTask IR and SqlPlan-to-PhysicalPlan converter for NodeDB Origin and Lite
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

// SPDX-License-Identifier: Apache-2.0

//! Error type for the shared SqlPlan → PhysicalPlan converter helpers.
//!
//! The variant set matches what the converter actually produces; deeper
//! engine-specific failures are re-wrapped at the deployment boundary.
//! Origin maps `ConvertError → nodedb::Error`; Lite will map it to its
//! own error type.

use crate::surrogate::SurrogateAssignError;

#[derive(Debug, thiserror::Error)]
pub enum ConvertError {
    /// The plan shape is invalid (unsupported combination, missing field, etc.).
    #[error("plan error: {0}")]
    PlanError(String),

    /// A client-facing request is malformed (bad cast, wrong literal type, etc.).
    #[error("bad request: {0}")]
    BadRequest(String),

    /// A defensive cap was exceeded (max fan-out, depth, columns, etc.).
    #[error("{limit_name} exceeded: {value} > {max}")]
    LimitExceeded {
        limit_name: &'static str,
        value: u64,
        max: u64,
    },

    /// Surrogate allocation failed.
    #[error(transparent)]
    Surrogate(#[from] SurrogateAssignError),

    /// Serialization failure (msgpack encoding of filters, projections, etc.).
    #[error("serialization: {0}")]
    Serialization(String),

    /// Catch-all for converter-internal failures that don't fit the above
    /// and that we don't want to leak from the shared crate as untyped strings.
    /// Carries a `'static` short reason; full detail propagates via `cause`.
    #[error("converter internal: {0}")]
    Other(String),
}