Struct ProjectionExprs 

pub struct ProjectionExprs { /* private fields */ }

A collection of projection expressions.

This struct encapsulates multiple ProjectionExpr instances, representing a complete projection operation and provides methods to manipulate and analyze the projection as a whole.

Implementations

impl ProjectionExprs

pub fn new<I>(exprs: I) -> Self

where I: IntoIterator<Item = ProjectionExpr>,

pub fn from_indices(indices: &[usize], schema: &SchemaRef) -> Self

Creates a ProjectionExpr from a list of column indices.

This is a convenience method for creating simple column-only projections, where each projection expression is a reference to a column in the input schema.

Behavior

• Ordering: the output projection preserves the exact order of indices provided in the input slice For example, [2, 0, 1] will produce projections for columns 2, 0, then 1 in that order
• Duplicates: Duplicate indices are allowed and will create multiple projection expressions referencing the same source column For example, [0, 0] creates 2 separate projections both referencing column 0

Panics

Panics if any index in indices is out of bounds for the provided schema.

Example

use arrow::datatypes::{DataType, Field, Schema};
use datafusion_physical_expr::projection::ProjectionExprs;
use std::sync::Arc;

// Create a schema with three columns
let schema = Arc::new(Schema::new(vec![
    Field::new("a", DataType::Int32, false),
    Field::new("b", DataType::Utf8, false),
    Field::new("c", DataType::Float64, false),
]));

// Project columns at indices 2 and 0 (c and a) - ordering is preserved
let projection = ProjectionExprs::from_indices(&[2, 0], &schema);

// This creates: SELECT c@2 AS c, a@0 AS a
assert_eq!(projection.as_ref().len(), 2);
assert_eq!(projection.as_ref()[0].alias, "c");
assert_eq!(projection.as_ref()[1].alias, "a");

// Duplicate indices are allowed
let projection_with_dups = ProjectionExprs::from_indices(&[0, 0, 1], &schema);
assert_eq!(projection_with_dups.as_ref().len(), 3);
assert_eq!(projection_with_dups.as_ref()[0].alias, "a");
assert_eq!(projection_with_dups.as_ref()[1].alias, "a"); // duplicate
assert_eq!(projection_with_dups.as_ref()[2].alias, "b");

pub fn iter(&self) -> impl Iterator<Item = &ProjectionExpr>

Returns an iterator over the projection expressions

pub fn projection_mapping( &self, input_schema: &SchemaRef, ) -> Result<ProjectionMapping>

Creates a ProjectionMapping from this projection

pub fn expr_iter(&self) -> impl Iterator<Item = Arc<dyn PhysicalExpr>> + '_

Iterate over a clone of the projection expressions.

pub fn try_merge(&self, other: &ProjectionExprs) -> Result<ProjectionExprs>

Apply another projection on top of this projection, returning the combined projection. For example, if this projection is SELECT c@2 AS x, b@1 AS y, a@0 as z and the other projection is SELECT x@0 + 1 AS c1, y@1 + z@2 as c2, we return a projection equivalent to SELECT c@2 + 1 AS c1, b@1 + a@0 as c2.

Example

use datafusion_common::{Result, ScalarValue};
use datafusion_expr::Operator;
use datafusion_physical_expr::expressions::{BinaryExpr, Column, Literal};
use datafusion_physical_expr::projection::{ProjectionExpr, ProjectionExprs};
use std::sync::Arc;

