Enum MergeIntoClauseKind 

pub enum MergeIntoClauseKind {
    Matched,
    NotMatched,
    NotMatchedByTarget,
    NotMatchedBySource,
}

Which rows a MERGE WHEN clause applies to.

Mirrors sqlparser::ast::MergeClauseKind so that the SQL spelling is preserved through the logical plan.

Note on NotMatched vs NotMatchedByTarget: these two variants are semantically identical — both describe a source row that has no matching target row. NotMatched is the SQL standard short form (used by Snowflake, Postgres, SQL Server); NotMatchedByTarget is BigQuery’s explicit form added for symmetry with NotMatchedBySource. Downstream consumers (planners, table providers, optimizers) MUST treat the two variants identically.

Variants

Matched

WHEN MATCHED

NotMatched

WHEN NOT MATCHED — see type-level note for the equivalence with NotMatchedByTarget.

NotMatchedByTarget

WHEN NOT MATCHED BY TARGET — see type-level note for the equivalence with NotMatched.

NotMatchedBySource

WHEN NOT MATCHED BY SOURCE

Implementations

impl MergeIntoClauseKind

pub fn is_not_matched_by_target(&self) -> bool

True if this clause fires on a source row that has no matching target row. Returns true for both NotMatched and NotMatchedByTarget (see the type-level note explaining why those two variants are semantically identical).

Prefer this predicate over hand-written matches! arms so the NotMatched/NotMatchedByTarget equivalence is enforced in one place.

pub fn canonical(self) -> Self

Collapse the SQL-spelling variants into the canonical three semantic categories: Matched, NotMatchedByTarget (covering both “NOT MATCHED” spellings), and NotMatchedBySource.

Use this in downstream match expressions when the SQL spelling distinction does not matter — e.g. in planners, optimizers, or table-provider dispatch.

Trait Implementations

impl Clone for MergeIntoClauseKind

fn clone(&self) -> MergeIntoClauseKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for MergeIntoClauseKind

impl Debug for MergeIntoClauseKind

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

Formats the value using the given formatter.

impl Eq for MergeIntoClauseKind

impl From<Kind> for MergeIntoClauseKind

Available on crate feature proto only.

fn from(kind: Kind) -> Self

Converts to this type from the input type.

impl From<MergeIntoClauseKind> for Kind

Available on crate feature proto only.

fn from(kind: MergeIntoClauseKind) -> Self

Converts to this type from the input type.

impl Hash for MergeIntoClauseKind

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 MergeIntoClauseKind

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for MergeIntoClauseKind

fn partial_cmp(&self, other: &MergeIntoClauseKind) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for MergeIntoClauseKind