gudusoft.gsqlparser.dlineage.dynamicsql

Class DynamicSqlLineageResolver.MaterializedSite

Object

gudusoft.gsqlparser.dlineage.dynamicsql.DynamicSqlLineageResolver.MaterializedSite

Enclosing class:

DynamicSqlLineageResolver

public static final class DynamicSqlLineageResolver.MaterializedSite
extends Object

Materialized dynamic-SQL text for one EXEC / sp_executesql site, produced by the no-bindings default-path evaluation (DynamicSqlLineageResolver.materializeSitesWithoutBindings(gudusoft.gsqlparser.TCustomSqlStatement, gudusoft.gsqlparser.EDbVendor, gudusoft.gsqlparser.dlineage.dynamicsql.DynamicLineageOptions)).

Field Summary

Fields

Modifier and Type	Field and Description
BindingSource	bindingSource The parameter values this variant was evaluated with: none, or the call or caller that supplied them.
String	diagnostic Additive analysis note, such as a constant-relation over-approximation.
boolean	executionCertain False when the statement may not run on the evaluated path: it sits in a CATCH block, or behind a condition or loop whose outcome is not known.
String	executionNote Why the statement may not run, when executionCertain is false; also part of the diagnostic.
List<SqlFragment>	fragments Ordered provenance fragments.
boolean	partial True when the text still contains placeholder tokens for unbound variables/parameters.
boolean	provenanceIncomplete True unless the materialization is usable and every rendered character has literal provenance.
String	provenNullReason Non-null when the string is SQL NULL for a reason the evaluation proves (a query over a literal relation returned no row), so the site runs nothing on this variant; says why (Mantis 4962).
String	reason Why the string did not reduce; non-null iff sqlText is null.
String	sqlText Usable (possibly placeholder-bearing) SQL text, or null if the string did not reduce.
String	variantPath Stable value-set row-tuple suffix; empty on the scalar compatibility path.

Method Summary

Modifier and Type	Method and Description
boolean	hasCompleteLiteralProvenance()
DynamicSqlLineageResolver.MaterializedSite	mergedWith(DynamicSqlLineageResolver.MaterializedSite other) One variant standing for this one and other, which gives the same text (two bindings with the same result, Mantis 4962): the weaker evidence of the two, so no hole and no uncertainty is lost.
DynamicSqlLineageResolver.MaterializedSite	withNote(String note) The same variant, its diagnostic carrying note too (sources merged when variants coincide).

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

sqlText

public final String sqlText

Usable (possibly placeholder-bearing) SQL text, or null if the string did not reduce.

partial

public final boolean partial

True when the text still contains placeholder tokens for unbound variables/parameters.

provenanceIncomplete

public final boolean provenanceIncomplete

True unless the materialization is usable and every rendered character has literal provenance. This is intentionally stricter than partial: a legacy-CONCRETE numeric/inexact transform can still have a provenance hole that SHADOW must report.

reason

public final String reason

Why the string did not reduce; non-null iff sqlText is null.

fragments

public final List<SqlFragment> fragments

Ordered provenance fragments. When sqlText is non-null their concatenated text equals it (design: dynamic-sql-fragment-provenance-design.md); SHADOW completeness checks and resolved dynamic edges consume that. When the string did not reduce (sqlText null) they are the best-effort provenance of the argument — every hole met, in order, so a consumer can still name the value that stopped the fold; their concatenated text is only how far the fold got. Empty when the producing channel carries no provenance.

diagnostic

public final String diagnostic

Additive analysis note, such as a constant-relation over-approximation.

variantPath

public final String variantPath

Stable value-set row-tuple suffix; empty on the scalar compatibility path.

executionCertain

public final boolean executionCertain

False when the statement may not run on the evaluated path: it sits in a CATCH block, or behind a condition or loop whose outcome is not known. Its text is still what it would run (Mantis 4962).

executionNote

public final String executionNote

Why the statement may not run, when executionCertain is false; also part of the diagnostic.

provenNullReason

public final String provenNullReason

Non-null when the string is SQL NULL for a reason the evaluation proves (a query over a literal relation returned no row), so the site runs nothing on this variant; says why (Mantis 4962).

bindingSource

public final BindingSource bindingSource

The parameter values this variant was evaluated with: none, or the call or caller that supplied them.

Method Detail

hasCompleteLiteralProvenance

public boolean hasCompleteLiteralProvenance()

withNote

public DynamicSqlLineageResolver.MaterializedSite withNote(String note)

The same variant, its diagnostic carrying note too (sources merged when variants coincide).

mergedWith

public DynamicSqlLineageResolver.MaterializedSite mergedWith(DynamicSqlLineageResolver.MaterializedSite other)

One variant standing for this one and other, which gives the same text (two bindings with the same result, Mantis 4962): the weaker evidence of the two, so no hole and no uncertainty is lost. Its provenance is the one with incomplete provenance or more holes; it runs for certain only when both do; its diagnostic and binding name both.