com.facebook.presto.spi.connector.classloader

Class ClassLoaderSafeConnectorMetadata

java.lang.Object

com.facebook.presto.spi.connector.classloader.ClassLoaderSafeConnectorMetadata

All Implemented Interfaces:

ConnectorMetadata

public class ClassLoaderSafeConnectorMetadata
extends Object
implements ConnectorMetadata

Constructor Summary

Constructors

Constructor and Description
ClassLoaderSafeConnectorMetadata(ConnectorMetadata delegate, ClassLoader classLoader)

Method Summary

Modifier and Type	Method and Description
void	addColumn(ConnectorSession session, ConnectorTableHandle tableHandle, ColumnMetadata column) Add the specified column
ConnectorOutputTableHandle	beginCreateTable(ConnectorSession session, ConnectorTableMetadata tableMetadata, Optional<ConnectorNewTableLayout> layout) Begin the atomic creation of a table with data.
ConnectorTableHandle	beginDelete(ConnectorSession session, ConnectorTableHandle tableHandle) Begin delete query
ConnectorInsertTableHandle	beginInsert(ConnectorSession session, ConnectorTableHandle tableHandle) Begin insert query
void	beginQuery(ConnectorSession session) Start a SELECT/UPDATE/INSERT/DELETE query.
ConnectorInsertTableHandle	beginRefreshMaterializedView(ConnectorSession session, ConnectorTableHandle tableHandle) Begin refresh materialized view
ConnectorTableHandle	beginStatisticsCollection(ConnectorSession session, ConnectorTableHandle tableHandle) Begin statistics collection
void	cleanupQuery(ConnectorSession session) Cleanup after a SELECT/UPDATE/INSERT/DELETE query.
CompletableFuture<Void>	commitPageSinkAsync(ConnectorSession session, ConnectorInsertTableHandle tableHandle, Collection<io.airlift.slice.Slice> fragments) Commits page sink for table insertion.
CompletableFuture<Void>	commitPageSinkAsync(ConnectorSession session, ConnectorOutputTableHandle tableHandle, Collection<io.airlift.slice.Slice> fragments) Commits page sink for table creation.
void	createMaterializedView(ConnectorSession session, ConnectorTableMetadata viewMetadata, ConnectorMaterializedViewDefinition viewDefinition, boolean ignoreExisting) Create the specified materialized view.
void	createRole(ConnectorSession session, String role, Optional<PrestoPrincipal> grantor) Creates the specified role.
void	createSchema(ConnectorSession session, String schemaName, Map<String,Object> properties) Creates a schema.
void	createTable(ConnectorSession session, ConnectorTableMetadata tableMetadata, boolean ignoreExisting) Creates a table using the specified table metadata.
ConnectorTableHandle	createTemporaryTable(ConnectorSession session, List<ColumnMetadata> columns, Optional<ConnectorPartitioningMetadata> partitioningMetadata) Creates a temporary table with optional partitioning requirements.
void	createView(ConnectorSession session, ConnectorTableMetadata viewMetadata, String viewData, boolean replace) Create the specified view.
void	doMetadataUpdateCleanup(QueryId queryId)
void	dropColumn(ConnectorSession session, ConnectorTableHandle tableHandle, ColumnHandle column) Drop the specified column
void	dropMaterializedView(ConnectorSession session, SchemaTableName viewName) Drop the specified materialized view.
void	dropRole(ConnectorSession session, String role) Drops the specified role.
void	dropSchema(ConnectorSession session, String schemaName) Drops the specified schema.
void	dropTable(ConnectorSession session, ConnectorTableHandle tableHandle) Drops the specified table
void	dropView(ConnectorSession session, SchemaTableName viewName) Drop the specified view.
Optional<ConnectorOutputMetadata>	finishCreateTable(ConnectorSession session, ConnectorOutputTableHandle tableHandle, Collection<io.airlift.slice.Slice> fragments, Collection<ComputedStatistics> computedStatistics) Finish a table creation with data after the data is written.
void	finishDelete(ConnectorSession session, ConnectorTableHandle tableHandle, Collection<io.airlift.slice.Slice> fragments) Finish delete query
Optional<ConnectorOutputMetadata>	finishInsert(ConnectorSession session, ConnectorInsertTableHandle insertHandle, Collection<io.airlift.slice.Slice> fragments, Collection<ComputedStatistics> computedStatistics) Finish insert query
Optional<ConnectorOutputMetadata>	finishRefreshMaterializedView(ConnectorSession session, ConnectorInsertTableHandle insertHandle, Collection<io.airlift.slice.Slice> fragments, Collection<ComputedStatistics> computedStatistics) Finish refresh materialized view
void	finishStatisticsCollection(ConnectorSession session, ConnectorTableHandle tableHandle, Collection<ComputedStatistics> computedStatistics) Finish statistics collection
ConnectorTableLayoutHandle	getAlternativeLayoutHandle(ConnectorSession session, ConnectorTableLayoutHandle tableLayoutHandle, ConnectorPartitioningHandle partitioningHandle) Return a table layout handle whose partitioning is converted to the provided partitioning handle, but otherwise identical to the provided table layout handle.
Map<String,ColumnHandle>	getColumnHandles(ConnectorSession session, ConnectorTableHandle tableHandle) Gets all of the columns on the specified table, or an empty map if the columns can not be enumerated.
ColumnMetadata	getColumnMetadata(ConnectorSession session, ConnectorTableHandle tableHandle, ColumnHandle columnHandle) Gets the metadata for the specified table column.
Optional<ConnectorPartitioningHandle>	getCommonPartitioningHandle(ConnectorSession session, ConnectorPartitioningHandle left, ConnectorPartitioningHandle right) Return a partitioning handle which the connector can transparently convert both left and right into.
Optional<Object>	getInfo(ConnectorTableLayoutHandle table) Return the connector-specific metadata for the specified table layout.
Optional<ConnectorNewTableLayout>	getInsertLayout(ConnectorSession session, ConnectorTableHandle tableHandle) Get the physical layout for a inserting into an existing table.
Optional<ConnectorMaterializedViewDefinition>	getMaterializedView(ConnectorSession session, SchemaTableName viewName) Gets the materialized view data for the specified materialized view name.
MaterializedViewStatus	getMaterializedViewStatus(ConnectorSession session, SchemaTableName materializedViewName)
MaterializedViewStatus	getMaterializedViewStatus(ConnectorSession session, SchemaTableName materializedViewName, TupleDomain<String> baseQueryDomain) Get the materialized view status to inform the engine how much data has been materialized in the view
List<ConnectorMetadataUpdateHandle>	getMetadataUpdateResults(List<ConnectorMetadataUpdateHandle> metadataUpdateRequests, QueryId queryId) Handles metadata update requests and sends the results back to worker
Optional<ConnectorNewTableLayout>	getNewTableLayout(ConnectorSession session, ConnectorTableMetadata tableMetadata) Get the physical layout for a new table.
ConnectorPartitioningHandle	getPartitioningHandleForExchange(ConnectorSession session, int partitionCount, List<Type> partitionTypes) Provides partitioning handle for exchange.
Optional<ConnectorNewTableLayout>	getPreferredShuffleLayoutForInsert(ConnectorSession session, ConnectorTableHandle tableHandle) A connector can have preferred shuffle layout for table write.
Optional<ConnectorNewTableLayout>	getPreferredShuffleLayoutForNewTable(ConnectorSession session, ConnectorTableMetadata tableMetadata) A connector can have preferred shuffle layout for table write.
Optional<List<SchemaTableName>>	getReferencedMaterializedViews(ConnectorSession session, SchemaTableName tableName) Gets the referenced materialized views for a give table
TableStatisticsMetadata	getStatisticsCollectionMetadata(ConnectorSession session, ConnectorTableMetadata tableMetadata) Describe statistics that must be collected during a statistics collection
TableStatisticsMetadata	getStatisticsCollectionMetadataForWrite(ConnectorSession session, ConnectorTableMetadata tableMetadata) Describes statistics that must be collected during a write.
Optional<SystemTable>	getSystemTable(ConnectorSession session, SchemaTableName tableName) Returns the system table for the specified table name, if one exists.
ConnectorTableHandle	getTableHandle(ConnectorSession session, SchemaTableName tableName) Returns a table handle for the specified table name, or null if the connector does not contain the table.
ConnectorTableHandle	getTableHandleForStatisticsCollection(ConnectorSession session, SchemaTableName tableName, Map<String,Object> analyzeProperties) Returns a table handle for the specified table name, or null if the connector does not contain the table.
ConnectorTableLayout	getTableLayout(ConnectorSession session, ConnectorTableLayoutHandle handle)
TableLayoutFilterCoverage	getTableLayoutFilterCoverage(ConnectorTableLayoutHandle tableHandle, Set<String> relevantPartitionColumns)
List<ConnectorTableLayoutResult>	getTableLayouts(ConnectorSession session, ConnectorTableHandle table, Constraint<ColumnHandle> constraint, Optional<Set<ColumnHandle>> desiredColumns) Return a list of table layouts that satisfy the given constraint.
ConnectorTableMetadata	getTableMetadata(ConnectorSession session, ConnectorTableHandle table) Return the metadata for the specified table handle.
TableStatistics	getTableStatistics(ConnectorSession session, ConnectorTableHandle tableHandle, Optional<ConnectorTableLayoutHandle> tableLayoutHandle, List<ColumnHandle> columnHandles, Constraint<ColumnHandle> constraint) Get statistics for table for given columns and filtering constraint.
ColumnHandle	getUpdateRowIdColumnHandle(ConnectorSession session, ConnectorTableHandle tableHandle) Get the column handle that will generate row IDs for the delete operation.
Map<SchemaTableName,ConnectorViewDefinition>	getViews(ConnectorSession session, SchemaTablePrefix prefix) Gets the view data for views that match the specified table prefix.
void	grantRoles(ConnectorSession connectorSession, Set<String> roles, Set<PrestoPrincipal> grantees, boolean withAdminOption, Optional<PrestoPrincipal> grantor) Grants the specified roles to the specified grantees
void	grantTablePrivileges(ConnectorSession session, SchemaTableName tableName, Set<Privilege> privileges, PrestoPrincipal grantee, boolean grantOption) Grants the specified privilege to the specified user on the specified table
boolean	isLegacyGetLayoutSupported(ConnectorSession session, ConnectorTableHandle tableHandle) Experimental: if true, the engine will invoke getLayout otherwise, getLayout will not be called.
boolean	isRefinedPartitioningOver(ConnectorSession session, ConnectorPartitioningHandle left, ConnectorPartitioningHandle right) Partitioning a = {a_1, ...
Set<RoleGrant>	listApplicableRoles(ConnectorSession session, PrestoPrincipal principal) List applicable roles, including the transitive grants, for the specified principal
Set<String>	listEnabledRoles(ConnectorSession session) List applicable roles, including the transitive grants, in given session
Set<RoleGrant>	listRoleGrants(ConnectorSession session, PrestoPrincipal principal) List role grants for a given principal, not recursively.
Set<String>	listRoles(ConnectorSession session) List available roles.
List<String>	listSchemaNames(ConnectorSession session) Returns the schemas provided by this connector.
Map<SchemaTableName,List<ColumnMetadata>>	listTableColumns(ConnectorSession session, SchemaTablePrefix prefix) Gets the metadata for all columns that match the specified table prefix.
List<GrantInfo>	listTablePrivileges(ConnectorSession session, SchemaTablePrefix prefix) List the table privileges granted to the specified grantee for the tables that have the specified prefix considering the selected session role
List<SchemaTableName>	listTables(ConnectorSession session, Optional<String> schemaName) List table names, possibly filtered by schema.
List<SchemaTableName>	listTables(ConnectorSession session, String schemaNameOrNull) List table names, possibly filtered by schema.
List<SchemaTableName>	listViews(ConnectorSession session, Optional<String> schemaName)
List<SchemaTableName>	listViews(ConnectorSession session, String schemaNameOrNull) List view names, possibly filtered by schema.
OptionalLong	metadataDelete(ConnectorSession session, ConnectorTableHandle tableHandle, ConnectorTableLayoutHandle tableLayoutHandle) Delete the provided table layout
void	renameColumn(ConnectorSession session, ConnectorTableHandle tableHandle, ColumnHandle source, String target) Rename the specified column
void	renameSchema(ConnectorSession session, String source, String target) Renames the specified schema.
void	renameTable(ConnectorSession session, ConnectorTableHandle tableHandle, SchemaTableName newTableName) Rename the specified table
Optional<ConnectorResolvedIndex>	resolveIndex(ConnectorSession session, ConnectorTableHandle tableHandle, Set<ColumnHandle> indexableColumns, Set<ColumnHandle> outputColumns, TupleDomain<ColumnHandle> tupleDomain) Try to locate a table index that can lookup results by indexableColumns and provide the requested outputColumns.
void	revokeRoles(ConnectorSession connectorSession, Set<String> roles, Set<PrestoPrincipal> grantees, boolean adminOptionFor, Optional<PrestoPrincipal> grantor) Revokes the specified roles from the specified grantees
void	revokeTablePrivileges(ConnectorSession session, SchemaTableName tableName, Set<Privilege> privileges, PrestoPrincipal grantee, boolean grantOption) Revokes the specified privilege on the specified table from the specified user
boolean	schemaExists(ConnectorSession session, String schemaName) Checks if a schema exists.
boolean	supportsMetadataDelete(ConnectorSession session, ConnectorTableHandle tableHandle, Optional<ConnectorTableLayoutHandle> tableLayoutHandle)
TupleDomain<ColumnHandle>	toExplainIOConstraints(ConnectorSession session, ConnectorTableHandle tableHandle, TupleDomain<ColumnHandle> constraints) Returns a TupleDomain of constraints that is suitable for ExplainIO
void	truncateTable(ConnectorSession session, ConnectorTableHandle tableHandle) Truncates the specified table

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassLoaderSafeConnectorMetadata

public ClassLoaderSafeConnectorMetadata(ConnectorMetadata delegate,
                                        ClassLoader classLoader)

Method Detail

getTableLayouts

public List<ConnectorTableLayoutResult> getTableLayouts(ConnectorSession session,
                                                        ConnectorTableHandle table,
                                                        Constraint<ColumnHandle> constraint,
                                                        Optional<Set<ColumnHandle>> desiredColumns)

Description copied from interface: ConnectorMetadata

Return a list of table layouts that satisfy the given constraint.

For each layout, connectors must return an "unenforced constraint" representing the part of the constraint summary that isn't guaranteed by the layout.

Specified by:

getTableLayouts in interface ConnectorMetadata

getTableLayout

public ConnectorTableLayout getTableLayout(ConnectorSession session,
                                           ConnectorTableLayoutHandle handle)

Specified by:

getTableLayout in interface ConnectorMetadata

isLegacyGetLayoutSupported

public boolean isLegacyGetLayoutSupported(ConnectorSession session,
                                          ConnectorTableHandle tableHandle)

Description copied from interface: ConnectorMetadata

Experimental: if true, the engine will invoke getLayout otherwise, getLayout will not be called.

Specified by:

isLegacyGetLayoutSupported in interface ConnectorMetadata

getCommonPartitioningHandle

public Optional<ConnectorPartitioningHandle> getCommonPartitioningHandle(ConnectorSession session,
                                                                         ConnectorPartitioningHandle left,
                                                                         ConnectorPartitioningHandle right)

Description copied from interface: ConnectorMetadata

Return a partitioning handle which the connector can transparently convert both left and right into.

Specified by:

getCommonPartitioningHandle in interface ConnectorMetadata

isRefinedPartitioningOver

public boolean isRefinedPartitioningOver(ConnectorSession session,
                                         ConnectorPartitioningHandle left,
                                         ConnectorPartitioningHandle right)

Description copied from interface: ConnectorMetadata

Partitioning a = {a_1, ... a_n} is considered as a refined partitioning over partitioning b = {b_1, ... b_m} if:

• n >= m
• For every partition b_i in partitioning b, the rows it contains is the same as union of a set of partitions a_{i_1}, a_{i_2}, ... a_{i_k} in partitioning a, i.e.

  b_i = a_{i_1} + a_{i_2} + ... + a_{i_k}

• Connector can transparently convert partitioning a to partitioning b associated with the provided table layout handle.

For example, consider two partitioning over order table:

• partitioning a has 256 partitions by orderkey % 256
• partitioning b has 128 partitions by orderkey % 128

Partitioning a is a refined partitioning over b if Connector supports transparently convert a to b.

Refined-over relation is reflexive.

This SPI is unstable and subject to change in the future.

Specified by:

isRefinedPartitioningOver in interface ConnectorMetadata

getPartitioningHandleForExchange

public ConnectorPartitioningHandle getPartitioningHandleForExchange(ConnectorSession session,
                                                                    int partitionCount,
                                                                    List<Type> partitionTypes)

Description copied from interface: ConnectorMetadata

Provides partitioning handle for exchange.

Specified by:

getPartitioningHandleForExchange in interface ConnectorMetadata

getAlternativeLayoutHandle

public ConnectorTableLayoutHandle getAlternativeLayoutHandle(ConnectorSession session,
                                                             ConnectorTableLayoutHandle tableLayoutHandle,
                                                             ConnectorPartitioningHandle partitioningHandle)

Description copied from interface: ConnectorMetadata

Return a table layout handle whose partitioning is converted to the provided partitioning handle, but otherwise identical to the provided table layout handle. The provided table layout handle must be one that the connector can transparently convert to from the original partitioning handle associated with the provided table layout handle, as promised by ConnectorMetadata.getCommonPartitioningHandle(com.facebook.presto.spi.ConnectorSession, com.facebook.presto.spi.connector.ConnectorPartitioningHandle, com.facebook.presto.spi.connector.ConnectorPartitioningHandle).

Specified by:

getAlternativeLayoutHandle in interface ConnectorMetadata

getNewTableLayout

public Optional<ConnectorNewTableLayout> getNewTableLayout(ConnectorSession session,
                                                           ConnectorTableMetadata tableMetadata)

Description copied from interface: ConnectorMetadata

Get the physical layout for a new table.

Specified by:

getNewTableLayout in interface ConnectorMetadata

getPreferredShuffleLayoutForNewTable

public Optional<ConnectorNewTableLayout> getPreferredShuffleLayoutForNewTable(ConnectorSession session,
                                                                              ConnectorTableMetadata tableMetadata)

Description copied from interface: ConnectorMetadata

A connector can have preferred shuffle layout for table write. For example, Hive connector might prefer to shuffle on partitioned columns for partitioned unbucketed table.

Specified by:

getPreferredShuffleLayoutForNewTable in interface ConnectorMetadata

See Also:

ConnectorMetadata.getPreferredShuffleLayoutForInsert(com.facebook.presto.spi.ConnectorSession, com.facebook.presto.spi.ConnectorTableHandle)

getInsertLayout

public Optional<ConnectorNewTableLayout> getInsertLayout(ConnectorSession session,
                                                         ConnectorTableHandle tableHandle)

Description copied from interface: ConnectorMetadata

Get the physical layout for a inserting into an existing table.

Specified by:

getInsertLayout in interface ConnectorMetadata

getPreferredShuffleLayoutForInsert

public Optional<ConnectorNewTableLayout> getPreferredShuffleLayoutForInsert(ConnectorSession session,
                                                                            ConnectorTableHandle tableHandle)

Description copied from interface: ConnectorMetadata

A connector can have preferred shuffle layout for table write. For example, Hive connector might prefer to shuffle on partitioned columns for partitioned unbucketed table.

Specified by:

getPreferredShuffleLayoutForInsert in interface ConnectorMetadata

See Also:

ConnectorMetadata.getPreferredShuffleLayoutForNewTable(com.facebook.presto.spi.ConnectorSession, com.facebook.presto.spi.ConnectorTableMetadata)

getStatisticsCollectionMetadataForWrite

public TableStatisticsMetadata getStatisticsCollectionMetadataForWrite(ConnectorSession session,
                                                                       ConnectorTableMetadata tableMetadata)

Description copied from interface: ConnectorMetadata

Describes statistics that must be collected during a write.

Specified by:

getStatisticsCollectionMetadataForWrite in interface ConnectorMetadata

getStatisticsCollectionMetadata

public TableStatisticsMetadata getStatisticsCollectionMetadata(ConnectorSession session,
                                                               ConnectorTableMetadata tableMetadata)

Description copied from interface: ConnectorMetadata

Describe statistics that must be collected during a statistics collection

Specified by:

getStatisticsCollectionMetadata in interface ConnectorMetadata

beginStatisticsCollection

public ConnectorTableHandle beginStatisticsCollection(ConnectorSession session,
                                                      ConnectorTableHandle tableHandle)

Description copied from interface: ConnectorMetadata

Begin statistics collection

Specified by:

beginStatisticsCollection in interface ConnectorMetadata

finishStatisticsCollection

public void finishStatisticsCollection(ConnectorSession session,
                                       ConnectorTableHandle tableHandle,
                                       Collection<ComputedStatistics> computedStatistics)

Description copied from interface: ConnectorMetadata

Finish statistics collection

Specified by:

finishStatisticsCollection in interface ConnectorMetadata

schemaExists

public boolean schemaExists(ConnectorSession session,
                            String schemaName)

Description copied from interface: ConnectorMetadata

Checks if a schema exists. The connector may have schemas that exist but are not enumerable via ConnectorMetadata.listSchemaNames(com.facebook.presto.spi.ConnectorSession).

Specified by:

schemaExists in interface ConnectorMetadata

listSchemaNames

public List<String> listSchemaNames(ConnectorSession session)

Description copied from interface: ConnectorMetadata

Returns the schemas provided by this connector.

Specified by:

listSchemaNames in interface ConnectorMetadata

getTableHandle

public ConnectorTableHandle getTableHandle(ConnectorSession session,
                                           SchemaTableName tableName)

Description copied from interface: ConnectorMetadata

Returns a table handle for the specified table name, or null if the connector does not contain the table.

Specified by:

getTableHandle in interface ConnectorMetadata

getTableHandleForStatisticsCollection

public ConnectorTableHandle getTableHandleForStatisticsCollection(ConnectorSession session,
                                                                  SchemaTableName tableName,
                                                                  Map<String,Object> analyzeProperties)

Description copied from interface: ConnectorMetadata

Returns a table handle for the specified table name, or null if the connector does not contain the table. The returned table handle can contain information in analyzeProperties.

Specified by:

getTableHandleForStatisticsCollection in interface ConnectorMetadata

getSystemTable

public Optional<SystemTable> getSystemTable(ConnectorSession session,
                                            SchemaTableName tableName)

Description copied from interface: ConnectorMetadata

Returns the system table for the specified table name, if one exists. The system tables handled via ConnectorMetadata.getSystemTable(com.facebook.presto.spi.ConnectorSession, com.facebook.presto.spi.SchemaTableName) differ form those returned by Connector.getSystemTables(). The former mechanism allows dynamic resolution of system tables, while the latter is based on static list of system tables built during startup.

Specified by:

getSystemTable in interface ConnectorMetadata

getTableMetadata

public ConnectorTableMetadata getTableMetadata(ConnectorSession session,
                                               ConnectorTableHandle table)

Description copied from interface: ConnectorMetadata

Return the metadata for the specified table handle.

Specified by:

getTableMetadata in interface ConnectorMetadata

getInfo

public Optional<Object> getInfo(ConnectorTableLayoutHandle table)

Description copied from interface: ConnectorMetadata

Return the connector-specific metadata for the specified table layout. This is the object that is passed to the event listener framework.

Specified by:

getInfo in interface ConnectorMetadata

listTables

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

Description copied from interface: ConnectorMetadata

List table names, possibly filtered by schema. An empty list is returned if none match.

Specified by:

listTables in interface ConnectorMetadata

listTables

public List<SchemaTableName> listTables(ConnectorSession session,
                                        String schemaNameOrNull)

Description copied from interface: ConnectorMetadata

List table names, possibly filtered by schema. An empty list is returned if none match.

Specified by:

listTables in interface ConnectorMetadata

getReferencedMaterializedViews

public Optional<List<SchemaTableName>> getReferencedMaterializedViews(ConnectorSession session,
                                                                      SchemaTableName tableName)

Description copied from interface: ConnectorMetadata

Gets the referenced materialized views for a give table

Specified by:

getReferencedMaterializedViews in interface ConnectorMetadata

getColumnHandles

public Map<String,ColumnHandle> getColumnHandles(ConnectorSession session,
                                                 ConnectorTableHandle tableHandle)

Description copied from interface: ConnectorMetadata

Gets all of the columns on the specified table, or an empty map if the columns can not be enumerated.

Specified by:

getColumnHandles in interface ConnectorMetadata

getColumnMetadata

public ColumnMetadata getColumnMetadata(ConnectorSession session,
                                        ConnectorTableHandle tableHandle,
                                        ColumnHandle columnHandle)

Description copied from interface: ConnectorMetadata

Gets the metadata for the specified table column.

Specified by:

getColumnMetadata in interface ConnectorMetadata

toExplainIOConstraints

public TupleDomain<ColumnHandle> toExplainIOConstraints(ConnectorSession session,
                                                        ConnectorTableHandle tableHandle,
                                                        TupleDomain<ColumnHandle> constraints)

Description copied from interface: ConnectorMetadata

Returns a TupleDomain of constraints that is suitable for ExplainIO

Specified by:

toExplainIOConstraints in interface ConnectorMetadata

listTableColumns

public Map<SchemaTableName,List<ColumnMetadata>> listTableColumns(ConnectorSession session,
                                                                  SchemaTablePrefix prefix)

Description copied from interface: ConnectorMetadata

Gets the metadata for all columns that match the specified table prefix.

Specified by:

listTableColumns in interface ConnectorMetadata

getTableStatistics

public TableStatistics getTableStatistics(ConnectorSession session,
                                          ConnectorTableHandle tableHandle,
                                          Optional<ConnectorTableLayoutHandle> tableLayoutHandle,
                                          List<ColumnHandle> columnHandles,
                                          Constraint<ColumnHandle> constraint)

Description copied from interface: ConnectorMetadata

Get statistics for table for given columns and filtering constraint.

Specified by:

getTableStatistics in interface ConnectorMetadata

addColumn

public void addColumn(ConnectorSession session,
                      ConnectorTableHandle tableHandle,
                      ColumnMetadata column)

Description copied from interface: ConnectorMetadata

Add the specified column

Specified by:

addColumn in interface ConnectorMetadata

createSchema

public void createSchema(ConnectorSession session,
                         String schemaName,
                         Map<String,Object> properties)

Description copied from interface: ConnectorMetadata

Creates a schema.

Specified by:

createSchema in interface ConnectorMetadata

dropSchema

public void dropSchema(ConnectorSession session,
                       String schemaName)

Description copied from interface: ConnectorMetadata

Drops the specified schema.

Specified by:

dropSchema in interface ConnectorMetadata

renameSchema

public void renameSchema(ConnectorSession session,
                         String source,
                         String target)

Description copied from interface: ConnectorMetadata

Renames the specified schema.

Specified by:

renameSchema in interface ConnectorMetadata

createTable

public void createTable(ConnectorSession session,
                        ConnectorTableMetadata tableMetadata,
                        boolean ignoreExisting)

Description copied from interface: ConnectorMetadata

Creates a table using the specified table metadata.

Specified by:

createTable in interface ConnectorMetadata

createTemporaryTable

public ConnectorTableHandle createTemporaryTable(ConnectorSession session,
                                                 List<ColumnMetadata> columns,
                                                 Optional<ConnectorPartitioningMetadata> partitioningMetadata)

Description copied from interface: ConnectorMetadata

Creates a temporary table with optional partitioning requirements. Temporary table might have different default storage format, compression scheme, replication factor, etc, and gets automatically dropped when the transaction ends.

This SPI is unstable and subject to change in the future.

Specified by:

createTemporaryTable in interface ConnectorMetadata

dropTable

public void dropTable(ConnectorSession session,
                      ConnectorTableHandle tableHandle)

Description copied from interface: ConnectorMetadata

Drops the specified table

Specified by:

dropTable in interface ConnectorMetadata

truncateTable

public void truncateTable(ConnectorSession session,
                          ConnectorTableHandle tableHandle)

Description copied from interface: ConnectorMetadata

Truncates the specified table

Specified by:

truncateTable in interface ConnectorMetadata

renameColumn

public void renameColumn(ConnectorSession session,
                         ConnectorTableHandle tableHandle,
                         ColumnHandle source,
                         String target)

Description copied from interface: ConnectorMetadata

Rename the specified column

Specified by:

renameColumn in interface ConnectorMetadata

dropColumn

public void dropColumn(ConnectorSession session,
                       ConnectorTableHandle tableHandle,
                       ColumnHandle column)

Description copied from interface: ConnectorMetadata

Drop the specified column

Specified by:

dropColumn in interface ConnectorMetadata

renameTable

public void renameTable(ConnectorSession session,
                        ConnectorTableHandle tableHandle,
                        SchemaTableName newTableName)

Description copied from interface: ConnectorMetadata

Rename the specified table

Specified by:

renameTable in interface ConnectorMetadata

beginCreateTable

public ConnectorOutputTableHandle beginCreateTable(ConnectorSession session,
                                                   ConnectorTableMetadata tableMetadata,
                                                   Optional<ConnectorNewTableLayout> layout)

Description copied from interface: ConnectorMetadata

Begin the atomic creation of a table with data.

Specified by:

beginCreateTable in interface ConnectorMetadata

finishCreateTable

public Optional<ConnectorOutputMetadata> finishCreateTable(ConnectorSession session,
                                                           ConnectorOutputTableHandle tableHandle,
                                                           Collection<io.airlift.slice.Slice> fragments,
                                                           Collection<ComputedStatistics> computedStatistics)

Description copied from interface: ConnectorMetadata

Finish a table creation with data after the data is written.

Specified by:

finishCreateTable in interface ConnectorMetadata

beginQuery

public void beginQuery(ConnectorSession session)

Description copied from interface: ConnectorMetadata

Start a SELECT/UPDATE/INSERT/DELETE query. This notification is triggered after the planning phase completes.

Specified by:

beginQuery in interface ConnectorMetadata

cleanupQuery

public void cleanupQuery(ConnectorSession session)

Description copied from interface: ConnectorMetadata

Cleanup after a SELECT/UPDATE/INSERT/DELETE query. This is the very last notification after the query finishes, whether it succeeds or fails. An exception thrown in this method will not affect the result of the query.

Specified by:

cleanupQuery in interface ConnectorMetadata

beginInsert

public ConnectorInsertTableHandle beginInsert(ConnectorSession session,
                                              ConnectorTableHandle tableHandle)

Description copied from interface: ConnectorMetadata

Begin insert query

Specified by:

beginInsert in interface ConnectorMetadata

finishInsert

public Optional<ConnectorOutputMetadata> finishInsert(ConnectorSession session,
                                                      ConnectorInsertTableHandle insertHandle,
                                                      Collection<io.airlift.slice.Slice> fragments,
                                                      Collection<ComputedStatistics> computedStatistics)

Description copied from interface: ConnectorMetadata

Finish insert query

Specified by:

finishInsert in interface ConnectorMetadata

createView

public void createView(ConnectorSession session,
                       ConnectorTableMetadata viewMetadata,
                       String viewData,
                       boolean replace)

Description copied from interface: ConnectorMetadata

Create the specified view. The data for the view is opaque to the connector.

Specified by:

createView in interface ConnectorMetadata

dropView

public void dropView(ConnectorSession session,
                     SchemaTableName viewName)

Description copied from interface: ConnectorMetadata

Drop the specified view.

Specified by:

dropView in interface ConnectorMetadata

listViews

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

Specified by:

listViews in interface ConnectorMetadata

listViews

public List<SchemaTableName> listViews(ConnectorSession session,
                                       String schemaNameOrNull)

Description copied from interface: ConnectorMetadata

List view names, possibly filtered by schema. An empty list is returned if none match.

Specified by:

listViews in interface ConnectorMetadata

getViews

public Map<SchemaTableName,ConnectorViewDefinition> getViews(ConnectorSession session,
                                                             SchemaTablePrefix prefix)

Description copied from interface: ConnectorMetadata

Gets the view data for views that match the specified table prefix.

Specified by:

getViews in interface ConnectorMetadata

getMaterializedView

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

Description copied from interface: ConnectorMetadata

Gets the materialized view data for the specified materialized view name.

Specified by:

getMaterializedView in interface ConnectorMetadata

createMaterializedView

public void createMaterializedView(ConnectorSession session,
                                   ConnectorTableMetadata viewMetadata,
                                   ConnectorMaterializedViewDefinition viewDefinition,
                                   boolean ignoreExisting)

Description copied from interface: ConnectorMetadata

Create the specified materialized view. The data for the materialized view is opaque to the connector.

Specified by:

createMaterializedView in interface ConnectorMetadata

dropMaterializedView

public void dropMaterializedView(ConnectorSession session,
                                 SchemaTableName viewName)

Description copied from interface: ConnectorMetadata

Drop the specified materialized view.

Specified by:

dropMaterializedView in interface ConnectorMetadata

getMaterializedViewStatus

public MaterializedViewStatus getMaterializedViewStatus(ConnectorSession session,
                                                        SchemaTableName materializedViewName)

Specified by:

getMaterializedViewStatus in interface ConnectorMetadata

getMaterializedViewStatus

public MaterializedViewStatus getMaterializedViewStatus(ConnectorSession session,
                                                        SchemaTableName materializedViewName,
                                                        TupleDomain<String> baseQueryDomain)

Description copied from interface: ConnectorMetadata

Get the materialized view status to inform the engine how much data has been materialized in the view

Specified by:

getMaterializedViewStatus in interface ConnectorMetadata

baseQueryDomain - The domain from which to consider missing partitions. For example, a query that selects a specific date range can consider only partitions from that range when determining view staleness.

beginRefreshMaterializedView

public ConnectorInsertTableHandle beginRefreshMaterializedView(ConnectorSession session,
                                                               ConnectorTableHandle tableHandle)

Description copied from interface: ConnectorMetadata

Begin refresh materialized view

Specified by:

beginRefreshMaterializedView in interface ConnectorMetadata

finishRefreshMaterializedView

public Optional<ConnectorOutputMetadata> finishRefreshMaterializedView(ConnectorSession session,
                                                                       ConnectorInsertTableHandle insertHandle,
                                                                       Collection<io.airlift.slice.Slice> fragments,
                                                                       Collection<ComputedStatistics> computedStatistics)

Description copied from interface: ConnectorMetadata

Finish refresh materialized view

Specified by:

finishRefreshMaterializedView in interface ConnectorMetadata

getUpdateRowIdColumnHandle

public ColumnHandle getUpdateRowIdColumnHandle(ConnectorSession session,
                                               ConnectorTableHandle tableHandle)

Description copied from interface: ConnectorMetadata

Get the column handle that will generate row IDs for the delete operation. These IDs will be passed to the deleteRows() method of the UpdatablePageSource that created them.

Specified by:

getUpdateRowIdColumnHandle in interface ConnectorMetadata

beginDelete

public ConnectorTableHandle beginDelete(ConnectorSession session,
                                        ConnectorTableHandle tableHandle)

Description copied from interface: ConnectorMetadata

Begin delete query

Specified by:

beginDelete in interface ConnectorMetadata

finishDelete

public void finishDelete(ConnectorSession session,
                         ConnectorTableHandle tableHandle,
                         Collection<io.airlift.slice.Slice> fragments)

Description copied from interface: ConnectorMetadata

Finish delete query

Specified by:

finishDelete in interface ConnectorMetadata

fragments - all fragments returned by UpdatablePageSource.finish()

supportsMetadataDelete

public boolean supportsMetadataDelete(ConnectorSession session,
                                      ConnectorTableHandle tableHandle,
                                      Optional<ConnectorTableLayoutHandle> tableLayoutHandle)

Specified by:

supportsMetadataDelete in interface ConnectorMetadata

Returns:

whether delete without table scan is supported

metadataDelete

public OptionalLong metadataDelete(ConnectorSession session,
                                   ConnectorTableHandle tableHandle,
                                   ConnectorTableLayoutHandle tableLayoutHandle)

Description copied from interface: ConnectorMetadata

Delete the provided table layout

Specified by:

metadataDelete in interface ConnectorMetadata

Returns:

number of rows deleted, or null for unknown

resolveIndex

public Optional<ConnectorResolvedIndex> resolveIndex(ConnectorSession session,
                                                     ConnectorTableHandle tableHandle,
                                                     Set<ColumnHandle> indexableColumns,
                                                     Set<ColumnHandle> outputColumns,
                                                     TupleDomain<ColumnHandle> tupleDomain)

Description copied from interface: ConnectorMetadata

Try to locate a table index that can lookup results by indexableColumns and provide the requested outputColumns.

Specified by:

resolveIndex in interface ConnectorMetadata

createRole

public void createRole(ConnectorSession session,
                       String role,
                       Optional<PrestoPrincipal> grantor)

Description copied from interface: ConnectorMetadata

Creates the specified role.

Specified by:

createRole in interface ConnectorMetadata

grantor - represents the principal specified by WITH ADMIN statement

dropRole

public void dropRole(ConnectorSession session,
                     String role)

Description copied from interface: ConnectorMetadata

Drops the specified role.

Specified by:

dropRole in interface ConnectorMetadata

listRoles

public Set<String> listRoles(ConnectorSession session)

Description copied from interface: ConnectorMetadata

List available roles.

Specified by:

listRoles in interface ConnectorMetadata

listRoleGrants

public Set<RoleGrant> listRoleGrants(ConnectorSession session,
                                     PrestoPrincipal principal)

Description copied from interface: ConnectorMetadata

List role grants for a given principal, not recursively.

Specified by:

listRoleGrants in interface ConnectorMetadata

grantRoles

public void grantRoles(ConnectorSession connectorSession,
                       Set<String> roles,
                       Set<PrestoPrincipal> grantees,
                       boolean withAdminOption,
                       Optional<PrestoPrincipal> grantor)

Description copied from interface: ConnectorMetadata

Grants the specified roles to the specified grantees

Specified by:

grantRoles in interface ConnectorMetadata

grantor - represents the principal specified by GRANTED BY statement

revokeRoles

public void revokeRoles(ConnectorSession connectorSession,
                        Set<String> roles,
                        Set<PrestoPrincipal> grantees,
                        boolean adminOptionFor,
                        Optional<PrestoPrincipal> grantor)

Description copied from interface: ConnectorMetadata

Revokes the specified roles from the specified grantees

Specified by:

revokeRoles in interface ConnectorMetadata

grantor - represents the principal specified by GRANTED BY statement

listApplicableRoles

public Set<RoleGrant> listApplicableRoles(ConnectorSession session,
                                          PrestoPrincipal principal)

Description copied from interface: ConnectorMetadata

List applicable roles, including the transitive grants, for the specified principal

Specified by:

listApplicableRoles in interface ConnectorMetadata

listEnabledRoles

public Set<String> listEnabledRoles(ConnectorSession session)

Description copied from interface: ConnectorMetadata

List applicable roles, including the transitive grants, in given session

Specified by:

listEnabledRoles in interface ConnectorMetadata

grantTablePrivileges

public void grantTablePrivileges(ConnectorSession session,
                                 SchemaTableName tableName,
                                 Set<Privilege> privileges,
                                 PrestoPrincipal grantee,
                                 boolean grantOption)

Description copied from interface: ConnectorMetadata

Grants the specified privilege to the specified user on the specified table

Specified by:

grantTablePrivileges in interface ConnectorMetadata

revokeTablePrivileges

public void revokeTablePrivileges(ConnectorSession session,
                                  SchemaTableName tableName,
                                  Set<Privilege> privileges,
                                  PrestoPrincipal grantee,
                                  boolean grantOption)

Description copied from interface: ConnectorMetadata

Revokes the specified privilege on the specified table from the specified user

Specified by:

revokeTablePrivileges in interface ConnectorMetadata

listTablePrivileges

public List<GrantInfo> listTablePrivileges(ConnectorSession session,
                                           SchemaTablePrefix prefix)

Description copied from interface: ConnectorMetadata

List the table privileges granted to the specified grantee for the tables that have the specified prefix considering the selected session role

Specified by:

listTablePrivileges in interface ConnectorMetadata

commitPageSinkAsync

public CompletableFuture<Void> commitPageSinkAsync(ConnectorSession session,
                                                   ConnectorOutputTableHandle tableHandle,
                                                   Collection<io.airlift.slice.Slice> fragments)

Description copied from interface: ConnectorMetadata

Commits page sink for table creation. To enable recoverable grouped execution, it is required that output connector supports page sink commit. This method is unstable and subject to change in the future.

Specified by:

commitPageSinkAsync in interface ConnectorMetadata

commitPageSinkAsync

public CompletableFuture<Void> commitPageSinkAsync(ConnectorSession session,
                                                   ConnectorInsertTableHandle tableHandle,
                                                   Collection<io.airlift.slice.Slice> fragments)

Description copied from interface: ConnectorMetadata

Commits page sink for table insertion. To enable recoverable grouped execution, it is required that output connector supports page sink commit. This method is unstable and subject to change in the future.

Specified by:

commitPageSinkAsync in interface ConnectorMetadata

getMetadataUpdateResults

public List<ConnectorMetadataUpdateHandle> getMetadataUpdateResults(List<ConnectorMetadataUpdateHandle> metadataUpdateRequests,
                                                                    QueryId queryId)

Description copied from interface: ConnectorMetadata

Handles metadata update requests and sends the results back to worker

Specified by:

getMetadataUpdateResults in interface ConnectorMetadata

doMetadataUpdateCleanup

public void doMetadataUpdateCleanup(QueryId queryId)

Specified by:

doMetadataUpdateCleanup in interface ConnectorMetadata

getTableLayoutFilterCoverage

public TableLayoutFilterCoverage getTableLayoutFilterCoverage(ConnectorTableLayoutHandle tableHandle,
                                                              Set<String> relevantPartitionColumns)

Specified by:

getTableLayoutFilterCoverage in interface ConnectorMetadata