Struct TableLineageEdge 

pub struct TableLineageEdge {
    pub source: TableRead,
    pub target: TableWrite,
}

A source-to-target table lineage edge inferred from the statement structure.

Emitted only for statements that physically move data into a target (INSERT, UPDATE, MERGE, CREATE TABLE AS SELECT, CREATE VIEW). DELETE, DROP, TRUNCATE, ALTER, and bare SELECT produce no lineage even when they reference other tables — the touched tables are still visible through TableOperation::reads and TableOperation::writes.

Each TableLineageEdge is a single directed edge — a statement that derives t from a JOIN b emits two edges (a → t, b → t), not one entry with both sources.

Occurrence on the source side: a statement reading the same real table twice (FROM s AS x JOIN s AS y, repeated FROM s across UNION branches) emits one edge per occurrence. A CTE body — the one declaration shared by every CteRef — contributes once instead (it materializes once and feeds once), matching how reads walks the body at its declaration rather than at each reference. Consumers wanting set-union semantics dedup explicitly via HashSet::from_iter. Matches ColumnLineageEdge on the non-CTE multiplicity rule.

Tables referenced only inside a predicate subquery are excluded: INSERT INTO t SELECT FROM s WHERE id IN (SELECT id FROM x) emits s → t but not x → t. x remains visible via reads.

CTE transitivity: WITH cte AS (SELECT ... FROM s) INSERT INTO t SELECT ... FROM cte emits s → t because s sits in a data-feeding chain from the CTE body up through the INSERT target. An unreferenced CTE contributes nothing — WITH cte AS (SELECT a FROM s) INSERT INTO t SELECT 1 emits no edge (the cte is bound but never FROM-used, so s doesn’t feed t).

Recursive CTEs collapse the same way: the anchor branch’s real tables feed the target, and the self-reference terminates against the pre-bind stub without re-emitting the cycle.

Fields

source: TableRead

The feeding source table, paired with its catalog-match ResolutionKind.

target: TableWrite

The write target, paired with its catalog-match ResolutionKind — the write-side counterpart of source (TableWrite).

Trait Implementations

impl Clone for TableLineageEdge

fn clone(&self) -> TableLineageEdge

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TableLineageEdge

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

Formats the value using the given formatter.

impl Eq for TableLineageEdge

impl Hash for TableLineageEdge

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 TableLineageEdge

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TableLineageEdge