org.apache.flink.table.catalog

Class CatalogManager

java.lang.Object

org.apache.flink.table.catalog.CatalogManager

@Internal
public class CatalogManager
extends Object

A CatalogManager that encapsulates all available catalogs. It also implements the logic of table path resolution.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CatalogManager.TableLookupResult Result of a lookup for a table through getTable(ObjectIdentifier).

Constructor Summary

Constructors

Constructor and Description
CatalogManager(String defaultCatalogName, org.apache.flink.table.catalog.Catalog defaultCatalog)

Method Summary

Modifier and Type	Method and Description
void	alterTable(org.apache.flink.table.catalog.CatalogBaseTable table, org.apache.flink.table.catalog.ObjectIdentifier objectIdentifier, boolean ignoreIfNotExists) Alters a table in a given fully qualified path.
void	createTable(org.apache.flink.table.catalog.CatalogBaseTable table, org.apache.flink.table.catalog.ObjectIdentifier objectIdentifier, boolean ignoreIfExists) Creates a table in a given fully qualified path.
void	createTemporaryTable(org.apache.flink.table.catalog.CatalogBaseTable table, org.apache.flink.table.catalog.ObjectIdentifier objectIdentifier, boolean replace) Creates a temporary table in a given fully qualified path.
void	dropTable(org.apache.flink.table.catalog.ObjectIdentifier objectIdentifier, boolean ignoreIfNotExists) Drops a table in a given fully qualified path.
boolean	dropTemporaryTable(org.apache.flink.table.catalog.UnresolvedIdentifier identifier) Qualifies the given UnresolvedIdentifier with current catalog & database and removes a temporary table registered with this path if it exists.
boolean	dropTemporaryView(org.apache.flink.table.catalog.UnresolvedIdentifier identifier) Qualifies the given UnresolvedIdentifier with current catalog & database and removes a temporary view registered with this path if it exists.
String	getBuiltInCatalogName() Gets the built-in catalog name.
String	getBuiltInDatabaseName() Gets the built-in database name in the built-in catalog.
Optional<org.apache.flink.table.catalog.Catalog>	getCatalog(String catalogName) Gets a catalog by name.
String	getCurrentCatalog() Gets the current catalog that will be used when resolving table path.
String	getCurrentDatabase() Gets the current database name that will be used when resolving table path.
Optional<CatalogManager.TableLookupResult>	getTable(org.apache.flink.table.catalog.ObjectIdentifier objectIdentifier) Retrieves a fully qualified table.
Set<String>	listCatalogs() Retrieves names of all registered catalogs.
Set<String>	listSchemas() Lists all available schemas in the root of the catalog manager.
Set<String>	listSchemas(String catalogName) Lists all available schemas in the given catalog.
Set<String>	listTables() Returns an array of names of all tables (tables and views, both temporary and permanent) registered in the namespace of the current catalog and database.
Set<String>	listTables(String catalogName, String databaseName) Returns an array of names of all tables (tables and views, both temporary and permanent) registered in the namespace of the current catalog and database.
Set<String>	listTemporaryTables() Returns an array of names of temporary tables registered in the namespace of the current catalog and database.
Set<String>	listTemporaryViews() Returns an array of names of temporary views registered in the namespace of the current catalog and database.
org.apache.flink.table.catalog.ObjectIdentifier	qualifyIdentifier(org.apache.flink.table.catalog.UnresolvedIdentifier identifier) Returns the full name of the given table path, this name may be padded with current catalog/database name based on the identifier's length.
void	registerCatalog(String catalogName, org.apache.flink.table.catalog.Catalog catalog) Registers a catalog under the given name.
boolean	schemaExists(String catalogName) Checks if there is a catalog with given name or is there a temporary object registered within a given catalog.
boolean	schemaExists(String catalogName, String databaseName) Checks if there is a database with given name in a given catalog or is there a temporary object registered within a given catalog and database.
void	setCurrentCatalog(String catalogName) Sets the current catalog name that will be used when resolving table path.
void	setCurrentDatabase(String databaseName) Sets the current database name that will be used when resolving a table path.

