Package io.trino.plugin.iceberg.catalog

Interface TrinoCatalog

All Known Implementing Classes:

AbstractTrinoCatalog, TrinoGlueCatalog, TrinoHiveCatalog, TrinoJdbcCatalog, TrinoRestCatalog

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
boolean	namespaceExists(ConnectorSession session, String namespace)
org.apache.iceberg.Transaction	newCreateTableTransaction(ConnectorSession session, SchemaTableName schemaTableName, org.apache.iceberg.Schema schema, org.apache.iceberg.PartitionSpec partitionSpec, org.apache.iceberg.SortOrder sortOrder, String location, Map<String,String> properties)
Optional<CatalogSchemaTableName>	redirectTable(ConnectorSession session, SchemaTableName tableName)
void	registerTable(ConnectorSession session, SchemaTableName tableName, String tableLocation, String metadataLocation)
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	unregisterTable(ConnectorSession session, SchemaTableName tableName)
void	updateColumnComment(ConnectorSession session, SchemaTableName schemaTableName, ColumnIdentity columnIdentity, Optional<String> comment)
void	updateTableComment(ConnectorSession session, SchemaTableName schemaTableName, Optional<String> comment)
void	updateViewColumnComment(ConnectorSession session, SchemaTableName schemaViewName, String columnName, Optional<String> comment)
void	updateViewComment(ConnectorSession session, SchemaTableName schemaViewName, Optional<String> comment)

Method Details

namespaceExists

boolean namespaceExists(ConnectorSession session,
 String namespace)

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,
 org.apache.iceberg.SortOrder sortOrder,
 String location,
 Map<String,String> properties)

registerTable

void registerTable(ConnectorSession session,
 SchemaTableName tableName,
 String tableLocation,
 String metadataLocation)

unregisterTable

void unregisterTable(ConnectorSession session,
 SchemaTableName tableName)

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)

updateViewColumnComment

void updateViewColumnComment(ConnectorSession session,
 SchemaTableName schemaViewName,
 String columnName,
 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)