gudusoft.gsqlparser.resolver2

Class NameResolver

Object

gudusoft.gsqlparser.resolver2.NameResolver

public class NameResolver
extends Object

Core component for resolving column references to their sources. Key responsibilities: 1. Resolve TObjectName (column references) using scope tree 2. Handle qualified and unqualified names 3. Detect and report ambiguities 4. Apply GUESS_COLUMN_STRATEGY for ambiguous columns 5. Update TObjectName with resolution results 6. Update ResolutionContext for global querying

Constructor Summary

Constructors

Constructor and Description
NameResolver(INameMatcher nameMatcher, ResolutionContext context) Deprecated. Use NameResolver(TSQLResolverConfig, ResolutionContext) instead
NameResolver(TSQLResolverConfig config, ResolutionContext context) Create a NameResolver with full configuration.

Method Summary

Modifier and Type	Method and Description
List<INamespace>	findNamespacesWithColumn(String columnName, IScope scope)
ResolutionContext	getContext()
INameMatcher	getNameMatcher()
static boolean	isTrinoFamily(EDbVendor vendor) Deprecated. read NestedAccessProfile.forVendor(vendor).isTrinoFamily()
static boolean	readsFieldChains(EDbVendor vendor) Deprecated. read NestedAccessProfile.forVendor(vendor).readsFieldChains()
ResolutionResult	resolve(TObjectName objName, IScope scope)
ResolutionResult	resolveInNamespace(String columnName, INamespace namespace) Resolve a column within a specific namespace (for direct lookups).
void	setBindingTraceRegistry(BindingTraceRegistry registry)

Methods inherited from class Object

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

Constructor Detail

NameResolver

public NameResolver(TSQLResolverConfig config,
                    ResolutionContext context)

Create a NameResolver with full configuration.

Parameters:

config - The resolver configuration (includes name matcher and strategy)

context - The resolution context for tracking results

NameResolver

@Deprecated
public NameResolver(INameMatcher nameMatcher,
                                ResolutionContext context)

Deprecated. Use NameResolver(TSQLResolverConfig, ResolutionContext) instead

Create a NameResolver with just name matcher (backward compatibility). Uses default configuration for GUESS_COLUMN_STRATEGY.

Method Detail

setBindingTraceRegistry

public void setBindingTraceRegistry(BindingTraceRegistry registry)

resolve

public ResolutionResult resolve(TObjectName objName,
                                IScope scope)

isTrinoFamily

@Deprecated
public static boolean isTrinoFamily(EDbVendor vendor)

Deprecated. read NestedAccessProfile.forVendor(vendor).isTrinoFamily()

The Trino family: Athena, Presto, and Trino, which this library parses with the Presto grammar. Trino reads a dotted name whose qualifier names no relation in scope as a column followed by fields of its ROW value, while these PostgreSQL-style grammars fill the name slots as if every qualifier were a table, schema or database: payload.items[1].name as table payload, payload.address.city as schema payload, table address. So in this family TSQLResolver2 reads a column name from its dotted identifiers, a read of a field is a read of its column, and lineage models a STRUCT column as the declared column (Mantis 4811, 4822).

Parameters:

vendor - the vendor of the analysis; a Trino analysis reads statements the Presto grammar stamped dbvpresto

readsFieldChains

@Deprecated
public static boolean readsFieldChains(EDbVendor vendor)

Deprecated. read NestedAccessProfile.forVendor(vendor).readsFieldChains()

The vendors that read a dotted name by what its qualifiers name, as the Trino family does: a qualifier that names a relation in scope is that relation, otherwise the first part is a column and every later part a field of its STRUCT value. Hive, Spark SQL and Databricks resolve payload.name and customer.address.city the same way, so their field reads are reads of the declared column with a field path, and lineage models a STRUCT column as a tree, as for BigQuery and the Trino family (Mantis 4821, 4837).

resolveInNamespace

public ResolutionResult resolveInNamespace(String columnName,
                                           INamespace namespace)

Resolve a column within a specific namespace (for direct lookups).

findNamespacesWithColumn

public List<INamespace> findNamespacesWithColumn(String columnName,
                                                 IScope scope)

getNameMatcher

public INameMatcher getNameMatcher()

getContext

public ResolutionContext getContext()