Methods inherited from class java.lang.Object

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

Constructor Detail

CatalogManager

public CatalogManager(String defaultCatalogName,
                      org.apache.flink.table.catalog.Catalog defaultCatalog)

Method Detail

registerCatalog

public void registerCatalog(String catalogName,
                            org.apache.flink.table.catalog.Catalog catalog)

Registers a catalog under the given name. The catalog name must be unique.

Parameters:

catalogName - name under which to register the given catalog

catalog - catalog to register

Throws:

org.apache.flink.table.catalog.exceptions.CatalogException - if the registration of the catalog under the given name failed

getCatalog

public Optional<org.apache.flink.table.catalog.Catalog> getCatalog(String catalogName)

Gets a catalog by name.

Parameters:

catalogName - name of the catalog to retrieve

Returns:

the requested catalog or empty if it does not exist

getCurrentCatalog

public String getCurrentCatalog()

Gets the current catalog that will be used when resolving table path.

Returns:

the current catalog

See Also:

qualifyIdentifier(UnresolvedIdentifier)

setCurrentCatalog

public void setCurrentCatalog(String catalogName)
                       throws org.apache.flink.table.api.CatalogNotExistException

Sets the current catalog name that will be used when resolving table path.

Parameters:

catalogName - catalog name to set as current catalog

Throws:

org.apache.flink.table.api.CatalogNotExistException - thrown if the catalog doesn't exist

See Also:

qualifyIdentifier(UnresolvedIdentifier)

getCurrentDatabase

public String getCurrentDatabase()

Gets the current database name that will be used when resolving table path.

Returns:

the current database

See Also:

qualifyIdentifier(UnresolvedIdentifier)

setCurrentDatabase

public void setCurrentDatabase(String databaseName)

Sets the current database name that will be used when resolving a table path. The database has to exist in the current catalog.

Parameters:

databaseName - database name to set as current database name

Throws:

org.apache.flink.table.catalog.exceptions.CatalogException - thrown if the database doesn't exist in the current catalog

See Also:

qualifyIdentifier(UnresolvedIdentifier), setCurrentCatalog(String)

getBuiltInCatalogName

public String getBuiltInCatalogName()

Gets the built-in catalog name. The built-in catalog is used for storing all non-serializable transient meta-objects.

Returns:

the built-in catalog name

getBuiltInDatabaseName

public String getBuiltInDatabaseName()

Gets the built-in database name in the built-in catalog. The built-in database is used for storing all non-serializable transient meta-objects.

Returns:

the built-in database name

getTable

public Optional<CatalogManager.TableLookupResult> getTable(org.apache.flink.table.catalog.ObjectIdentifier objectIdentifier)

Retrieves a fully qualified table. If the path is not yet fully qualified use qualifyIdentifier(UnresolvedIdentifier) first.

Parameters:

objectIdentifier - full path of the table to retrieve

Returns:

table that the path points to.

listCatalogs

public Set<String> listCatalogs()

Retrieves names of all registered catalogs.

Returns:

a set of names of registered catalogs

listTables

public Set<String> listTables()

Returns an array of names of all tables (tables and views, both temporary and permanent) registered in the namespace of the current catalog and database.

Returns:

names of all registered tables

listTables

public Set<String> listTables(String catalogName,
                              String databaseName)

Returns an array of names of all tables (tables and views, both temporary and permanent) registered in the namespace of the current catalog and database.

Returns:

names of all registered tables

listTemporaryTables

public Set<String> listTemporaryTables()

Returns an array of names of temporary tables registered in the namespace of the current catalog and database.

Returns:

names of registered temporary tables

listTemporaryViews

public Set<String> listTemporaryViews()

Returns an array of names of temporary views registered in the namespace of the current catalog and database.

Returns:

names of registered temporary views

listSchemas

public Set<String> listSchemas()

Lists all available schemas in the root of the catalog manager. It is not equivalent to listing all catalogs as it includes also different catalog parts of the temporary objects. NOTE:It is primarily used for interacting with Calcite's schema.

