org.apache.flink.table.catalog

Class ResolvedCatalogTable

java.lang.Object

org.apache.flink.table.catalog.ResolvedCatalogTable

All Implemented Interfaces:

CatalogBaseTable, CatalogTable, ResolvedCatalogBaseTable<CatalogTable>

@PublicEvolving
public final class ResolvedCatalogTable
extends Object
implements ResolvedCatalogBaseTable<CatalogTable>, CatalogTable

A validated CatalogTable that is backed by the original metadata coming from the Catalog but resolved by the framework.

Note: Compared to CatalogTable, instances of this class are serializable into a map of string properties.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.flink.table.catalog.CatalogBaseTable

CatalogBaseTable.TableKind

Constructor Summary

Constructors

Constructor and Description
ResolvedCatalogTable(CatalogTable origin, ResolvedSchema resolvedSchema)

Method Summary

Modifier and Type	Method and Description
CatalogBaseTable	copy() Get a deep copy of the CatalogBaseTable instance.
ResolvedCatalogTable	copy(Map<String,String> options) Returns a copy of this CatalogTable with given table options options.
String	getComment() Get comment of the table or view.
Optional<String>	getDescription() Get a brief description of the table or view.
Optional<String>	getDetailedDescription() Get a detailed description of the table or view.
Map<String,String>	getOptions() Returns a map of string-based options.
CatalogTable	getOrigin() Returns the original, unresolved metadata object from the Catalog.
List<String>	getPartitionKeys() Get the partition keys of the table.
ResolvedSchema	getResolvedSchema() Returns a fully resolved and validated ResolvedSchema.
Schema	getUnresolvedSchema() Returns the schema of the table or view.
boolean	isPartitioned() Check if the table is partitioned or not.
Map<String,String>	toProperties() Serializes this instance into a map of string-based properties.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.flink.table.catalog.ResolvedCatalogBaseTable

getSchema

Methods inherited from interface org.apache.flink.table.catalog.CatalogTable

fromProperties, getTableKind, of

Constructor Detail

ResolvedCatalogTable

public ResolvedCatalogTable(CatalogTable origin,
                            ResolvedSchema resolvedSchema)

Method Detail

getOrigin

public CatalogTable getOrigin()

Description copied from interface: ResolvedCatalogBaseTable

Returns the original, unresolved metadata object from the Catalog.

This method might be useful if catalog-specific object instances should be directly forwarded from the catalog to a factory.

Specified by:

getOrigin in interface ResolvedCatalogBaseTable<CatalogTable>

getResolvedSchema

public ResolvedSchema getResolvedSchema()

Description copied from interface: ResolvedCatalogBaseTable

Returns a fully resolved and validated ResolvedSchema.

Connectors can configure themselves by accessing ResolvedSchema.getPrimaryKey() and ResolvedSchema.toPhysicalRowDataType().

Specified by:

getResolvedSchema in interface ResolvedCatalogBaseTable<CatalogTable>

toProperties

public Map<String,String> toProperties()

Description copied from interface: CatalogTable

Serializes this instance into a map of string-based properties.

Compared to the pure table options in CatalogBaseTable.getOptions(), the map includes schema, partitioning, and other characteristics in a serialized form.

Specified by:

toProperties in interface CatalogTable

getOptions

public Map<String,String> getOptions()

Description copied from interface: CatalogBaseTable

Returns a map of string-based options.

In case of CatalogTable, these options may determine the kind of connector and its configuration for accessing the data in the external system. See DynamicTableFactory for more information.

Specified by:

getOptions in interface CatalogBaseTable

getUnresolvedSchema

public Schema getUnresolvedSchema()

Description copied from interface: CatalogBaseTable

Returns the schema of the table or view.

The schema can reference objects from other catalogs and will be resolved and validated by the framework when accessing the table or view.

Specified by:

getUnresolvedSchema in interface CatalogBaseTable

See Also:

ResolvedCatalogTable, ResolvedCatalogView

getComment

public String getComment()

Description copied from interface: CatalogBaseTable

Get comment of the table or view.

Specified by:

getComment in interface CatalogBaseTable

Returns:

comment of the table/view.

copy

public CatalogBaseTable copy()

Description copied from interface: CatalogBaseTable

Get a deep copy of the CatalogBaseTable instance.

Specified by:

copy in interface CatalogBaseTable

Returns:

a copy of the CatalogBaseTable instance

getDescription

public Optional<String> getDescription()

Description copied from interface: CatalogBaseTable

Get a brief description of the table or view.

Specified by:

getDescription in interface CatalogBaseTable

Returns:

an optional short description of the table/view

getDetailedDescription

public Optional<String> getDetailedDescription()

Description copied from interface: CatalogBaseTable

Get a detailed description of the table or view.

Specified by:

getDetailedDescription in interface CatalogBaseTable

Returns:

an optional long description of the table/view

isPartitioned

public boolean isPartitioned()

Description copied from interface: CatalogTable

Check if the table is partitioned or not.

Specified by:

isPartitioned in interface CatalogTable

Returns:

true if the table is partitioned; otherwise, false

getPartitionKeys

public List<String> getPartitionKeys()

Description copied from interface: CatalogTable

Get the partition keys of the table. This will be an empty set if the table is not partitioned.

Specified by:

getPartitionKeys in interface CatalogTable

Returns:

partition keys of the table

copy

public ResolvedCatalogTable copy(Map<String,String> options)

Description copied from interface: CatalogTable

Returns a copy of this CatalogTable with given table options options.

Specified by:

copy in interface CatalogTable

Returns:

a new copy of this table with replaced table options