com.facebook.presto.spi

Interface ConnectorMetadata

All Known Implementing Classes:

ClassLoaderSafeConnectorMetadata, ReadOnlyConnectorMetadata

public interface ConnectorMetadata

Method Summary

Methods

Modifier and Type	Method and Description
ConnectorOutputTableHandle	beginCreateTable(ConnectorSession session, ConnectorTableMetadata tableMetadata) Begin the atomic creation of a table with data.
ConnectorInsertTableHandle	beginInsert(ConnectorSession session, ConnectorTableHandle tableHandle) Begin insert query
boolean	canCreateSampledTables(ConnectorSession session) Returns true if this catalog supports creation of sampled tables
void	commitCreateTable(ConnectorOutputTableHandle tableHandle, Collection<String> fragments) Commit a table creation with data after the data is written.
void	commitInsert(ConnectorInsertTableHandle insertHandle, Collection<String> fragments) Commit insert query
ConnectorTableHandle	createTable(ConnectorSession session, ConnectorTableMetadata tableMetadata) Creates a table using the specified table metadata.
void	createView(ConnectorSession session, SchemaTableName viewName, String viewData, boolean replace) Create the specified view.
void	dropTable(ConnectorTableHandle tableHandle) Drops the specified table
void	dropView(ConnectorSession session, SchemaTableName viewName) Drop the specified view.
Map<String,ConnectorColumnHandle>	getColumnHandles(ConnectorTableHandle tableHandle) Gets all of the columns on the specified table, or an empty map if the columns can not be enumerated.
ColumnMetadata	getColumnMetadata(ConnectorTableHandle tableHandle, ConnectorColumnHandle columnHandle) Gets the metadata for the specified table column.
ConnectorColumnHandle	getSampleWeightColumnHandle(ConnectorTableHandle tableHandle) Returns the handle for the sample weight column, or null if the table does not contain sampled data.
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.
ConnectorTableMetadata	getTableMetadata(ConnectorTableHandle table) Return the metadata for the specified table handle.
Map<SchemaTableName,String>	getViews(ConnectorSession session, SchemaTablePrefix prefix) Gets the view data for views that match the specified table prefix.
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<SchemaTableName>	listTables(ConnectorSession session, String schemaNameOrNull) List table names, possibly filtered by schema.
List<SchemaTableName>	listViews(ConnectorSession session, String schemaNameOrNull) List view names, possibly filtered by schema.
void	renameTable(ConnectorTableHandle tableHandle, SchemaTableName newTableName) Rename the specified table

Method Detail

listSchemaNames

List<String> listSchemaNames(ConnectorSession session)

Returns the schemas provided by this connector.

getTableHandle

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.

getTableMetadata

ConnectorTableMetadata getTableMetadata(ConnectorTableHandle table)

Return the metadata for the specified table handle.

Throws:

RuntimeException - if table handle is no longer valid

listTables

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

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

getSampleWeightColumnHandle

ConnectorColumnHandle getSampleWeightColumnHandle(ConnectorTableHandle tableHandle)

Returns the handle for the sample weight column, or null if the table does not contain sampled data.

Throws:

RuntimeException - if the table handle is no longer valid

canCreateSampledTables

boolean canCreateSampledTables(ConnectorSession session)

Returns true if this catalog supports creation of sampled tables

getColumnHandles

Map<String,ConnectorColumnHandle> getColumnHandles(ConnectorTableHandle tableHandle)

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

Throws:

RuntimeException - if table handle is no longer valid

getColumnMetadata

ColumnMetadata getColumnMetadata(ConnectorTableHandle tableHandle,
                               ConnectorColumnHandle columnHandle)

Gets the metadata for the specified table column.

Throws:

RuntimeException - if table or column handles are no longer valid

listTableColumns

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

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

createTable

ConnectorTableHandle createTable(ConnectorSession session,
                               ConnectorTableMetadata tableMetadata)

Creates a table using the specified table metadata.

dropTable

void dropTable(ConnectorTableHandle tableHandle)

Drops the specified table

Throws:

RuntimeException - if the table can not be dropped or table handle is no longer valid

renameTable

void renameTable(ConnectorTableHandle tableHandle,
               SchemaTableName newTableName)

Rename the specified table

beginCreateTable

ConnectorOutputTableHandle beginCreateTable(ConnectorSession session,
                                          ConnectorTableMetadata tableMetadata)

Begin the atomic creation of a table with data.

commitCreateTable

void commitCreateTable(ConnectorOutputTableHandle tableHandle,
                     Collection<String> fragments)

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

beginInsert

ConnectorInsertTableHandle beginInsert(ConnectorSession session,
                                     ConnectorTableHandle tableHandle)

Begin insert query

commitInsert

void commitInsert(ConnectorInsertTableHandle insertHandle,
                Collection<String> fragments)

Commit insert query

createView

void createView(ConnectorSession session,
              SchemaTableName viewName,
              String viewData,
              boolean replace)

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

dropView

void dropView(ConnectorSession session,
            SchemaTableName viewName)

Drop the specified view.

listViews

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

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

getViews

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

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