Enum Expr 

pub enum Expr {
    Column {
        path: Vec<String>,
    },
    Literal {
        value: ScalarValue,
    },
    Alias {
        expression: Box<Expr>,
        name: String,
    },
    Binary {
        left: Box<Expr>,
        op: BinaryOperator,
        right: Box<Expr>,
    },
    IsNull {
        expression: Box<Expr>,
        negated: bool,
    },
    Aggregate {
        function: AggregateFunction,
        expression: Option<Box<Expr>>,
        distinct: bool,
    },
    Cast {
        expression: Box<Expr>,
        data_type: ExprDataType,
        safe: bool,
    },
    Sort {
        expression: Box<Expr>,
        direction: SortDirection,
        nulls: NullOrdering,
    },
    Function {
        name: String,
        arguments: Vec<Expr>,
    },
    Window {
        expression: Box<Expr>,
        partition_by: Vec<Expr>,
        order_by: Vec<Expr>,
        frame: Option<WindowFrame>,
    },
    RawSql {
        sql: String,
    },
}

Structured public expression AST.

Variants

Column

Fields

path: Vec<String>

Literal

Fields

value: ScalarValue

Alias

Fields

expression: Box<Expr>

name: String

Binary

Fields

left: Box<Expr>

op: BinaryOperator

right: Box<Expr>

IsNull

Fields

expression: Box<Expr>

negated: bool

Aggregate

Fields

function: AggregateFunction

expression: Option<Box<Expr>>

distinct: bool

Cast

Fields

expression: Box<Expr>

data_type: ExprDataType

safe: bool

Sort

Fields

expression: Box<Expr>

direction: SortDirection

nulls: NullOrdering

Function

Fields

name: String

arguments: Vec<Expr>

Window

Fields

expression: Box<Expr>

partition_by: Vec<Expr>

order_by: Vec<Expr>

frame: Option<WindowFrame>

ROWS/RANGE BETWEEN ... AND ... frame bounds. #[serde(default)] so expressions serialized before this field existed still decode (as “no frame specified”, DataFusion’s own OVER-clause default).

RawSql

Fields

sql: String

Implementations

impl Expr

pub fn column(name: &str) -> Self

pub fn literal(value: ScalarValue) -> Self

pub fn raw(sql: impl Into<String>) -> Self

pub fn alias(self, name: impl Into<String>) -> Self

pub fn binary(self, op: BinaryOperator, right: Expr) -> Self

pub fn cast(self, data_type: ExprDataType) -> Self

pub fn try_cast(self, data_type: ExprDataType) -> Self

pub fn function(name: impl Into<String>, arguments: Vec<Expr>) -> Self

pub fn over(self, partition_by: Vec<Expr>, order_by: Vec<Expr>) -> Self

pub fn frame(self, frame: WindowFrame) -> Self

Attach a ROWS/RANGE BETWEEN ... AND ... frame to a window expression built by Expr::over. A no-op on any other variant — there is no frame to attach without a preceding .over(...) call.

pub fn normalize_json(&self) -> Result<String, PlanError>

pub fn encode_versioned(&self) -> Result<Vec<u8>, PlanError>

pub fn decode_versioned(bytes: &[u8]) -> Result<Self, PlanError>

pub fn validate(&self) -> Result<(), PlanError>

pub fn to_sql(&self) -> String

Trait Implementations

impl Clone for Expr

fn clone(&self) -> Expr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Expr

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Expr

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Expr

impl Hash for Expr

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Expr

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Expr

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Expr