Crate partiql_logical

A PartiQL logical plan.

This module contains the structures for a PartiQL logical plan. Three main entities in the module are LogicalPlan, BindingsOp, and ValueExpr. LogicalPlan represents a graph based logical plan. BindingsOp represent operations that operate on binding tuples and ValueExpr represents PartiQL expressions that produce PartiQL values; all as specified in PartiQL Specification 2019.

Plan graph nodes are called operators and edges are called flows re-instating the fact that the plan captures data flows for a given PartiQL statement.

Structs

BagExpr

Represents a PartiQL bag expression, e.g. <<a.c * 2, 5>>.

BetweenExpr

Represents a PartiQL BETWEEN expression, e.g. BETWEEN 500 AND 600.

CallExpr

Represents a CALL expression (i.e., a function call), e.g. LOWER("ALL CAPS").

CoalesceExpr

Represents a COALESCE expression, e.g. COALESCE(NULL, 10) in SELECT COALESCE(NULL, 10) FROM data.

ExprQuery

Represents an expression query e.g. a * 2 in a * 2 or an expression like 2+2.

Filter

Filter represents a filter operator, e.g. WHERE a = 10 in SELECT a FROM t WHERE a = 10.

IsTypeExpr

Represents an IS expression, e.g. IS TRUE.

Join

[’Join] represents a join operator, e.g. implicit CROSS JOINspecified by comma inFROMclause inSELECT t1.a, t2.b FROM tbl1 AS t1, tbl2 AS t2`.

LikeMatch

ListExpr

Represents a PartiQL list expression, e.g. [a.c * 2, 5].

LogicalPlan

Represents a PartiQL logical plan.

NullIfExpr

Represents a NULLIF expression, e.g. NULLIF(v1, v2) in SELECT NULLIF(v1, v2) FROM data.

OpId

Represents an operator identifier in a LogicalPlan

PatternMatchExpr

Represents a PartiQL Pattern Match expression, e.g. 'foo' LIKE 'foo'.

Project

Represents a projection, e.g. SELECT a in SELECT a FROM t.

ProjectValue

Represents a value projection (SELECT VALUE) e.g. SELECT VALUE t.a * 2 in SELECT VALUE t.a * 2 IN tbl AS t.

Scan

Scan bridges from ValueExprs to BindingsOps.

SearchedCase

Represents a PartiQL’s searched case expressions, e.g.CASE [ WHEN <expr> THEN <expr> ]... [ ELSE <expr> ] END.

SimpleCase

Represents a PartiQL’s simple case expressions, e.g.CASE <expr> [ WHEN <expr> THEN <expr> ]... [ ELSE <expr> ] END.

SubQueryExpr

Represents a sub-query expression, e.g. SELECT v.a*2 AS u FROM t AS v in SELECT t.a, s FROM data AS t, (SELECT v.a*2 AS u FROM t AS v) AS s

TupleExpr

Represents a PartiQL tuple expression, e.g: { a.b: a.c * 2, 'count': a.c + 10}.

Unpivot

Unpivot bridges from ValueExprs to BindingsOps.

Enums

BinaryOp

Represents logical plan’s binary operators.

BindingsOp

Represents PartiQL binding operators; A BindingOp is an operator that operates on binding tuples as specified by PartiQL Specification 2019.

CallName

Represents a known function.

JoinKind

Represents join types.

PathComponent

Represents a path component in a plan.

Pattern

Type

Represents a PartiQL Type.

UnaryOp

Represents logical plan’s unary operators.

ValueExpr

Represents a PartiQL value expression. Evaluation of a ValueExpr leads to a PartiQL value as specified by PartiQL Specification 2019.