org.apache.hadoop.hive.metastore.dataconnector

Class AbstractDataConnectorProvider

java.lang.Object

org.apache.hadoop.hive.metastore.dataconnector.AbstractDataConnectorProvider

All Implemented Interfaces:

IDataConnectorProvider

Direct Known Subclasses:

AbstractJDBCConnectorProvider

public abstract class AbstractDataConnectorProvider
extends Object
implements IDataConnectorProvider

Field Summary

Fields

Modifier and Type	Field and Description
protected DataConnector	connector
protected String	driverClassName
protected Object	handle
protected String	scoped_db

Fields inherited from interface org.apache.hadoop.hive.metastore.dataconnector.IDataConnectorProvider

DERBY_TYPE, HIVE_JDBC_TYPE, MSSQL_TYPE, MYSQL_TYPE, ORACLE_TYPE, POSTGRES_TYPE

Constructor Summary

Constructors

Constructor and Description
AbstractDataConnectorProvider(String dbName, DataConnector connector, String driverClassName)

Method Summary

Modifier and Type	Method and Description
boolean	alterTable(String tableName, Table table) Alter an existing table in the remote data source.
protected Table	buildTableFromColsList(String tableName, List<FieldSchema> cols)
void	close() Closes a transport/connection to the datasource.
boolean	createTable(Table table) Creates a table with the given name in the remote data source.
boolean	dropTable(String tableName) Drop an existing table with the given name in the remote data source.
protected abstract String	getDatasourceType()
protected abstract String	getInputClass()
protected abstract String	getOutputClass()
Table	getTable(String tableName) Fetch a single table with the given name, returns a Hive Table object from the remote database
protected abstract String	getTableLocation(String tblName)
List<String>	getTableNames() Returns a list of all table names from the remote database.
List<Table>	getTables(String regex) Returns Hive Table objects from the remote database for tables that match a name pattern.
void	open() Opens a transport/connection to the datasource.
void	setScope(String scoped_db) Set the scope of this object.

Methods inherited from class java.lang.Object

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

Field Detail

scoped_db

protected String scoped_db

handle

protected Object handle

connector

protected DataConnector connector

driverClassName

protected String driverClassName

Constructor Detail

AbstractDataConnectorProvider

public AbstractDataConnectorProvider(String dbName,
                                     DataConnector connector,
                                     String driverClassName)

Method Detail

setScope

public final void setScope(String scoped_db)

Description copied from interface: IDataConnectorProvider

Set the scope of this object.

Specified by:

setScope in interface IDataConnectorProvider

open

public void open()
          throws ConnectException,
                 MetaException

Opens a transport/connection to the datasource. Throws exception if the connection cannot be established.

Specified by:

open in interface IDataConnectorProvider

Throws:

MetaException - Throws MetaException if the connector does not have all info for a connection to be setup.

ConnectException - if the connection could not be established for some reason.

close

public void close()
           throws ConnectException

Closes a transport/connection to the datasource.

Specified by:

close in interface IDataConnectorProvider

Throws:

ConnectException - if the connection could not be closed.

getTables

public List<Table> getTables(String regex)
                      throws MetaException

Returns Hive Table objects from the remote database for tables that match a name pattern.

Specified by:

getTables in interface IDataConnectorProvider

Parameters:

regex -

Returns:

List A collection of objects that match the name pattern, null otherwise.

Throws:

MetaException - To indicate any failures with executing this API

getTableNames

public List<String> getTableNames()
                           throws MetaException

Returns a list of all table names from the remote database.

Specified by:

getTableNames in interface IDataConnectorProvider

Returns:

List A collection of all the table names, null if there are no tables.

Throws:

MetaException - To indicate any failures with executing this API

getTable

public Table getTable(String tableName)
               throws MetaException

Fetch a single table with the given name, returns a Hive Table object from the remote database

Specified by:

getTable in interface IDataConnectorProvider

Parameters:

tableName -

Returns:

Table A Table object for the matching table, null otherwise.

Throws:

MetaException - To indicate any failures with executing this API

createTable

public boolean createTable(Table table)
                    throws MetaException

Description copied from interface: IDataConnectorProvider

Creates a table with the given name in the remote data source. Conversion between hive data types and native data types is handled by the provider.

Specified by:

createTable in interface IDataConnectorProvider

Parameters:

table - A Hive table object to translate and create in remote data source.

Returns:

boolean True if the operation succeeded or false otherwise

Throws:

MetaException - To indicate any failures in executing this operation.

dropTable

public boolean dropTable(String tableName)
                  throws MetaException

Description copied from interface: IDataConnectorProvider

Drop an existing table with the given name in the remote data source.

Specified by:

dropTable in interface IDataConnectorProvider

Parameters:

tableName - Table name to drop from the remote data source.

Returns:

boolean True if the operation succeeded or false otherwise

Throws:

MetaException - To indicate any failures in executing this operation.

alterTable

public boolean alterTable(String tableName,
                          Table table)
                   throws MetaException

Description copied from interface: IDataConnectorProvider

Alter an existing table in the remote data source.

Specified by:

alterTable in interface IDataConnectorProvider

Parameters:

tableName - Table name to alter in the remote datasource.

table - New Table object to modify the existing table with.

Returns:

boolean True if the operation succeeded or false otherwise.

Throws:

MetaException - To indicate any failures in executing this operation.

buildTableFromColsList

protected Table buildTableFromColsList(String tableName,
                                       List<FieldSchema> cols)

getInputClass

protected abstract String getInputClass()

getOutputClass

protected abstract String getOutputClass()

getTableLocation

protected abstract String getTableLocation(String tblName)

getDatasourceType

protected abstract String getDatasourceType()