Returns:

list of schemas in the root of catalog manager

listSchemas

public Set<String> listSchemas(String catalogName)

Lists all available schemas in the given catalog. It is not equivalent to listing databases within the given catalog as it includes also different database parts of the temporary objects identifiers. NOTE:It is primarily used for interacting with Calcite's schema.

Parameters:

catalogName - filter for the catalog part of the schema

Returns:

list of schemas with the given prefix

schemaExists

public boolean schemaExists(String catalogName)

Checks if there is a catalog with given name or is there a temporary object registered within a given catalog. NOTE:It is primarily used for interacting with Calcite's schema.

Parameters:

catalogName - filter for the catalog part of the schema

Returns:

true if a subschema exists

schemaExists

public boolean schemaExists(String catalogName,
                            String databaseName)

Checks if there is a database with given name in a given catalog or is there a temporary object registered within a given catalog and database. NOTE:It is primarily used for interacting with Calcite's schema.

Parameters:

catalogName - filter for the catalog part of the schema

databaseName - filter for the database part of the schema

Returns:

true if a subschema exists

qualifyIdentifier

public org.apache.flink.table.catalog.ObjectIdentifier qualifyIdentifier(org.apache.flink.table.catalog.UnresolvedIdentifier identifier)

Returns the full name of the given table path, this name may be padded with current catalog/database name based on the identifier's length.

Parameters:

identifier - an unresolved identifier

Returns:

a fully qualified object identifier

createTable

public void createTable(org.apache.flink.table.catalog.CatalogBaseTable table,
                        org.apache.flink.table.catalog.ObjectIdentifier objectIdentifier,
                        boolean ignoreIfExists)

Creates a table in a given fully qualified path.

Parameters:

table - The table to put in the given path.

objectIdentifier - The fully qualified path where to put the table.

ignoreIfExists - If false exception will be thrown if a table exists in the given path.

createTemporaryTable

public void createTemporaryTable(org.apache.flink.table.catalog.CatalogBaseTable table,
                                 org.apache.flink.table.catalog.ObjectIdentifier objectIdentifier,
                                 boolean replace)

Creates a temporary table in a given fully qualified path.

Parameters:

table - The table to put in the given path.

objectIdentifier - The fully qualified path where to put the table.

replace - controls what happens if a table exists in the given path, if true the table is replaced, an exception will be thrown otherwise

dropTemporaryTable

public boolean dropTemporaryTable(org.apache.flink.table.catalog.UnresolvedIdentifier identifier)

Qualifies the given UnresolvedIdentifier with current catalog & database and removes a temporary table registered with this path if it exists.

Parameters:

identifier - potentially unresolved identifier

Returns:

true if a table with a given identifier existed and was removed, false otherwise

dropTemporaryView

public boolean dropTemporaryView(org.apache.flink.table.catalog.UnresolvedIdentifier identifier)

Qualifies the given UnresolvedIdentifier with current catalog & database and removes a temporary view registered with this path if it exists.

Parameters:

identifier - potentially unresolved identifier

Returns:

true if a view with a given identifier existed and was removed, false otherwise

alterTable

public void alterTable(org.apache.flink.table.catalog.CatalogBaseTable table,
                       org.apache.flink.table.catalog.ObjectIdentifier objectIdentifier,
                       boolean ignoreIfNotExists)

Alters a table in a given fully qualified path.

Parameters:

table - The table to put in the given path

objectIdentifier - The fully qualified path where to alter the table.

ignoreIfNotExists - If false exception will be thrown if the table or database or catalog to be altered does not exist.

dropTable

public void dropTable(org.apache.flink.table.catalog.ObjectIdentifier objectIdentifier,
                      boolean ignoreIfNotExists)

Drops a table in a given fully qualified path.

Parameters:

objectIdentifier - The fully qualified path of the table to drop.

ignoreIfNotExists - If false exception will be thrown if the table or database or catalog to be altered does not exist.