fn main() -> Result<()> {
    // Example from the docstring:
    // Base projection: SELECT c@2 AS x, b@1 AS y, a@0 AS z
    let base = ProjectionExprs::new(vec![
        ProjectionExpr {
            expr: Arc::new(Column::new("c", 2)),
            alias: "x".to_string(),
        },
        ProjectionExpr {
            expr: Arc::new(Column::new("b", 1)),
            alias: "y".to_string(),
        },
        ProjectionExpr {
            expr: Arc::new(Column::new("a", 0)),
            alias: "z".to_string(),
        },
    ]);

    // Top projection: SELECT x@0 + 1 AS c1, y@1 + z@2 AS c2
    let top = ProjectionExprs::new(vec![
        ProjectionExpr {
            expr: Arc::new(BinaryExpr::new(
                Arc::new(Column::new("x", 0)),
                Operator::Plus,
                Arc::new(Literal::new(ScalarValue::Int32(Some(1)))),
            )),
            alias: "c1".to_string(),
        },
        ProjectionExpr {
            expr: Arc::new(BinaryExpr::new(
                Arc::new(Column::new("y", 1)),
                Operator::Plus,
                Arc::new(Column::new("z", 2)),
            )),
            alias: "c2".to_string(),
        },
    ]);

    // Expected result: SELECT c@2 + 1 AS c1, b@1 + a@0 AS c2
    let result = base.try_merge(&top)?;

    assert_eq!(result.as_ref().len(), 2);
    assert_eq!(result.as_ref()[0].alias, "c1");
    assert_eq!(result.as_ref()[1].alias, "c2");

    Ok(())
}

Errors

This function returns an error if any expression in the other projection cannot be applied on top of this projection.

pub fn column_indices(&self) -> Vec<usize>

Extract the column indices used in this projection. For example, for a projection SELECT a AS x, b + 1 AS y, where a is at index 0 and b is at index 1, this function would return [0, 1]. Repeated indices are returned only once, and the order is ascending.

pub fn ordered_column_indices(&self) -> Vec<usize>

Extract the ordered column indices for a column-only projection.

This function assumes that all expressions in the projection are simple column references. It returns the column indices in the order they appear in the projection.

Panics

Panics if any expression in the projection is not a simple column reference. This includes:

• Computed expressions (e.g., a + 1, CAST(a AS INT))
• Function calls (e.g., UPPER(name), SUM(amount))
• Literals (e.g., 42, 'hello')
• Complex nested expressions (e.g., CASE WHEN ... THEN ... END)

Returns

A vector of column indices in projection order. Unlike column_indices(), this function:

• Preserves the projection order (does not sort)
• Preserves duplicates (does not deduplicate)

Example

For a projection SELECT c, a, c where a is at index 0 and c is at index 2, this function would return [2, 0, 2].

Use column_indices() instead if the projection may contain non-column expressions or if you need a deduplicated sorted list.

pub fn project_schema(&self, input_schema: &Schema) -> Result<Schema>

Project a schema according to this projection. For example, for a projection SELECT a AS x, b + 1 AS y, where a is at index 0 and b is at index 1, if the input schema is [a: Int32, b: Int32, c: Int32], the output schema would be [x: Int32, y: Int32]. Fields’ metadata are preserved from the input schema.

pub fn project_statistics( &self, stats: Statistics, input_schema: &Schema, ) -> Result<Statistics>

Project statistics according to this projection. For example, for a projection SELECT a AS x, b + 1 AS y, where a is at index 0 and b is at index 1, if the input statistics has column statistics for columns a, b, and c, the output statistics would have column statistics for columns x and y.

Trait Implementations

impl AsRef<[ProjectionExpr]> for ProjectionExprs

fn as_ref(&self) -> &[ProjectionExpr]

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for ProjectionExprs

fn clone(&self) -> ProjectionExprs

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProjectionExprs

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

Formats the value using the given formatter.

impl Display for ProjectionExprs

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

Formats the value using the given formatter.

impl From<&[ProjectionExpr]> for ProjectionExprs

fn from(value: &[ProjectionExpr]) -> Self

Converts to this type from the input type.

impl From<Vec<ProjectionExpr>> for ProjectionExprs

fn from(value: Vec<ProjectionExpr>) -> Self

Converts to this type from the input type.

impl FromIterator<ProjectionExpr> for ProjectionExprs

fn from_iter<T: IntoIterator<Item = ProjectionExpr>>(exprs: T) -> Self

Creates a value from an iterator.

impl<'a> IntoIterator for &'a ProjectionExprs

type Item = &'a ProjectionExpr

The type of the elements being iterated over.

type IntoIter = Iter<'a, ProjectionExpr>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for ProjectionExprs

type Item = ProjectionExpr

The type of the elements being iterated over.

type IntoIter = IntoIter<ProjectionExpr>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.