Enum QueryError 

#[non_exhaustive]
pub enum QueryError {
    Parse(ParseError),
    Type(String),
    UnknownColumn(String),
    UnknownFunction(String),
    InvalidArguments(String, String),
    Aggregation(String),
    Evaluation(String),
    PivotWrongArity(usize),
    PivotSameColumn,
    PivotSecondNotInGroupBy,
    PivotWithoutGroupBy,
}

Error returned when executing a query fails.

Marked #[non_exhaustive] so adding new variants doesn’t break downstream consumers that match exhaustively.

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.

Parse(ParseError)

Parse error.

Type(String)

Type error (incompatible types in operation).

UnknownColumn(String)

Unknown column name.

UnknownFunction(String)

Unknown function name.

InvalidArguments(String, String)

Invalid function arguments.

Aggregation(String)

Aggregation error.

Evaluation(String)

Evaluation error.

PivotWrongArity(usize)

PIVOT BY clause does not have exactly two columns.

Matches bean-query’s compiler check (_compile_pivot_by in beanquery/compiler.py). The first column is the pivot value (whose values become new column headers); the second is the GROUP BY column to keep as the row key.

PivotSameColumn

PIVOT BY’s two columns refer to the same target.

Bean-query message: the two PIVOT BY columns cannot be the same column. Same wording reused for upstream parity.

PivotSecondNotInGroupBy

PIVOT BY’s second column isn’t in the GROUP BY clause.

The second pivot column has to be a GROUP BY key — otherwise the pivot output rows wouldn’t have a stable identity. Bean- query message: the second PIVOT BY column must be a GROUP BY column.

PivotWithoutGroupBy

PIVOT BY used on a query with no GROUP BY clause.

Implicit grouping (a SELECT with aggregates but no GROUP BY) produces a single row whose key is undefined; PIVOT BY’s second column has nothing meaningful to refer to. Distinct from PivotSecondNotInGroupBy (which is for “GROUP BY exists but the key column isn’t in it”).

Trait Implementations

impl Debug for QueryError

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

Formats the value using the given formatter.

impl Display for QueryError

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

Formats the value using the given formatter.

impl Error for QueryError

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<ParseError> for QueryError

fn from(source: ParseError) -> Self

Converts to this type from the input type.