Package io.trino.tracing

Class TracingMetadata

java.lang.Object

io.trino.tracing.TracingMetadata

All Implemented Interfaces:

Metadata

public class TracingMetadata
extends Object
implements Metadata

Constructor Summary

Constructors

Constructor	Description
TracingMetadata(io.opentelemetry.api.trace.Tracer tracer, Metadata delegate)

Method Summary

Modifier and Type	Method	Description
void	addColumn(Session session, TableHandle tableHandle, CatalogSchemaTableName table, ColumnMetadata column)	Add the specified column to the table.
void	addField(Session session, TableHandle tableHandle, List<String> parentPath, String fieldName, Type type, boolean ignoreExisting)	Add the specified field to the column.
Optional<AggregationApplicationResult<TableHandle>>	applyAggregation(Session session, TableHandle table, List<AggregateFunction> aggregations, Map<String,ColumnHandle> assignments, List<List<ColumnHandle>> groupingSets)
Optional<TableHandle>	applyDelete(Session session, TableHandle tableHandle)	Push delete into connector
Optional<ConstraintApplicationResult<TableHandle>>	applyFilter(Session session, TableHandle table, Constraint constraint)
Optional<JoinApplicationResult<TableHandle>>	applyJoin(Session session, JoinType joinType, TableHandle left, TableHandle right, ConnectorExpression joinCondition, Map<String,ColumnHandle> leftAssignments, Map<String,ColumnHandle> rightAssignments, JoinStatistics statistics)
Optional<LimitApplicationResult<TableHandle>>	applyLimit(Session session, TableHandle table, long limit)
Optional<ProjectionApplicationResult<TableHandle>>	applyProjection(Session session, TableHandle table, List<ConnectorExpression> projections, Map<String,ColumnHandle> assignments)
Optional<SampleApplicationResult<TableHandle>>	applySample(Session session, TableHandle table, SampleType sampleType, double sampleRatio)
Optional<TableFunctionApplicationResult<TableHandle>>	applyTableFunction(Session session, TableFunctionHandle handle)
Optional<TableScanRedirectApplicationResult>	applyTableScanRedirect(Session session, TableHandle tableHandle)	Returns the result of redirecting the table scan on a given table to a different table.
Optional<TopNApplicationResult<TableHandle>>	applyTopN(Session session, TableHandle handle, long topNCount, List<SortItem> sortItems, Map<String,ColumnHandle> assignments)
Optional<TableHandle>	applyUpdate(Session session, TableHandle tableHandle, Map<ColumnHandle,Constant> assignments)	Push update into connector
OutputTableHandle	beginCreateTable(Session session, String catalogName, ConnectorTableMetadata tableMetadata, Optional<TableLayout> layout, boolean replace)	Begin the atomic creation of a table with data.
InsertTableHandle	beginInsert(Session session, TableHandle tableHandle, List<ColumnHandle> columns)	Begin insert query
MergeHandle	beginMerge(Session session, TableHandle tableHandle)	Begin merge query
void	beginQuery(Session session)	Initialize before query begins
InsertTableHandle	beginRefreshMaterializedView(Session session, TableHandle tableHandle, List<TableHandle> sourceTableHandles)	Begin refresh materialized view query
AnalyzeTableHandle	beginStatisticsCollection(Session session, TableHandle tableHandle)	Begin statistics collection
BeginTableExecuteResult<TableExecuteHandle,TableHandle>	beginTableExecute(Session session, TableExecuteHandle handle, TableHandle updatedSourceTableHandle)
boolean	catalogExists(Session session, String catalogName)
void	cleanupQuery(Session session)	Cleanup after a query.
void	createLanguageFunction(Session session, QualifiedObjectName name, LanguageFunction function, boolean replace)
void	createMaterializedView(Session session, QualifiedObjectName viewName, MaterializedViewDefinition definition, Map<String,Object> properties, boolean replace, boolean ignoreExisting)	Creates the specified materialized view with the specified view definition.
void	createRole(Session session, String role, Optional<TrinoPrincipal> grantor, Optional<String> catalog)	Creates the specified role in the specified catalog.
void	createSchema(Session session, CatalogSchemaName schema, Map<String,Object> properties, TrinoPrincipal principal)	Creates a schema.
void	createTable(Session session, String catalogName, ConnectorTableMetadata tableMetadata, SaveMode saveMode)	Creates a table using the specified table metadata.
void	createView(Session session, QualifiedObjectName viewName, ViewDefinition definition, boolean replace)	Creates the specified view with the specified view definition.
ResolvedFunction	decodeFunction(QualifiedName name)
boolean	delegateMaterializedViewRefreshToConnector(Session session, QualifiedObjectName viewName)	Returns true if materialized view refresh should be delegated to connector
void	denyEntityPrivileges(Session session, EntityKindAndName entity, Set<EntityPrivilege> privileges, TrinoPrincipal grantee)	Deny the specified privileges to the specified principal on the specified entity.
void	denySchemaPrivileges(Session session, CatalogSchemaName schemaName, Set<Privilege> privileges, TrinoPrincipal grantee)	Deny the specified privilege to the specified principal on the specified schema.
void	denyTablePrivileges(Session session, QualifiedObjectName tableName, Set<Privilege> privileges, TrinoPrincipal grantee)	Deny the specified privilege to the specified principal on the specified table
void	dropColumn(Session session, TableHandle tableHandle, CatalogSchemaTableName table, ColumnHandle column)	Drop the specified column.
void	dropField(Session session, TableHandle tableHandle, ColumnHandle column, List<String> fieldPath)	Drop the specified field from the column.
void	dropLanguageFunction(Session session, QualifiedObjectName name, String signatureToken)
void	dropMaterializedView(Session session, QualifiedObjectName viewName)	Drops the specified materialized view.
void	dropNotNullConstraint(Session session, TableHandle tableHandle, ColumnHandle column)	Drop a not null constraint on the specified column.
void	dropRole(Session session, String role, Optional<String> catalog)	Drops the specified role in the specified catalog.
void	dropSchema(Session session, CatalogSchemaName schema, boolean cascade)	Drops the specified schema.
void	dropTable(Session session, TableHandle tableHandle, CatalogSchemaTableName tableName)	Drops the specified table
void	dropView(Session session, QualifiedObjectName viewName)	Drops the specified view.
OptionalLong	executeDelete(Session session, TableHandle tableHandle)	Execute delete in connector
void	executeTableExecute(Session session, TableExecuteHandle handle)
OptionalLong	executeUpdate(Session session, TableHandle tableHandle)	Execute update in connector
Optional<ConnectorOutputMetadata>	finishCreateTable(Session session, OutputTableHandle tableHandle, Collection<io.airlift.slice.Slice> fragments, Collection<ComputedStatistics> computedStatistics)	Finish a table creation with data after the data is written.
Optional<ConnectorOutputMetadata>	finishInsert(Session session, InsertTableHandle tableHandle, List<TableHandle> sourceTableHandles, Collection<io.airlift.slice.Slice> fragments, Collection<ComputedStatistics> computedStatistics)	Finish insert query
void	finishMerge(Session session, MergeHandle tableHandle, Collection<io.airlift.slice.Slice> fragments, Collection<ComputedStatistics> computedStatistics)	Finish merge query
Optional<ConnectorOutputMetadata>	finishRefreshMaterializedView(Session session, TableHandle tableHandle, InsertTableHandle insertTableHandle, Collection<io.airlift.slice.Slice> fragments, Collection<ComputedStatistics> computedStatistics, List<TableHandle> sourceTableHandles, List<String> sourceTableFunctions)	Finish refresh materialized view query
void	finishStatisticsCollection(Session session, AnalyzeTableHandle tableHandle, Collection<ComputedStatistics> computedStatistics)	Finish statistics collection
void	finishTableExecute(Session session, TableExecuteHandle handle, Collection<io.airlift.slice.Slice> fragments, List<Object> tableExecuteState)
AggregationFunctionMetadata	getAggregationFunctionMetadata(Session session, ResolvedFunction resolvedFunction)
Set<EntityPrivilege>	getAllEntityKindPrivileges(String entityKind)	Gets all the EntityPrivileges associated with an entityKind.
Optional<CatalogHandle>	getCatalogHandle(Session session, String catalogName)	Returns a catalog handle for the specified catalog name.
ResolvedFunction	getCoercion(CatalogSchemaFunctionName name, Type fromType, Type toType)
ResolvedFunction	getCoercion(OperatorType operatorType, Type fromType, Type toType)
ResolvedFunction	getCoercion(Type fromType, Type toType)
Map<String,ColumnHandle>	getColumnHandles(Session session, TableHandle tableHandle)	Gets all of the columns on the specified table, or an empty map if the columns cannot be enumerated.
ColumnMetadata	getColumnMetadata(Session session, TableHandle tableHandle, ColumnHandle columnHandle)	Gets the metadata for the specified table column.
Optional<PartitioningHandle>	getCommonPartitioning(Session session, PartitioningHandle left, PartitioningHandle right)	Return a partitioning handle which the connector can transparently convert both left and right into.
Set<ConnectorCapabilities>	getConnectorCapabilities(Session session, CatalogHandle catalogHandle)
Metadata	getDelegate()
FunctionDependencyDeclaration	getFunctionDependencies(Session session, CatalogHandle catalogHandle, FunctionId functionId, BoundSignature boundSignature)
Collection<CatalogFunctionMetadata>	getFunctions(Session session, CatalogSchemaFunctionName catalogSchemaFunctionName)
Optional<Object>	getInfo(Session session, TableHandle handle)
Optional<TableLayout>	getInsertLayout(Session session, TableHandle target)
WriterScalingOptions	getInsertWriterScalingOptions(Session session, TableHandle tableHandle)	Returns writer scaling options for the specified table.
Optional<TableLayout>	getLayoutForTableExecute(Session session, TableExecuteHandle tableExecuteHandle)
Optional<MaterializedViewDefinition>	getMaterializedView(Session session, QualifiedObjectName viewName)	Returns the materialized view definition for the specified view name.
MaterializedViewFreshness	getMaterializedViewFreshness(Session session, QualifiedObjectName name)	Method to get difference between the states of table at two different points in time/or as of given token-ids.
Map<String,Object>	getMaterializedViewProperties(Session session, QualifiedObjectName objectName, MaterializedViewDefinition materializedViewDefinition)
Map<QualifiedObjectName,ViewInfo>	getMaterializedViews(Session session, QualifiedTablePrefix prefix)	Get the materialized view definitions that match the specified table prefix (never null).
OptionalInt	getMaxWriterTasks(Session session, String catalogName)	Returns maximum number of tasks that can be created while writing data to specific connector.
ColumnHandle	getMergeRowIdColumnHandle(Session session, TableHandle tableHandle)	Get the column handle that will generate row IDs for the merge operation.
Optional<TableLayout>	getNewTableLayout(Session session, String catalogName, ConnectorTableMetadata tableMetadata)
WriterScalingOptions	getNewTableWriterScalingOptions(Session session, QualifiedObjectName tableName, Map<String,Object> tableProperties)	Returns writer scaling options for the specified table.
RedirectionAwareTableHandle	getRedirectionAwareTableHandle(Session session, QualifiedObjectName tableName)	Get the target table handle after performing redirection.
RedirectionAwareTableHandle	getRedirectionAwareTableHandle(Session session, QualifiedObjectName tableName, Optional<TableVersion> startVersion, Optional<TableVersion> endVersion)	Get the target table handle after performing redirection with a table version.
Map<SchemaTableName,RelationType>	getRelationTypes(Session session, QualifiedTablePrefix prefix)	Get the relation names that match the specified table prefix (never null).
RowChangeParadigm	getRowChangeParadigm(Session session, TableHandle tableHandle)	Return the row update paradigm supported by the connector on the table or throw an exception if row change is not supported.
Optional<TrinoPrincipal>	getSchemaOwner(Session session, CatalogSchemaName schemaName)	Gets the schema owner for the specified schema.
Map<String,Object>	getSchemaProperties(Session session, CatalogSchemaName schemaName)	Gets the schema properties for the specified schema.
AnalyzeMetadata	getStatisticsCollectionMetadata(Session session, TableHandle tableHandle, Map<String,Object> analyzeProperties)	Describe statistics that must be collected during a statistics collection
TableStatisticsMetadata	getStatisticsCollectionMetadataForWrite(Session session, CatalogHandle catalogHandle, ConnectorTableMetadata tableMetadata)	Describes statistics that must be collected during a write.
Optional<Type>	getSupportedType(Session session, CatalogHandle catalogHandle, Map<String,Object> tableProperties, Type type)	Return the effective Type that is supported by the connector for the given type, if Optional.empty() is returned, the type will be used as is during table creation which may or may not be supported by the connector.
Optional<SystemTable>	getSystemTable(Session session, QualifiedObjectName tableName)
Optional<TableHandle>	getTableHandle(Session session, QualifiedObjectName tableName)	Returns a table handle for the specified table name.
Optional<TableHandle>	getTableHandle(Session session, QualifiedObjectName tableName, Optional<TableVersion> startVersion, Optional<TableVersion> endVersion)	Returns a table handle for the specified table name with a specified version
Optional<TableExecuteHandle>	getTableHandleForExecute(Session session, TableHandle tableHandle, String procedureName, Map<String,Object> executeProperties)
TableMetadata	getTableMetadata(Session session, TableHandle tableHandle)	Return the metadata for the specified table handle.
CatalogSchemaTableName	getTableName(Session session, TableHandle tableHandle)
TableProperties	getTableProperties(Session session, TableHandle handle)
TableSchema	getTableSchema(Session session, TableHandle tableHandle)	Return table schema definition for the specified table handle.
TableStatistics	getTableStatistics(Session session, TableHandle tableHandle)	Return statistics for specified table.
Optional<PartitioningHandle>	getUpdateLayout(Session session, TableHandle tableHandle)	Get the physical layout for updated or deleted rows of a MERGE operation.
Optional<ViewDefinition>	getView(Session session, QualifiedObjectName viewName)	Returns the view definition for the specified view name.
Map<QualifiedObjectName,ViewInfo>	getViews(Session session, QualifiedTablePrefix prefix)	Get the view definitions that match the specified table prefix (never null).
void	grantEntityPrivileges(Session session, EntityKindAndName entity, Set<EntityPrivilege> privileges, TrinoPrincipal grantee, boolean grantOption)	Grants the specified privileges to the specified user on the specified grantee.
void	grantRoles(Session session, Set<String> roles, Set<TrinoPrincipal> grantees, boolean adminOption, Optional<TrinoPrincipal> grantor, Optional<String> catalog)	Grants the specified roles to the specified grantees in the specified catalog
void	grantSchemaPrivileges(Session session, CatalogSchemaName schemaName, Set<Privilege> privileges, TrinoPrincipal grantee, boolean grantOption)	Grants the specified privilege to the specified user on the specified schema.
void	grantTablePrivileges(Session session, QualifiedObjectName tableName, Set<Privilege> privileges, TrinoPrincipal grantee, boolean grantOption)	Grants the specified privilege to the specified user on the specified table
boolean	isCatalogManagedSecurity(Session session, String catalog)	Does the specified catalog manage security directly, or does it use system security management?
boolean	isMaterializedView(Session session, QualifiedObjectName viewName)	Is the specified table a materialized view.
boolean	isView(Session session, QualifiedObjectName viewName)	Is the specified table a view.
boolean	languageFunctionExists(Session session, QualifiedObjectName name, String signatureToken)
Set<RoleGrant>	listApplicableRoles(Session session, TrinoPrincipal principal, Optional<String> catalog)	List applicable roles, including the transitive grants, for the specified principal
List<CatalogInfo>	listCatalogs(Session session)	Gets all the loaded catalogs
Set<String>	listEnabledRoles(Session session, String catalog)	List applicable roles, including the transitive grants, in given catalog
Set<String>	listEnabledRoles(Identity identity)	List applicable system roles, including the transitive grants, for the given identity.
Collection<FunctionMetadata>	listFunctions(Session session, CatalogSchemaName schema)
Collection<FunctionMetadata>	listGlobalFunctions(Session session)
List<QualifiedObjectName>	listMaterializedViews(Session session, QualifiedTablePrefix prefix)	Get the names that match the specified table prefix (never null).
List<RelationCommentMetadata>	listRelationComments(Session session, String catalogName, Optional<String> schemaName, UnaryOperator<Set<SchemaTableName>> relationFilter)	Gets the comments metadata for all relations (tables, views, materialized views) that match the specified prefix.
Set<RoleGrant>	listRoleGrants(Session session, Optional<String> catalog, TrinoPrincipal principal)	List roles grants in the specified catalog for a given principal, not recursively.
Set<String>	listRoles(Session session, Optional<String> catalog)	List available roles in specified catalog.
List<String>	listSchemaNames(Session session, String catalogName)
List<TableColumnsMetadata>	listTableColumns(Session session, QualifiedTablePrefix prefix, UnaryOperator<Set<SchemaTableName>> relationFilter)	Gets the columns metadata for all tables that match the specified prefix.
List<GrantInfo>	listTablePrivileges(Session session, QualifiedTablePrefix prefix)	Gets the privileges for the specified table available to the given grantee considering the selected session role
List<QualifiedObjectName>	listTables(Session session, QualifiedTablePrefix prefix)	Get the relation names that match the specified table prefix (never null).
List<QualifiedObjectName>	listViews(Session session, QualifiedTablePrefix prefix)	Get the names that match the specified table prefix (never null).
TableHandle	makeCompatiblePartitioning(Session session, TableHandle table, PartitioningHandle partitioningHandle)	Return a table handle whose partitioning is converted to the provided partitioning handle, but otherwise identical to the provided table handle.
com.google.common.util.concurrent.ListenableFuture<Void>	refreshMaterializedView(Session session, QualifiedObjectName viewName)	Refresh materialized view
void	renameColumn(Session session, TableHandle tableHandle, CatalogSchemaTableName table, ColumnHandle source, String target)	Rename the specified column.
void	renameField(Session session, TableHandle tableHandle, List<String> fieldPath, String target)	Rename the specified field.
void	renameMaterializedView(Session session, QualifiedObjectName existingViewName, QualifiedObjectName newViewName)	Rename the specified materialized view.
void	renameSchema(Session session, CatalogSchemaName source, String target)	Renames the specified schema.
void	renameTable(Session session, TableHandle tableHandle, CatalogSchemaTableName currentTableName, QualifiedObjectName newTableName)	Rename the specified table.
void	renameView(Session session, QualifiedObjectName existingViewName, QualifiedObjectName newViewName)	Rename the specified view.
ResolvedFunction	resolveBuiltinFunction(String name, List<TypeSignatureProvider> parameterTypes)
Optional<ResolvedIndex>	resolveIndex(Session session, TableHandle 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.
ResolvedFunction	resolveOperator(OperatorType operatorType, List<? extends Type> argumentTypes)
void	revokeEntityPrivileges(Session session, EntityKindAndName entity, Set<EntityPrivilege> privileges, TrinoPrincipal grantee, boolean grantOption)	Revokes the specified privilege on the specified entity from the specified grantee.
void	revokeRoles(Session session, Set<String> roles, Set<TrinoPrincipal> grantees, boolean adminOption, Optional<TrinoPrincipal> grantor, Optional<String> catalog)	Revokes the specified roles from the specified grantees in the specified catalog
void	revokeSchemaPrivileges(Session session, CatalogSchemaName schemaName, Set<Privilege> privileges, TrinoPrincipal grantee, boolean grantOption)	Revokes the specified privilege on the specified schema from the specified user.
void	revokeTablePrivileges(Session session, QualifiedObjectName tableName, Set<Privilege> privileges, TrinoPrincipal grantee, boolean grantOption)	Revokes the specified privilege on the specified table from the specified user.
boolean	roleExists(Session session, String role, Optional<String> catalog)	Does the specified role exist.
boolean	schemaExists(Session session, CatalogSchemaName schema)
void	setColumnComment(Session session, TableHandle tableHandle, ColumnHandle column, Optional<String> comment)	Comments to the specified column.
void	setColumnType(Session session, TableHandle tableHandle, ColumnHandle column, Type type)	Set the specified type to the column.
void	setFieldType(Session session, TableHandle tableHandle, List<String> fieldPath, Type type)	Set the specified type to the field.
void	setMaterializedViewColumnComment(Session session, QualifiedObjectName viewName, String columnName, Optional<String> comment)	Comments to the specified materialized view column.
void	setMaterializedViewProperties(Session session, QualifiedObjectName viewName, Map<String,Optional<Object>> properties)	Sets the properties of the specified materialized view.
void	setSchemaAuthorization(Session session, CatalogSchemaName source, TrinoPrincipal principal)	Set the specified schema's user/role.
void	setTableAuthorization(Session session, CatalogSchemaTableName table, TrinoPrincipal principal)	Set the authorization (owner) of specified table's user/role
void	setTableComment(Session session, TableHandle tableHandle, Optional<String> comment)	Comments to the specified table.
void	setTableProperties(Session session, TableHandle tableHandle, Map<String,Optional<Object>> properties)	Set properties to the specified table.
void	setViewAuthorization(Session session, CatalogSchemaTableName view, TrinoPrincipal principal)	Set the authorization (owner) of specified view's user/role
void	setViewColumnComment(Session session, QualifiedObjectName viewName, String columnName, Optional<String> comment)	Comments to the specified view column.
void	setViewComment(Session session, QualifiedObjectName viewName, Optional<String> comment)	Comments to the specified view.
boolean	supportsMissingColumnsOnInsert(Session session, TableHandle tableHandle)
void	truncateTable(Session session, TableHandle tableHandle)	Truncates the specified table
void	validateScan(Session session, TableHandle table)

Methods inherited from class java.lang.Object

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

Constructor Details

TracingMetadata

@Inject
public TracingMetadata(io.opentelemetry.api.trace.Tracer tracer,
 Metadata delegate)

Method Details

getDelegate

public Metadata getDelegate()

getConnectorCapabilities

public Set<ConnectorCapabilities> getConnectorCapabilities(Session session,
 CatalogHandle catalogHandle)

Specified by:

getConnectorCapabilities in interface Metadata

catalogExists

public boolean catalogExists(Session session,
 String catalogName)

Specified by:

catalogExists in interface Metadata

schemaExists

public boolean schemaExists(Session session,
 CatalogSchemaName schema)

Specified by:

schemaExists in interface Metadata

listSchemaNames

public List<String> listSchemaNames(Session session,
 String catalogName)

Specified by:

listSchemaNames in interface Metadata

getTableHandle

public Optional<TableHandle> getTableHandle(Session session,
 QualifiedObjectName tableName)

Description copied from interface: Metadata

Returns a table handle for the specified table name.

Specified by:

getTableHandle in interface Metadata

getSystemTable

public Optional<SystemTable> getSystemTable(Session session,
 QualifiedObjectName tableName)

Specified by:

getSystemTable in interface Metadata

getTableHandleForExecute

public Optional<TableExecuteHandle> getTableHandleForExecute(Session session,
 TableHandle tableHandle,
 String procedureName,
 Map<String,Object> executeProperties)

Specified by:

getTableHandleForExecute in interface Metadata

getLayoutForTableExecute

public Optional<TableLayout> getLayoutForTableExecute(Session session,
 TableExecuteHandle tableExecuteHandle)

Specified by:

getLayoutForTableExecute in interface Metadata

beginTableExecute

public BeginTableExecuteResult<TableExecuteHandle,TableHandle> beginTableExecute(Session session,
 TableExecuteHandle handle,
 TableHandle updatedSourceTableHandle)

Specified by:

beginTableExecute in interface Metadata

finishTableExecute

public void finishTableExecute(Session session,
 TableExecuteHandle handle,
 Collection<io.airlift.slice.Slice> fragments,
 List<Object> tableExecuteState)

Specified by:

finishTableExecute in interface Metadata

executeTableExecute

public void executeTableExecute(Session session,
 TableExecuteHandle handle)

Specified by:

executeTableExecute in interface Metadata

getTableProperties

public TableProperties getTableProperties(Session session,
 TableHandle handle)

Specified by:

getTableProperties in interface Metadata

makeCompatiblePartitioning

public TableHandle makeCompatiblePartitioning(Session session,
 TableHandle table,
 PartitioningHandle partitioningHandle)

Description copied from interface: Metadata

Return a table handle whose partitioning is converted to the provided partitioning handle, but otherwise identical to the provided table handle. The provided table handle must be one that the connector can transparently convert to from the original partitioning handle associated with the provided table handle, as promised by Metadata.getCommonPartitioning(io.trino.Session, io.trino.sql.planner.PartitioningHandle, io.trino.sql.planner.PartitioningHandle).

Specified by:

makeCompatiblePartitioning in interface Metadata

getCommonPartitioning

public Optional<PartitioningHandle> getCommonPartitioning(Session session,
 PartitioningHandle left,
 PartitioningHandle right)

Description copied from interface: Metadata

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

Specified by:

getCommonPartitioning in interface Metadata

getInfo

public Optional<Object> getInfo(Session session,
 TableHandle handle)

Specified by:

getInfo in interface Metadata

getTableName

public CatalogSchemaTableName getTableName(Session session,
 TableHandle tableHandle)

Specified by:

getTableName in interface Metadata

getTableSchema

public TableSchema getTableSchema(Session session,
 TableHandle tableHandle)

Description copied from interface: Metadata

Return table schema definition for the specified table handle. Table schema definition is a set of information required by semantic analyzer to analyze the query.

Specified by:

getTableSchema in interface Metadata

See Also:

• Metadata.getTableMetadata(Session, TableHandle)

getTableMetadata

public TableMetadata getTableMetadata(Session session,
 TableHandle tableHandle)

Description copied from interface: Metadata

Return the metadata for the specified table handle.

Specified by:

getTableMetadata in interface Metadata

See Also:

• a different method which is less expensive.

getTableStatistics

public TableStatistics getTableStatistics(Session session,
 TableHandle tableHandle)

Description copied from interface: Metadata

Return statistics for specified table.

Specified by:

getTableStatistics in interface Metadata

listTables

public List<QualifiedObjectName> listTables(Session session,
 QualifiedTablePrefix prefix)

Description copied from interface: Metadata

Get the relation names that match the specified table prefix (never null). This includes all relations (e.g. tables, views, materialized views).

Specified by:

listTables in interface Metadata

getRelationTypes

public Map<SchemaTableName,RelationType> getRelationTypes(Session session,
 QualifiedTablePrefix prefix)

Description copied from interface: Metadata

Get the relation names that match the specified table prefix (never null). This includes all relations (e.g. tables, views, materialized views).

Specified by:

getRelationTypes in interface Metadata

getColumnHandles

public Map<String,ColumnHandle> getColumnHandles(Session session,
 TableHandle tableHandle)

Description copied from interface: Metadata

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

Specified by:

getColumnHandles in interface Metadata

getColumnMetadata

public ColumnMetadata getColumnMetadata(Session session,
 TableHandle tableHandle,
 ColumnHandle columnHandle)

Description copied from interface: Metadata

Gets the metadata for the specified table column.

Specified by:

getColumnMetadata in interface Metadata

listTableColumns

public List<TableColumnsMetadata> listTableColumns(Session session,
 QualifiedTablePrefix prefix,
 UnaryOperator<Set<SchemaTableName>> relationFilter)

Description copied from interface: Metadata

Gets the columns metadata for all tables that match the specified prefix. TODO: consider returning a stream for more efficient processing

Specified by:

listTableColumns in interface Metadata

listRelationComments

public List<RelationCommentMetadata> listRelationComments(Session session,
 String catalogName,
 Optional<String> schemaName,
 UnaryOperator<Set<SchemaTableName>> relationFilter)

Description copied from interface: Metadata

Gets the comments metadata for all relations (tables, views, materialized views) that match the specified prefix. TODO: consider returning a stream for more efficient processing

Specified by:

listRelationComments in interface Metadata

createSchema

public void createSchema(Session session,
 CatalogSchemaName schema,
 Map<String,Object> properties,
 TrinoPrincipal principal)

Description copied from interface: Metadata

Creates a schema.

Specified by:

createSchema in interface Metadata

Parameters:

principal - TODO

dropSchema

public void dropSchema(Session session,
 CatalogSchemaName schema,
 boolean cascade)

Description copied from interface: Metadata

Drops the specified schema.

Specified by:

dropSchema in interface Metadata

renameSchema

public void renameSchema(Session session,
 CatalogSchemaName source,
 String target)

Description copied from interface: Metadata

Renames the specified schema.

Specified by:

renameSchema in interface Metadata

setSchemaAuthorization

public void setSchemaAuthorization(Session session,
 CatalogSchemaName source,
 TrinoPrincipal principal)

Description copied from interface: Metadata

Set the specified schema's user/role.

Specified by:

setSchemaAuthorization in interface Metadata

createTable

public void createTable(Session session,
 String catalogName,
 ConnectorTableMetadata tableMetadata,
 SaveMode saveMode)

Description copied from interface: Metadata

Creates a table using the specified table metadata.

Specified by:

createTable in interface Metadata

renameTable

public void renameTable(Session session,
 TableHandle tableHandle,
 CatalogSchemaTableName currentTableName,
 QualifiedObjectName newTableName)

Description copied from interface: Metadata

Rename the specified table.

Specified by:

renameTable in interface Metadata

setTableProperties

public void setTableProperties(Session session,
 TableHandle tableHandle,
 Map<String,Optional<Object>> properties)

Description copied from interface: Metadata

Set properties to the specified table.

Specified by:

setTableProperties in interface Metadata

setTableComment

public void setTableComment(Session session,
 TableHandle tableHandle,
 Optional<String> comment)

Description copied from interface: Metadata

Comments to the specified table.

Specified by:

setTableComment in interface Metadata

setViewComment

public void setViewComment(Session session,
 QualifiedObjectName viewName,
 Optional<String> comment)

Description copied from interface: Metadata

Comments to the specified view.

Specified by:

setViewComment in interface Metadata

setViewColumnComment

public void setViewColumnComment(Session session,
 QualifiedObjectName viewName,
 String columnName,
 Optional<String> comment)

Description copied from interface: Metadata

Comments to the specified view column.

Specified by:

setViewColumnComment in interface Metadata

setColumnComment

public void setColumnComment(Session session,
 TableHandle tableHandle,
 ColumnHandle column,
 Optional<String> comment)

Description copied from interface: Metadata

Comments to the specified column.

Specified by:

setColumnComment in interface Metadata

renameColumn

public void renameColumn(Session session,
 TableHandle tableHandle,
 CatalogSchemaTableName table,
 ColumnHandle source,
 String target)

Description copied from interface: Metadata

Rename the specified column.

Specified by:

renameColumn in interface Metadata

renameField

public void renameField(Session session,
 TableHandle tableHandle,
 List<String> fieldPath,
 String target)

Description copied from interface: Metadata

Rename the specified field.

Specified by:

renameField in interface Metadata

addColumn

public void addColumn(Session session,
 TableHandle tableHandle,
 CatalogSchemaTableName table,
 ColumnMetadata column)

Description copied from interface: Metadata

Add the specified column to the table.

Specified by:

addColumn in interface Metadata

addField

public void addField(Session session,
 TableHandle tableHandle,
 List<String> parentPath,
 String fieldName,
 Type type,
 boolean ignoreExisting)

Description copied from interface: Metadata

Add the specified field to the column.

Specified by:

addField in interface Metadata

setColumnType

public void setColumnType(Session session,
 TableHandle tableHandle,
 ColumnHandle column,
 Type type)

Description copied from interface: Metadata

Set the specified type to the column.

Specified by:

setColumnType in interface Metadata

setFieldType

public void setFieldType(Session session,
 TableHandle tableHandle,
 List<String> fieldPath,
 Type type)

Description copied from interface: Metadata

Set the specified type to the field.

Specified by:

setFieldType in interface Metadata

dropNotNullConstraint

public void dropNotNullConstraint(Session session,
 TableHandle tableHandle,
 ColumnHandle column)

Description copied from interface: Metadata

Drop a not null constraint on the specified column.

Specified by:

dropNotNullConstraint in interface Metadata

setTableAuthorization

public void setTableAuthorization(Session session,
 CatalogSchemaTableName table,
 TrinoPrincipal principal)

Description copied from interface: Metadata

Set the authorization (owner) of specified table's user/role

Specified by:

setTableAuthorization in interface Metadata

dropColumn

public void dropColumn(Session session,
 TableHandle tableHandle,
 CatalogSchemaTableName table,
 ColumnHandle column)

Description copied from interface: Metadata

Drop the specified column.

Specified by:

dropColumn in interface Metadata

dropField

public void dropField(Session session,
 TableHandle tableHandle,
 ColumnHandle column,
 List<String> fieldPath)

Description copied from interface: Metadata

Drop the specified field from the column.

Specified by:

dropField in interface Metadata

dropTable

public void dropTable(Session session,
 TableHandle tableHandle,
 CatalogSchemaTableName tableName)

Description copied from interface: Metadata

Drops the specified table

Specified by:

dropTable in interface Metadata

truncateTable

public void truncateTable(Session session,
 TableHandle tableHandle)

Description copied from interface: Metadata

Truncates the specified table

Specified by:

truncateTable in interface Metadata

getNewTableLayout

public Optional<TableLayout> getNewTableLayout(Session session,
 String catalogName,
 ConnectorTableMetadata tableMetadata)

Specified by:

getNewTableLayout in interface Metadata

getSupportedType

public Optional<Type> getSupportedType(Session session,
 CatalogHandle catalogHandle,
 Map<String,Object> tableProperties,
 Type type)

Description copied from interface: Metadata

Return the effective Type that is supported by the connector for the given type, if Optional.empty() is returned, the type will be used as is during table creation which may or may not be supported by the connector.

Specified by:

getSupportedType in interface Metadata

beginCreateTable

public OutputTableHandle beginCreateTable(Session session,
 String catalogName,
 ConnectorTableMetadata tableMetadata,
 Optional<TableLayout> layout,
 boolean replace)

Description copied from interface: Metadata

Begin the atomic creation of a table with data.

Specified by:

beginCreateTable in interface Metadata

finishCreateTable

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

Description copied from interface: Metadata

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

Specified by:

finishCreateTable in interface Metadata

getInsertLayout

public Optional<TableLayout> getInsertLayout(Session session,
 TableHandle target)

Specified by:

getInsertLayout in interface Metadata

getStatisticsCollectionMetadataForWrite

public TableStatisticsMetadata getStatisticsCollectionMetadataForWrite(Session session,
 CatalogHandle catalogHandle,
 ConnectorTableMetadata tableMetadata)

Description copied from interface: Metadata

Describes statistics that must be collected during a write.

Specified by:

getStatisticsCollectionMetadataForWrite in interface Metadata

getStatisticsCollectionMetadata

public AnalyzeMetadata getStatisticsCollectionMetadata(Session session,
 TableHandle tableHandle,
 Map<String,Object> analyzeProperties)

Description copied from interface: Metadata

Describe statistics that must be collected during a statistics collection

Specified by:

getStatisticsCollectionMetadata in interface Metadata

beginStatisticsCollection

public AnalyzeTableHandle beginStatisticsCollection(Session session,
 TableHandle tableHandle)

Description copied from interface: Metadata

Begin statistics collection

Specified by:

beginStatisticsCollection in interface Metadata

finishStatisticsCollection

public void finishStatisticsCollection(Session session,
 AnalyzeTableHandle tableHandle,
 Collection<ComputedStatistics> computedStatistics)

Description copied from interface: Metadata

Finish statistics collection

Specified by:

finishStatisticsCollection in interface Metadata

beginQuery

public void beginQuery(Session session)

Description copied from interface: Metadata

Initialize before query begins

Specified by:

beginQuery in interface Metadata

cleanupQuery

public void cleanupQuery(Session session)

Description copied from interface: Metadata

Cleanup after a query. This is the very last notification after the query finishes, regardless if it succeeds or fails. An exception thrown in this method will not affect the result of the query.

Specified by:

cleanupQuery in interface Metadata

beginInsert

public InsertTableHandle beginInsert(Session session,
 TableHandle tableHandle,
 List<ColumnHandle> columns)

Description copied from interface: Metadata

Begin insert query

Specified by:

beginInsert in interface Metadata

supportsMissingColumnsOnInsert

public boolean supportsMissingColumnsOnInsert(Session session,
 TableHandle tableHandle)

Specified by:

supportsMissingColumnsOnInsert in interface Metadata

Returns:

whether connector handles missing columns during insert

finishInsert

public Optional<ConnectorOutputMetadata> finishInsert(Session session,
 InsertTableHandle tableHandle,
 List<TableHandle> sourceTableHandles,
 Collection<io.airlift.slice.Slice> fragments,
 Collection<ComputedStatistics> computedStatistics)

Description copied from interface: Metadata

Finish insert query

Specified by:

finishInsert in interface Metadata

delegateMaterializedViewRefreshToConnector

public boolean delegateMaterializedViewRefreshToConnector(Session session,
 QualifiedObjectName viewName)

Description copied from interface: Metadata

Returns true if materialized view refresh should be delegated to connector

Specified by:

delegateMaterializedViewRefreshToConnector in interface Metadata

refreshMaterializedView

public com.google.common.util.concurrent.ListenableFuture<Void> refreshMaterializedView(Session session,
 QualifiedObjectName viewName)

Description copied from interface: Metadata

Refresh materialized view

Specified by:

refreshMaterializedView in interface Metadata

beginRefreshMaterializedView

public InsertTableHandle beginRefreshMaterializedView(Session session,
 TableHandle tableHandle,
 List<TableHandle> sourceTableHandles)

Description copied from interface: Metadata

Begin refresh materialized view query

Specified by:

beginRefreshMaterializedView in interface Metadata

finishRefreshMaterializedView

public Optional<ConnectorOutputMetadata> finishRefreshMaterializedView(Session session,
 TableHandle tableHandle,
 InsertTableHandle insertTableHandle,
 Collection<io.airlift.slice.Slice> fragments,
 Collection<ComputedStatistics> computedStatistics,
 List<TableHandle> sourceTableHandles,
 List<String> sourceTableFunctions)

Description copied from interface: Metadata

Finish refresh materialized view query

Specified by:

finishRefreshMaterializedView in interface Metadata

applyUpdate

public Optional<TableHandle> applyUpdate(Session session,
 TableHandle tableHandle,
 Map<ColumnHandle,Constant> assignments)

Description copied from interface: Metadata

Push update into connector

Specified by:

applyUpdate in interface Metadata

executeUpdate

public OptionalLong executeUpdate(Session session,
 TableHandle tableHandle)

Description copied from interface: Metadata

Execute update in connector

Specified by:

executeUpdate in interface Metadata

applyDelete

public Optional<TableHandle> applyDelete(Session session,
 TableHandle tableHandle)

Description copied from interface: Metadata

Push delete into connector

Specified by:

applyDelete in interface Metadata

executeDelete

public OptionalLong executeDelete(Session session,
 TableHandle tableHandle)

Description copied from interface: Metadata

Execute delete in connector

Specified by:

executeDelete in interface Metadata

getRowChangeParadigm

public RowChangeParadigm getRowChangeParadigm(Session session,
 TableHandle tableHandle)

Description copied from interface: Metadata

Return the row update paradigm supported by the connector on the table or throw an exception if row change is not supported.

Specified by:

getRowChangeParadigm in interface Metadata

getMergeRowIdColumnHandle

public ColumnHandle getMergeRowIdColumnHandle(Session session,
 TableHandle tableHandle)

Description copied from interface: Metadata

Get the column handle that will generate row IDs for the merge operation. These IDs will be passed to the storeMergedRows() method of the ConnectorMergeSink that created them.

Specified by:

getMergeRowIdColumnHandle in interface Metadata

getUpdateLayout

public Optional<PartitioningHandle> getUpdateLayout(Session session,
 TableHandle tableHandle)

Description copied from interface: Metadata

Get the physical layout for updated or deleted rows of a MERGE operation.

Specified by:

getUpdateLayout in interface Metadata

beginMerge

public MergeHandle beginMerge(Session session,
 TableHandle tableHandle)

Description copied from interface: Metadata

Begin merge query

Specified by:

beginMerge in interface Metadata

finishMerge

public void finishMerge(Session session,
 MergeHandle tableHandle,
 Collection<io.airlift.slice.Slice> fragments,
 Collection<ComputedStatistics> computedStatistics)

Description copied from interface: Metadata

Finish merge query

Specified by:

finishMerge in interface Metadata

getCatalogHandle

public Optional<CatalogHandle> getCatalogHandle(Session session,
 String catalogName)

Description copied from interface: Metadata

Returns a catalog handle for the specified catalog name.

Specified by:

getCatalogHandle in interface Metadata

listCatalogs

public List<CatalogInfo> listCatalogs(Session session)

Description copied from interface: Metadata

Gets all the loaded catalogs

Specified by:

listCatalogs in interface Metadata

listViews

public List<QualifiedObjectName> listViews(Session session,
 QualifiedTablePrefix prefix)

Description copied from interface: Metadata

Get the names that match the specified table prefix (never null).

Specified by:

listViews in interface Metadata

getViews

public Map<QualifiedObjectName,ViewInfo> getViews(Session session,
 QualifiedTablePrefix prefix)

Description copied from interface: Metadata

Get the view definitions that match the specified table prefix (never null).

Specified by:

getViews in interface Metadata

isView

public boolean isView(Session session,
 QualifiedObjectName viewName)

Description copied from interface: Metadata

Is the specified table a view.

Specified by:

isView in interface Metadata

getView

public Optional<ViewDefinition> getView(Session session,
 QualifiedObjectName viewName)

Description copied from interface: Metadata

Returns the view definition for the specified view name.

Specified by:

getView in interface Metadata

getSchemaProperties

public Map<String,Object> getSchemaProperties(Session session,
 CatalogSchemaName schemaName)

Description copied from interface: Metadata

Gets the schema properties for the specified schema.

Specified by:

getSchemaProperties in interface Metadata

getSchemaOwner

public Optional<TrinoPrincipal> getSchemaOwner(Session session,
 CatalogSchemaName schemaName)

Description copied from interface: Metadata

Gets the schema owner for the specified schema.

Specified by:

getSchemaOwner in interface Metadata

createView

public void createView(Session session,
 QualifiedObjectName viewName,
 ViewDefinition definition,
 boolean replace)

Description copied from interface: Metadata

Creates the specified view with the specified view definition.

Specified by:

createView in interface Metadata

renameView

public void renameView(Session session,
 QualifiedObjectName existingViewName,
 QualifiedObjectName newViewName)

Description copied from interface: Metadata

Rename the specified view.

Specified by:

renameView in interface Metadata

setViewAuthorization

public void setViewAuthorization(Session session,
 CatalogSchemaTableName view,
 TrinoPrincipal principal)

Description copied from interface: Metadata

Set the authorization (owner) of specified view's user/role

Specified by:

setViewAuthorization in interface Metadata

dropView

public void dropView(Session session,
 QualifiedObjectName viewName)

Description copied from interface: Metadata

Drops the specified view.

Specified by:

dropView in interface Metadata

resolveIndex

public Optional<ResolvedIndex> resolveIndex(Session session,
 TableHandle tableHandle,
 Set<ColumnHandle> indexableColumns,
 Set<ColumnHandle> outputColumns,
 TupleDomain<ColumnHandle> tupleDomain)

Description copied from interface: Metadata

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

Specified by:

resolveIndex in interface Metadata

applyLimit

public Optional<LimitApplicationResult<TableHandle>> applyLimit(Session session,
 TableHandle table,
 long limit)

Specified by:

applyLimit in interface Metadata

applyFilter

public Optional<ConstraintApplicationResult<TableHandle>> applyFilter(Session session,
 TableHandle table,
 Constraint constraint)

Specified by:

applyFilter in interface Metadata

applyProjection

public Optional<ProjectionApplicationResult<TableHandle>> applyProjection(Session session,
 TableHandle table,
 List<ConnectorExpression> projections,
 Map<String,ColumnHandle> assignments)

Specified by:

applyProjection in interface Metadata

applySample

public Optional<SampleApplicationResult<TableHandle>> applySample(Session session,
 TableHandle table,
 SampleType sampleType,
 double sampleRatio)

Specified by:

applySample in interface Metadata

applyAggregation

public Optional<AggregationApplicationResult<TableHandle>> applyAggregation(Session session,
 TableHandle table,
 List<AggregateFunction> aggregations,
 Map<String,ColumnHandle> assignments,
 List<List<ColumnHandle>> groupingSets)

Specified by:

applyAggregation in interface Metadata

applyJoin

public Optional<JoinApplicationResult<TableHandle>> applyJoin(Session session,
 JoinType joinType,
 TableHandle left,
 TableHandle right,
 ConnectorExpression joinCondition,
 Map<String,ColumnHandle> leftAssignments,
 Map<String,ColumnHandle> rightAssignments,
 JoinStatistics statistics)

Specified by:

applyJoin in interface Metadata

applyTopN

public Optional<TopNApplicationResult<TableHandle>> applyTopN(Session session,
 TableHandle handle,
 long topNCount,
 List<SortItem> sortItems,
 Map<String,ColumnHandle> assignments)

Specified by:

applyTopN in interface Metadata

applyTableFunction

public Optional<TableFunctionApplicationResult<TableHandle>> applyTableFunction(Session session,
 TableFunctionHandle handle)

Specified by:

applyTableFunction in interface Metadata

validateScan

public void validateScan(Session session,
 TableHandle table)

Specified by:

validateScan in interface Metadata

isCatalogManagedSecurity

public boolean isCatalogManagedSecurity(Session session,
 String catalog)

Description copied from interface: Metadata

Does the specified catalog manage security directly, or does it use system security management?

Specified by:

isCatalogManagedSecurity in interface Metadata

roleExists

public boolean roleExists(Session session,
 String role,
 Optional<String> catalog)

Description copied from interface: Metadata

Does the specified role exist.

Specified by:

roleExists in interface Metadata

Parameters:

catalog - if present, the role catalog; otherwise the role is a system role

createRole

public void createRole(Session session,
 String role,
 Optional<TrinoPrincipal> grantor,
 Optional<String> catalog)

Description copied from interface: Metadata

Creates the specified role in the specified catalog.

Specified by:

createRole in interface Metadata

Parameters:

grantor - represents the principal specified by WITH ADMIN statement

catalog - if present, the role catalog; otherwise the role is a system role

dropRole

public void dropRole(Session session,
 String role,
 Optional<String> catalog)

Description copied from interface: Metadata

Drops the specified role in the specified catalog.

Specified by:

dropRole in interface Metadata

Parameters:

catalog - if present, the role catalog; otherwise the role is a system role

listRoles

public Set<String> listRoles(Session session,
 Optional<String> catalog)

Description copied from interface: Metadata

List available roles in specified catalog.

Specified by:

listRoles in interface Metadata

Parameters:

catalog - if present, the role catalog; otherwise the role is a system role

listRoleGrants

public Set<RoleGrant> listRoleGrants(Session session,
 Optional<String> catalog,
 TrinoPrincipal principal)

Description copied from interface: Metadata

List roles grants in the specified catalog for a given principal, not recursively.

Specified by:

listRoleGrants in interface Metadata

Parameters:

catalog - if present, the role catalog; otherwise the role is a system role

grantRoles

public void grantRoles(Session session,
 Set<String> roles,
 Set<TrinoPrincipal> grantees,
 boolean adminOption,
 Optional<TrinoPrincipal> grantor,
 Optional<String> catalog)

Description copied from interface: Metadata

Grants the specified roles to the specified grantees in the specified catalog

Specified by:

grantRoles in interface Metadata

Parameters:

grantor - represents the principal specified by GRANTED BY statement

catalog - if present, the role catalog; otherwise the role is a system role

revokeRoles

public void revokeRoles(Session session,
 Set<String> roles,
 Set<TrinoPrincipal> grantees,
 boolean adminOption,
 Optional<TrinoPrincipal> grantor,
 Optional<String> catalog)

Description copied from interface: Metadata

Revokes the specified roles from the specified grantees in the specified catalog

Specified by:

revokeRoles in interface Metadata

Parameters:

grantor - represents the principal specified by GRANTED BY statement

catalog - if present, the role catalog; otherwise the role is a system role

listApplicableRoles

public Set<RoleGrant> listApplicableRoles(Session session,
 TrinoPrincipal principal,
 Optional<String> catalog)

Description copied from interface: Metadata

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

Specified by:

listApplicableRoles in interface Metadata

Parameters:

catalog - if present, the role catalog; otherwise the role is a system role

listEnabledRoles

public Set<String> listEnabledRoles(Identity identity)

Description copied from interface: Metadata

List applicable system roles, including the transitive grants, for the given identity.

Specified by:

listEnabledRoles in interface Metadata

listEnabledRoles

public Set<String> listEnabledRoles(Session session,
 String catalog)

Description copied from interface: Metadata

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

Specified by:

listEnabledRoles in interface Metadata

Parameters:

catalog - if present, the role catalog; otherwise the role is a system role

grantSchemaPrivileges

public void grantSchemaPrivileges(Session session,
 CatalogSchemaName schemaName,
 Set<Privilege> privileges,
 TrinoPrincipal grantee,
 boolean grantOption)

Description copied from interface: Metadata

Grants the specified privilege to the specified user on the specified schema.

Specified by:

grantSchemaPrivileges in interface Metadata

denySchemaPrivileges

public void denySchemaPrivileges(Session session,
 CatalogSchemaName schemaName,
 Set<Privilege> privileges,
 TrinoPrincipal grantee)

Description copied from interface: Metadata

Deny the specified privilege to the specified principal on the specified schema.

Specified by:

denySchemaPrivileges in interface Metadata

revokeSchemaPrivileges

public void revokeSchemaPrivileges(Session session,
 CatalogSchemaName schemaName,
 Set<Privilege> privileges,
 TrinoPrincipal grantee,
 boolean grantOption)

Description copied from interface: Metadata

Revokes the specified privilege on the specified schema from the specified user.

Specified by:

revokeSchemaPrivileges in interface Metadata

grantTablePrivileges

public void grantTablePrivileges(Session session,
 QualifiedObjectName tableName,
 Set<Privilege> privileges,
 TrinoPrincipal grantee,
 boolean grantOption)

Description copied from interface: Metadata

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

Specified by:

grantTablePrivileges in interface Metadata

denyTablePrivileges

public void denyTablePrivileges(Session session,
 QualifiedObjectName tableName,
 Set<Privilege> privileges,
 TrinoPrincipal grantee)

Description copied from interface: Metadata

Deny the specified privilege to the specified principal on the specified table

Specified by:

denyTablePrivileges in interface Metadata

revokeTablePrivileges

public void revokeTablePrivileges(Session session,
 QualifiedObjectName tableName,
 Set<Privilege> privileges,
 TrinoPrincipal grantee,
 boolean grantOption)

Description copied from interface: Metadata

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

Specified by:

revokeTablePrivileges in interface Metadata

listTablePrivileges

public List<GrantInfo> listTablePrivileges(Session session,
 QualifiedTablePrefix prefix)

Description copied from interface: Metadata

Gets the privileges for the specified table available to the given grantee considering the selected session role

Specified by:

listTablePrivileges in interface Metadata

getAllEntityKindPrivileges

public Set<EntityPrivilege> getAllEntityKindPrivileges(String entityKind)

Description copied from interface: Metadata

Gets all the EntityPrivileges associated with an entityKind. Defines ALL PRIVILEGES for the entityKind

Specified by:

getAllEntityKindPrivileges in interface Metadata

grantEntityPrivileges

public void grantEntityPrivileges(Session session,
 EntityKindAndName entity,
 Set<EntityPrivilege> privileges,
 TrinoPrincipal grantee,
 boolean grantOption)

Description copied from interface: Metadata

Grants the specified privileges to the specified user on the specified grantee. If the set of privileges is empty, it is interpreted as all privileges for the entityKind.

Specified by:

grantEntityPrivileges in interface Metadata

denyEntityPrivileges

public void denyEntityPrivileges(Session session,
 EntityKindAndName entity,
 Set<EntityPrivilege> privileges,
 TrinoPrincipal grantee)

Description copied from interface: Metadata

Deny the specified privileges to the specified principal on the specified entity. If the set of privileges is empty, it is interpreted as all privileges for the entityKind.

Specified by:

denyEntityPrivileges in interface Metadata

revokeEntityPrivileges

public void revokeEntityPrivileges(Session session,
 EntityKindAndName entity,
 Set<EntityPrivilege> privileges,
 TrinoPrincipal grantee,
 boolean grantOption)

Description copied from interface: Metadata

Revokes the specified privilege on the specified entity from the specified grantee. If the set of privileges is empty, it is interpreted as all privileges for the entityKind.

Specified by:

revokeEntityPrivileges in interface Metadata

listGlobalFunctions

public Collection<FunctionMetadata> listGlobalFunctions(Session session)

Specified by:

listGlobalFunctions in interface Metadata

listFunctions

public Collection<FunctionMetadata> listFunctions(Session session,
 CatalogSchemaName schema)

Specified by:

listFunctions in interface Metadata

decodeFunction

public ResolvedFunction decodeFunction(QualifiedName name)

Specified by:

decodeFunction in interface Metadata

getFunctions

public Collection<CatalogFunctionMetadata> getFunctions(Session session,
 CatalogSchemaFunctionName catalogSchemaFunctionName)

Specified by:

getFunctions in interface Metadata

resolveBuiltinFunction

public ResolvedFunction resolveBuiltinFunction(String name,
 List<TypeSignatureProvider> parameterTypes)

Specified by:

resolveBuiltinFunction in interface Metadata

resolveOperator

public ResolvedFunction resolveOperator(OperatorType operatorType,
 List<? extends Type> argumentTypes)
                                 throws OperatorNotFoundException

Specified by:

resolveOperator in interface Metadata

Throws:

OperatorNotFoundException

getCoercion

public ResolvedFunction getCoercion(Type fromType,
 Type toType)

Specified by:

getCoercion in interface Metadata

getCoercion

public ResolvedFunction getCoercion(OperatorType operatorType,
 Type fromType,
 Type toType)

Specified by:

getCoercion in interface Metadata

getCoercion

public ResolvedFunction getCoercion(CatalogSchemaFunctionName name,
 Type fromType,
 Type toType)

Specified by:

getCoercion in interface Metadata

getAggregationFunctionMetadata

public AggregationFunctionMetadata getAggregationFunctionMetadata(Session session,
 ResolvedFunction resolvedFunction)

Specified by:

getAggregationFunctionMetadata in interface Metadata

getFunctionDependencies

public FunctionDependencyDeclaration getFunctionDependencies(Session session,
 CatalogHandle catalogHandle,
 FunctionId functionId,
 BoundSignature boundSignature)

Specified by:

getFunctionDependencies in interface Metadata

languageFunctionExists

public boolean languageFunctionExists(Session session,
 QualifiedObjectName name,
 String signatureToken)

Specified by:

languageFunctionExists in interface Metadata

createLanguageFunction

public void createLanguageFunction(Session session,
 QualifiedObjectName name,
 LanguageFunction function,
 boolean replace)

Specified by:

createLanguageFunction in interface Metadata

dropLanguageFunction

public void dropLanguageFunction(Session session,
 QualifiedObjectName name,
 String signatureToken)

Specified by:

dropLanguageFunction in interface Metadata

createMaterializedView

public void createMaterializedView(Session session,
 QualifiedObjectName viewName,
 MaterializedViewDefinition definition,
 Map<String,Object> properties,
 boolean replace,
 boolean ignoreExisting)

Description copied from interface: Metadata

Creates the specified materialized view with the specified view definition.

Specified by:

createMaterializedView in interface Metadata

dropMaterializedView

public void dropMaterializedView(Session session,
 QualifiedObjectName viewName)

Description copied from interface: Metadata

Drops the specified materialized view.

Specified by:

dropMaterializedView in interface Metadata

listMaterializedViews

public List<QualifiedObjectName> listMaterializedViews(Session session,
 QualifiedTablePrefix prefix)

Description copied from interface: Metadata

Get the names that match the specified table prefix (never null).

Specified by:

listMaterializedViews in interface Metadata

getMaterializedViews

public Map<QualifiedObjectName,ViewInfo> getMaterializedViews(Session session,
 QualifiedTablePrefix prefix)

Description copied from interface: Metadata

Get the materialized view definitions that match the specified table prefix (never null).

Specified by:

getMaterializedViews in interface Metadata

isMaterializedView

public boolean isMaterializedView(Session session,
 QualifiedObjectName viewName)

Description copied from interface: Metadata

Is the specified table a materialized view.

Specified by:

isMaterializedView in interface Metadata

getMaterializedView

public Optional<MaterializedViewDefinition> getMaterializedView(Session session,
 QualifiedObjectName viewName)

Description copied from interface: Metadata

Returns the materialized view definition for the specified view name.

Specified by:

getMaterializedView in interface Metadata

getMaterializedViewProperties

public Map<String,Object> getMaterializedViewProperties(Session session,
 QualifiedObjectName objectName,
 MaterializedViewDefinition materializedViewDefinition)

Specified by:

getMaterializedViewProperties in interface Metadata

getMaterializedViewFreshness

public MaterializedViewFreshness getMaterializedViewFreshness(Session session,
 QualifiedObjectName name)

Description copied from interface: Metadata

Method to get difference between the states of table at two different points in time/or as of given token-ids. The method is used by the engine to determine if a materialized view is current with respect to the tables it depends on.

Specified by:

getMaterializedViewFreshness in interface Metadata

renameMaterializedView

public void renameMaterializedView(Session session,
 QualifiedObjectName existingViewName,
 QualifiedObjectName newViewName)

Description copied from interface: Metadata

Rename the specified materialized view.

Specified by:

renameMaterializedView in interface Metadata

setMaterializedViewProperties

public void setMaterializedViewProperties(Session session,
 QualifiedObjectName viewName,
 Map<String,Optional<Object>> properties)

Description copied from interface: Metadata

Sets the properties of the specified materialized view.

Specified by:

setMaterializedViewProperties in interface Metadata

setMaterializedViewColumnComment

public void setMaterializedViewColumnComment(Session session,
 QualifiedObjectName viewName,
 String columnName,
 Optional<String> comment)

Description copied from interface: Metadata

Comments to the specified materialized view column.

Specified by:

setMaterializedViewColumnComment in interface Metadata

applyTableScanRedirect

public Optional<TableScanRedirectApplicationResult> applyTableScanRedirect(Session session,
 TableHandle tableHandle)

Description copied from interface: Metadata

Returns the result of redirecting the table scan on a given table to a different table. This method is used by the engine during the plan optimization phase to allow a connector to offload table scans to any other connector. This method is called after security checks against the original table.

Specified by:

applyTableScanRedirect in interface Metadata

getRedirectionAwareTableHandle

public RedirectionAwareTableHandle getRedirectionAwareTableHandle(Session session,
 QualifiedObjectName tableName)

Description copied from interface: Metadata

Get the target table handle after performing redirection.

Specified by:

getRedirectionAwareTableHandle in interface Metadata

getRedirectionAwareTableHandle

public RedirectionAwareTableHandle getRedirectionAwareTableHandle(Session session,
 QualifiedObjectName tableName,
 Optional<TableVersion> startVersion,
 Optional<TableVersion> endVersion)

Description copied from interface: Metadata

Get the target table handle after performing redirection with a table version.

Specified by:

getRedirectionAwareTableHandle in interface Metadata

getTableHandle

public Optional<TableHandle> getTableHandle(Session session,
 QualifiedObjectName tableName,
 Optional<TableVersion> startVersion,
 Optional<TableVersion> endVersion)

Description copied from interface: Metadata

Returns a table handle for the specified table name with a specified version

Specified by:

getTableHandle in interface Metadata

getMaxWriterTasks

public OptionalInt getMaxWriterTasks(Session session,
 String catalogName)

Description copied from interface: Metadata

Returns maximum number of tasks that can be created while writing data to specific connector. Note: It is ignored when retry policy is set to TASK

Specified by:

getMaxWriterTasks in interface Metadata

getNewTableWriterScalingOptions

public WriterScalingOptions getNewTableWriterScalingOptions(Session session,
 QualifiedObjectName tableName,
 Map<String,Object> tableProperties)

Description copied from interface: Metadata

Returns writer scaling options for the specified table. This method is called when table handle is not available during CTAS.

Specified by:

getNewTableWriterScalingOptions in interface Metadata

getInsertWriterScalingOptions

public WriterScalingOptions getInsertWriterScalingOptions(Session session,
 TableHandle tableHandle)

Description copied from interface: Metadata

Returns writer scaling options for the specified table.

Specified by:

getInsertWriterScalingOptions in interface Metadata