gudusoft.gsqlparser.lineage.v2.producer

Class IdentityPolicy

Object

gudusoft.gsqlparser.lineage.v2.producer.IdentityPolicy

public final class IdentityPolicy
extends Object

Whether an analysis may mint portable SQL-LR identities, and with which key function.

The standard's rule data, not GSP's name service, decides a document's canonical keys, so a portable identity is only honest when GSP analyses under the same naming policy that the dependency snapshot declares (lineage-spec/snapshots/FORMAT.md, Section 6: different settings are a different snapshot). The producer ships one snapshot, the draft snapshot, so:

• a dialect outside the snapshot's six rule sets mints no portable identity (its endpoints are LOCAL);
• for one of the six, the analysis must run under GSP's default profile for the vendor, whose flags are the snapshot's effective flags and collations; any other effective profile (other flags, a group or object-type override) is refused with SqllrProducerException, never published under a snapshot that does not describe it.

Since:

4.2.17

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONFIGURATION_UNSUPPORTED The error code of a refused configuration.

Method Summary

Modifier and Type	Method and Description
static String	dialectCode(EDbVendor vendor) The SQL-LR dialect code of a vendor whose identifier rules the draft snapshot carries, or null.
String	getDialect() The dialect code, or null when the vendor mints no portable identity.
SegmentKeyV1	getKeys() The key function; null when isPortable() is false.
String	getSnapshotId() The id of the snapshot in force: the shipped one, also for a dialect outside its rule sets, whose analysis still runs under its algorithms, profiles and canonical forms and mints no portable identity (the analysis context requires the id, spec Section 6.2; plan 06 gate E4).
EDbVendor	getVendor()
boolean	isPortable() Whether endpoints of this analysis can be PORTABLE at all.
static IdentityPolicy	of(EDbVendor vendor, IdentifierProfile effective) The policy of one analysis.
static Map<EDbVendor,String>	portableVendors() The vendors that can mint portable identities.

Methods inherited from class Object

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

Field Detail

CONFIGURATION_UNSUPPORTED

public static final String CONFIGURATION_UNSUPPORTED

The error code of a refused configuration.

See Also:

Constant Field Values

Method Detail

dialectCode

public static String dialectCode(EDbVendor vendor)

The SQL-LR dialect code of a vendor whose identifier rules the draft snapshot carries, or null. Derived dialects (Greenplum, Redshift, GaussDB, ...) are not mapped: their naming rules are not the parent's.

portableVendors

public static Map<EDbVendor,String> portableVendors()

The vendors that can mint portable identities.

of

public static IdentityPolicy of(EDbVendor vendor,
                                IdentifierProfile effective)

The policy of one analysis.

Parameters:

vendor - the analysed vendor

effective - the analysis's frozen identifier profile; null means the vendor default

Throws:

SqllrProducerException - CONFIGURATION_UNSUPPORTED when the vendor has a rule set but the profile differs from the vendor default the draft snapshot describes

getVendor

public EDbVendor getVendor()

getDialect

public String getDialect()

The dialect code, or null when the vendor mints no portable identity.

isPortable

public boolean isPortable()

Whether endpoints of this analysis can be PORTABLE at all.

getKeys

public SegmentKeyV1 getKeys()

The key function; null when isPortable() is false.

getSnapshotId

public String getSnapshotId()

The id of the snapshot in force: the shipped one, also for a dialect outside its rule sets, whose analysis still runs under its algorithms, profiles and canonical forms and mints no portable identity (the analysis context requires the id, spec Section 6.2; plan 06 gate E4).