Package io.trino.plugin.iceberg.catalog

Interface TrinoCatalog

All Known Implementing Classes:

AbstractTrinoCatalog, TrinoGlueCatalog, TrinoHiveCatalog

public interface TrinoCatalog

An interface to allow different Iceberg catalog implementations in IcebergMetadata.

It mimics the Iceberg catalog interface, with the following modifications:

• ConnectorSession is added at the front of each method signature
• String is used to identify namespace instead of Iceberg Namespace, Optional.empty() is used to represent Namespace.empty(). This delegates the handling of multi-level namespace to each implementation
• Similarly, SchemaTableName is used to identify table instead of Iceberg TableIdentifier
• Metadata is a map of string to object instead of string to string
• Additional methods related to authorization are added
• View related methods are currently mostly the same as ones in ConnectorMetadata. These methods will likely be updated once Iceberg view interface is added.

Method Summary

Modifier and Type	Method	Description
void	createMaterializedView(ConnectorSession session, SchemaTableName viewName, ConnectorMaterializedViewDefinition definition, boolean replace, boolean ignoreExisting)
void	createNamespace(ConnectorSession session, String namespace, Map<String,Object> properties, TrinoPrincipal owner)
void	createView(ConnectorSession session, SchemaTableName schemaViewName, ConnectorViewDefinition definition, boolean replace)
String	defaultTableLocation(ConnectorSession session, SchemaTableName schemaTableName)
void	dropMaterializedView(ConnectorSession session, SchemaTableName viewName)
void	dropNamespace(ConnectorSession session, String namespace)
void	dropTable(ConnectorSession session, SchemaTableName schemaTableName)
void	dropView(ConnectorSession session, SchemaTableName schemaViewName)
Optional<ConnectorMaterializedViewDefinition>	getMaterializedView(ConnectorSession session, SchemaTableName viewName)
Optional<TrinoPrincipal>	getNamespacePrincipal(ConnectorSession session, String namespace)
Optional<ConnectorViewDefinition>	getView(ConnectorSession session, SchemaTableName viewName)
Map<SchemaTableName,ConnectorViewDefinition>	getViews(ConnectorSession session, Optional<String> namespace)
List<SchemaTableName>	listMaterializedViews(ConnectorSession session, Optional<String> namespace)
List<String>	listNamespaces(ConnectorSession session)
List<SchemaTableName>	listTables(ConnectorSession session, Optional<String> namespace)
List<SchemaTableName>	listViews(ConnectorSession session, Optional<String> namespace)
Map<String,Object>	loadNamespaceMetadata(ConnectorSession session, String namespace)
org.apache.iceberg.Table	loadTable(ConnectorSession session, SchemaTableName schemaTableName)	load an Iceberg table
org.apache.iceberg.Transaction	newCreateTableTransaction(ConnectorSession session, SchemaTableName schemaTableName, org.apache.iceberg.Schema schema, org.apache.iceberg.PartitionSpec partitionSpec, String location, Map<String,String> properties)
Optional<CatalogSchemaTableName>	redirectTable(ConnectorSession session, SchemaTableName tableName)
void	renameMaterializedView(ConnectorSession session, SchemaTableName source, SchemaTableName target)
void	renameNamespace(ConnectorSession session, String source, String target)
void	renameTable(ConnectorSession session, SchemaTableName from, SchemaTableName to)
void	renameView(ConnectorSession session, SchemaTableName source, SchemaTableName target)
void	setNamespacePrincipal(ConnectorSession session, String namespace, TrinoPrincipal principal)
void	setTablePrincipal(ConnectorSession session, SchemaTableName schemaTableName, TrinoPrincipal principal)
void	setViewPrincipal(ConnectorSession session, SchemaTableName schemaViewName, TrinoPrincipal principal)
void	updateColumnComment(ConnectorSession session, SchemaTableName schemaTableName, ColumnIdentity columnIdentity, Optional<String> comment)
void	updateTableComment(ConnectorSession session, SchemaTableName schemaTableName, Optional<String> comment)
void	updateViewComment(ConnectorSession session, SchemaTableName schemaViewName, Optional<String> comment)

