org.apache.hadoop.hive.metastore

Interface HiveMetaHook

All Known Implementing Classes:

AccumuloStorageHandler, DefaultHiveMetaHook, DruidStorageHandler, HBaseMetaHook

@InterfaceAudience.Public
 @InterfaceStability.Stable
public interface HiveMetaHook

HiveMetaHook defines notification methods which are invoked as part of transactions against the metastore, allowing external catalogs such as HBase to be kept in sync with Hive's metastore.

Implementations can use MetaStoreUtils.isExternalTable(org.apache.hadoop.hive.metastore.api.Table) to distinguish external tables from managed tables.

Field Summary

Fields

Modifier and Type	Field and Description
static List<String>	allowedAlterTypes
static String	ALTER_TABLE_OPERATION_TYPE

Method Summary

Modifier and Type	Method and Description
void	commitCreateTable(org.apache.hadoop.hive.metastore.api.Table table) Called after successfully adding a new table definition to the metastore during CREATE TABLE.
void	commitDropTable(org.apache.hadoop.hive.metastore.api.Table table, boolean deleteData) Called after successfully removing a table definition from the metastore during DROP TABLE.
default void	preAlterTable(org.apache.hadoop.hive.metastore.api.Table table, org.apache.hadoop.hive.metastore.api.EnvironmentContext context) Called before a table is altered in the metastore during ALTER TABLE.
void	preCreateTable(org.apache.hadoop.hive.metastore.api.Table table) Called before a new table definition is added to the metastore during CREATE TABLE.
void	preDropTable(org.apache.hadoop.hive.metastore.api.Table table) Called before a table definition is removed from the metastore during DROP TABLE.
void	rollbackCreateTable(org.apache.hadoop.hive.metastore.api.Table table) Called after failure adding a new table definition to the metastore during CREATE TABLE.
void	rollbackDropTable(org.apache.hadoop.hive.metastore.api.Table table) Called after failure removing a table definition from the metastore during DROP TABLE.

Field Detail

ALTER_TABLE_OPERATION_TYPE

static final String ALTER_TABLE_OPERATION_TYPE

See Also:

Constant Field Values

allowedAlterTypes

static final List<String> allowedAlterTypes

Method Detail

preCreateTable

void preCreateTable(org.apache.hadoop.hive.metastore.api.Table table)
             throws org.apache.hadoop.hive.metastore.api.MetaException

Called before a new table definition is added to the metastore during CREATE TABLE.

Parameters:

table - new table definition

Throws:

org.apache.hadoop.hive.metastore.api.MetaException

rollbackCreateTable

void rollbackCreateTable(org.apache.hadoop.hive.metastore.api.Table table)
                  throws org.apache.hadoop.hive.metastore.api.MetaException

Called after failure adding a new table definition to the metastore during CREATE TABLE.

Parameters:

table - new table definition

Throws:

org.apache.hadoop.hive.metastore.api.MetaException

commitCreateTable

void commitCreateTable(org.apache.hadoop.hive.metastore.api.Table table)
                throws org.apache.hadoop.hive.metastore.api.MetaException

Called after successfully adding a new table definition to the metastore during CREATE TABLE.

Parameters:

table - new table definition

Throws:

org.apache.hadoop.hive.metastore.api.MetaException

preDropTable

void preDropTable(org.apache.hadoop.hive.metastore.api.Table table)
           throws org.apache.hadoop.hive.metastore.api.MetaException

Called before a table definition is removed from the metastore during DROP TABLE.

Parameters:

table - table definition

Throws:

org.apache.hadoop.hive.metastore.api.MetaException

rollbackDropTable

void rollbackDropTable(org.apache.hadoop.hive.metastore.api.Table table)
                throws org.apache.hadoop.hive.metastore.api.MetaException

Called after failure removing a table definition from the metastore during DROP TABLE.

Parameters:

table - table definition

Throws:

org.apache.hadoop.hive.metastore.api.MetaException

commitDropTable

void commitDropTable(org.apache.hadoop.hive.metastore.api.Table table,
                     boolean deleteData)
              throws org.apache.hadoop.hive.metastore.api.MetaException

Called after successfully removing a table definition from the metastore during DROP TABLE.

Parameters:

table - table definition

deleteData - whether to delete data as well; this should typically be ignored in the case of an external table

Throws:

org.apache.hadoop.hive.metastore.api.MetaException

preAlterTable

default void preAlterTable(org.apache.hadoop.hive.metastore.api.Table table,
                           org.apache.hadoop.hive.metastore.api.EnvironmentContext context)
                    throws org.apache.hadoop.hive.metastore.api.MetaException

Called before a table is altered in the metastore during ALTER TABLE.

Parameters:

table - new table definition

Throws:

org.apache.hadoop.hive.metastore.api.MetaException