gudusoft.gsqlparser.catalog.runtime

Enum CatalogHierarchy

Object

Enum<CatalogHierarchy>

gudusoft.gsqlparser.catalog.runtime.CatalogHierarchy

All Implemented Interfaces:

Serializable, Comparable<CatalogHierarchy>

public enum CatalogHierarchy
extends Enum<CatalogHierarchy>

Which container levels a namespace HAS — declared, never inferred (stage S0R of docs/refactor/identifier_identity_display_separation_plan.md).

Why a resolved identity needs this

Whether db.t is a complete identity depends on whether the namespace has a schema level. On MySQL it does not, so db.t names a table completely. On Oracle it does, so db.t is a name with an UNRESOLVED schema — and keying it as though it were complete makes it collide with the same table name in a different schema. The component list alone cannot tell those apart: both are "a catalog and an object". So the topology is declared, and validation checks the components against the declaration rather than guessing the declaration from the components.

IdentifierComponentRole.SERVER is deliberately not part of a topology. Every namespace can be reached through a link, and a name without a server means the local one — its absence is not a missing level.

Enum Constant Summary

Enum Constants

Enum Constant and Description
CATALOG_ONLY A catalog (database) but no schema level: MySQL, Teradata, Hive, Impala.
CATALOG_SCHEMA Catalog and schema both exist: Oracle, SQL Server, PostgreSQL, Snowflake, most dialects.
ROOT_ONLY Objects at the root, with no container level at all.
SCHEMA_ONLY A schema with no catalog above it — a rootless topology.

Method Summary

Modifier and Type	Method and Description
List<IdentifierComponentRole>	containers() The container roles this topology has, outermost first.
boolean	has(IdentifierComponentRole role) Whether this topology has the given container level.
boolean	hasCatalog()
boolean	hasSchema()
static CatalogHierarchy	valueOf(String name) Returns the enum constant of this type with the specified name.
static CatalogHierarchy[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

CATALOG_SCHEMA

public static final CatalogHierarchy CATALOG_SCHEMA

Catalog and schema both exist: Oracle, SQL Server, PostgreSQL, Snowflake, most dialects.

CATALOG_ONLY

public static final CatalogHierarchy CATALOG_ONLY

A catalog (database) but no schema level: MySQL, Teradata, Hive, Impala.

SCHEMA_ONLY

public static final CatalogHierarchy SCHEMA_ONLY

A schema with no catalog above it — a rootless topology.

ROOT_ONLY

public static final CatalogHierarchy ROOT_ONLY

Objects at the root, with no container level at all.

Method Detail

values

public static CatalogHierarchy[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (CatalogHierarchy c : CatalogHierarchy.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static CatalogHierarchy valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

hasCatalog

public boolean hasCatalog()

hasSchema

public boolean hasSchema()

containers

public List<IdentifierComponentRole> containers()

The container roles this topology has, outermost first. Never includes SERVER.

has

public boolean has(IdentifierComponentRole role)

Whether this topology has the given container level.

Only CATALOG and SCHEMA are topology questions. IdentifierComponentRole.SERVER is refused rather than answered true: a server is an optional endpoint qualifier, not a level a topology can lack, and answering "yes, always" contradicted this class's own definition.