Method Details

listNamespaces

List<String> listNamespaces(ConnectorSession session)

dropNamespace

void dropNamespace(ConnectorSession session,
 String namespace)

loadNamespaceMetadata

Map<String,Object> loadNamespaceMetadata(ConnectorSession session,
 String namespace)

getNamespacePrincipal

Optional<TrinoPrincipal> getNamespacePrincipal(ConnectorSession session,
 String namespace)

createNamespace

void createNamespace(ConnectorSession session,
 String namespace,
 Map<String,Object> properties,
 TrinoPrincipal owner)

setNamespacePrincipal

void setNamespacePrincipal(ConnectorSession session,
 String namespace,
 TrinoPrincipal principal)

renameNamespace

void renameNamespace(ConnectorSession session,
 String source,
 String target)

listTables

List<SchemaTableName> listTables(ConnectorSession session,
 Optional<String> namespace)

newCreateTableTransaction

org.apache.iceberg.Transaction newCreateTableTransaction(ConnectorSession session,
 SchemaTableName schemaTableName,
 org.apache.iceberg.Schema schema,
 org.apache.iceberg.PartitionSpec partitionSpec,
 String location,
 Map<String,String> properties)

dropTable

void dropTable(ConnectorSession session,
 SchemaTableName schemaTableName)

renameTable

void renameTable(ConnectorSession session,
 SchemaTableName from,
 SchemaTableName to)

loadTable

org.apache.iceberg.Table loadTable(ConnectorSession session,
 SchemaTableName schemaTableName)

load an Iceberg table

Parameters:

session - Trino session

schemaTableName - Trino schema and table name

Returns:

Iceberg table loaded

Throws:

UnknownTableTypeException - if table is not of Iceberg type in the metastore

updateTableComment

void updateTableComment(ConnectorSession session,
 SchemaTableName schemaTableName,
 Optional<String> comment)

updateViewComment

void updateViewComment(ConnectorSession session,
 SchemaTableName schemaViewName,
 Optional<String> comment)

defaultTableLocation

String defaultTableLocation(ConnectorSession session,
 SchemaTableName schemaTableName)

setTablePrincipal

void setTablePrincipal(ConnectorSession session,
 SchemaTableName schemaTableName,
 TrinoPrincipal principal)

createView

void createView(ConnectorSession session,
 SchemaTableName schemaViewName,
 ConnectorViewDefinition definition,
 boolean replace)

renameView

void renameView(ConnectorSession session,
 SchemaTableName source,
 SchemaTableName target)

setViewPrincipal

void setViewPrincipal(ConnectorSession session,
 SchemaTableName schemaViewName,
 TrinoPrincipal principal)

dropView

void dropView(ConnectorSession session,
 SchemaTableName schemaViewName)

listViews

List<SchemaTableName> listViews(ConnectorSession session,
 Optional<String> namespace)

getViews

Map<SchemaTableName,ConnectorViewDefinition> getViews(ConnectorSession session,
 Optional<String> namespace)

getView

Optional<ConnectorViewDefinition> getView(ConnectorSession session,
 SchemaTableName viewName)

listMaterializedViews

List<SchemaTableName> listMaterializedViews(ConnectorSession session,
 Optional<String> namespace)

createMaterializedView

void createMaterializedView(ConnectorSession session,
 SchemaTableName viewName,
 ConnectorMaterializedViewDefinition definition,
 boolean replace,
 boolean ignoreExisting)

dropMaterializedView

void dropMaterializedView(ConnectorSession session,
 SchemaTableName viewName)

getMaterializedView

Optional<ConnectorMaterializedViewDefinition> getMaterializedView(ConnectorSession session,
 SchemaTableName viewName)

renameMaterializedView

void renameMaterializedView(ConnectorSession session,
 SchemaTableName source,
 SchemaTableName target)

updateColumnComment

void updateColumnComment(ConnectorSession session,
 SchemaTableName schemaTableName,
 ColumnIdentity columnIdentity,
 Optional<String> comment)

redirectTable

Optional<CatalogSchemaTableName> redirectTable(ConnectorSession session,
 SchemaTableName tableName)