org.apache.hadoop.hive.metastore

Interface IMetaStoreClient

All Known Implementing Classes:

HiveMetaStoreClient

public interface IMetaStoreClient

TODO Unnecessary when the server sides for both dbstore and filestore are merged

Method Summary

Modifier and Type	Method and Description
Partition	add_partition(Partition partition) Add a partition to the table.
int	add_partitions(java.util.List<Partition> partitions) Add partitions to the table.
void	alter_index(java.lang.String dbName, java.lang.String tblName, java.lang.String indexName, Index index)
void	alter_partition(java.lang.String dbName, java.lang.String tblName, Partition newPart) updates a partition to new partition
void	alter_partitions(java.lang.String dbName, java.lang.String tblName, java.util.List<Partition> newParts) updates a list of partitions
void	alter_table(java.lang.String defaultDatabaseName, java.lang.String tblName, Table table)
void	alterDatabase(java.lang.String name, Database db)
Partition	appendPartition(java.lang.String tableName, java.lang.String dbName, java.util.List<java.lang.String> partVals)
Partition	appendPartition(java.lang.String tableName, java.lang.String dbName, java.lang.String name)
void	cancelDelegationToken(java.lang.String tokenStrForm)
void	close()
boolean	create_role(Role role)
void	createDatabase(Database db)
void	createIndex(Index index, Table indexTable) create an index
void	createTable(Table tbl)
boolean	deletePartitionColumnStatistics(java.lang.String dbName, java.lang.String tableName, java.lang.String partName, java.lang.String colName) Delete partition level column statistics given dbName, tableName, partName and colName
boolean	deleteTableColumnStatistics(java.lang.String dbName, java.lang.String tableName, java.lang.String colName) Delete table level column statistics given dbName, tableName and colName
boolean	drop_role(java.lang.String role_name)
void	dropDatabase(java.lang.String name)
void	dropDatabase(java.lang.String name, boolean deleteData, boolean ignoreUnknownDb)
void	dropDatabase(java.lang.String name, boolean deleteData, boolean ignoreUnknownDb, boolean cascade)
boolean	dropIndex(java.lang.String db_name, java.lang.String tbl_name, java.lang.String name, boolean deleteData)
boolean	dropPartition(java.lang.String db_name, java.lang.String tbl_name, java.util.List<java.lang.String> part_vals, boolean deleteData)
boolean	dropPartition(java.lang.String db_name, java.lang.String tbl_name, java.lang.String name, boolean deleteData)
void	dropTable(java.lang.String tableName, boolean deleteData) Deprecated. As of release 0.6.0 replaced by dropTable(String, String, boolean, boolean). This method will be removed in release 0.7.0.
void	dropTable(java.lang.String dbname, java.lang.String tableName)
void	dropTable(java.lang.String dbname, java.lang.String tableName, boolean deleteData, boolean ignoreUknownTab) Drop the table.
Partition	exchange_partition(java.util.Map<java.lang.String,java.lang.String> partitionSpecs, java.lang.String sourceDb, java.lang.String sourceTable, java.lang.String destdb, java.lang.String destTableName)
PrincipalPrivilegeSet	get_privilege_set(HiveObjectRef hiveObject, java.lang.String user_name, java.util.List<java.lang.String> group_names)
java.util.List<java.lang.String>	getAllDatabases() Get the names of all databases in the MetaStore.
java.util.List<java.lang.String>	getAllTables(java.lang.String dbName) Get the names of all tables in the specified database.
java.lang.String	getConfigValue(java.lang.String name, java.lang.String defaultValue)
Database	getDatabase(java.lang.String databaseName) Get a Database Object
java.util.List<java.lang.String>	getDatabases(java.lang.String databasePattern) Get the names of all databases in the MetaStore that match the given pattern.
java.lang.String	getDelegationToken(java.lang.String owner, java.lang.String renewerKerberosPrincipalName)
java.util.List<FieldSchema>	getFields(java.lang.String db, java.lang.String tableName)
Index	getIndex(java.lang.String dbName, java.lang.String tblName, java.lang.String indexName)
Partition	getPartition(java.lang.String tblName, java.lang.String dbName, java.util.List<java.lang.String> partVals)
Partition	getPartition(java.lang.String dbName, java.lang.String tblName, java.lang.String name)
ColumnStatistics	getPartitionColumnStatistics(java.lang.String dbName, java.lang.String tableName, java.lang.String partitionName, java.lang.String colName) Get partition level column statistics given dbName, tableName, partitionName and colName
java.util.List<Partition>	getPartitionsByNames(java.lang.String db_name, java.lang.String tbl_name, java.util.List<java.lang.String> part_names) Get partitions by a list of partition names.
Partition	getPartitionWithAuthInfo(java.lang.String dbName, java.lang.String tableName, java.util.List<java.lang.String> pvals, java.lang.String userName, java.util.List<java.lang.String> groupNames)
java.util.List<FieldSchema>	getSchema(java.lang.String db, java.lang.String tableName)
Table	getTable(java.lang.String tableName) Deprecated. As of release 0.6.0 replaced by getTable(String, String). This method will be removed in release 0.7.0.
Table	getTable(java.lang.String dbName, java.lang.String tableName) Get a table object.
ColumnStatistics	getTableColumnStatistics(java.lang.String dbName, java.lang.String tableName, java.lang.String colName) Get table level column statistics given dbName, tableName and colName
java.util.List<Table>	getTableObjectsByName(java.lang.String dbName, java.util.List<java.lang.String> tableNames)
java.util.List<java.lang.String>	getTables(java.lang.String dbName, java.lang.String tablePattern) Get the names of all tables in the specified database that satisfy the supplied table name pattern.
boolean	grant_privileges(PrivilegeBag privileges)
boolean	grant_role(java.lang.String role_name, java.lang.String user_name, PrincipalType principalType, java.lang.String grantor, PrincipalType grantorType, boolean grantOption)
boolean	isPartitionMarkedForEvent(java.lang.String db_name, java.lang.String tbl_name, java.util.Map<java.lang.String,java.lang.String> partKVs, PartitionEventType eventType)
java.util.List<HiveObjectPrivilege>	list_privileges(java.lang.String principal_name, PrincipalType principal_type, HiveObjectRef hiveObject)
java.util.List<Role>	list_roles(java.lang.String principalName, PrincipalType principalType)
java.util.List<Index>	listIndexes(java.lang.String db_name, java.lang.String tbl_name, short max) list indexes of the give base table
java.util.List<java.lang.String>	listIndexNames(java.lang.String db_name, java.lang.String tbl_name, short max) list all the index names of the give base table.
java.util.List<java.lang.String>	listPartitionNames(java.lang.String db_name, java.lang.String tbl_name, java.util.List<java.lang.String> part_vals, short max_parts)
java.util.List<java.lang.String>	listPartitionNames(java.lang.String db_name, java.lang.String tbl_name, short max_parts)
java.util.List<Partition>	listPartitions(java.lang.String db_name, java.lang.String tbl_name, java.util.List<java.lang.String> part_vals, short max_parts)
java.util.List<Partition>	listPartitions(java.lang.String db_name, java.lang.String tbl_name, short max_parts)
java.util.List<Partition>	listPartitionsByFilter(java.lang.String db_name, java.lang.String tbl_name, java.lang.String filter, short max_parts) Get list of partitions matching specified filter
java.util.List<Partition>	listPartitionsWithAuthInfo(java.lang.String dbName, java.lang.String tableName, java.util.List<java.lang.String> partialPvals, short s, java.lang.String userName, java.util.List<java.lang.String> groupNames)
java.util.List<Partition>	listPartitionsWithAuthInfo(java.lang.String dbName, java.lang.String tableName, short s, java.lang.String userName, java.util.List<java.lang.String> groupNames)
java.util.List<java.lang.String>	listRoleNames() list all role names
java.util.List<java.lang.String>	listTableNamesByFilter(java.lang.String dbName, java.lang.String filter, short maxTables) Get a list of table names that match a filter.
void	markPartitionForEvent(java.lang.String db_name, java.lang.String tbl_name, java.util.Map<java.lang.String,java.lang.String> partKVs, PartitionEventType eventType)
java.util.Map<java.lang.String,java.lang.String>	partitionNameToSpec(java.lang.String name)
java.util.List<java.lang.String>	partitionNameToVals(java.lang.String name)
void	reconnect() Tries to reconnect this MetaStoreClient to the MetaStore.
void	renamePartition(java.lang.String dbname, java.lang.String name, java.util.List<java.lang.String> part_vals, Partition newPart) rename a partition to a new partition
long	renewDelegationToken(java.lang.String tokenStrForm)
boolean	revoke_privileges(PrivilegeBag privileges)
boolean	revoke_role(java.lang.String role_name, java.lang.String user_name, PrincipalType principalType)
boolean	tableExists(java.lang.String tableName) Deprecated. As of release 0.6.0 replaced by tableExists(String, String). This method will be removed in release 0.7.0.
boolean	tableExists(java.lang.String databaseName, java.lang.String tableName)
boolean	updatePartitionColumnStatistics(ColumnStatistics statsObj) Write partition level column statistics to persistent store
boolean	updateTableColumnStatistics(ColumnStatistics statsObj) Write table level column statistics to persistent store
void	validatePartitionNameCharacters(java.util.List<java.lang.String> partVals)

Method Detail

reconnect

void reconnect()
        throws MetaException

Tries to reconnect this MetaStoreClient to the MetaStore.

Throws:

MetaException

close

void close()

getDatabases

java.util.List<java.lang.String> getDatabases(java.lang.String databasePattern)
                                       throws MetaException,
                                              org.apache.thrift.TException

Get the names of all databases in the MetaStore that match the given pattern.

Parameters:

databasePattern -

Returns:

List of database names.

Throws:

MetaException

org.apache.thrift.TException

getAllDatabases

java.util.List<java.lang.String> getAllDatabases()
                                          throws MetaException,
                                                 org.apache.thrift.TException

Get the names of all databases in the MetaStore.

Returns:

List of database names.

Throws:

MetaException

org.apache.thrift.TException

getTables

java.util.List<java.lang.String> getTables(java.lang.String dbName,
                                           java.lang.String tablePattern)
                                    throws MetaException,
                                           org.apache.thrift.TException,
                                           UnknownDBException

Get the names of all tables in the specified database that satisfy the supplied table name pattern.

Parameters:

dbName -

tablePattern -

Returns:

List of table names.

Throws:

MetaException

org.apache.thrift.TException

UnknownDBException

getAllTables

java.util.List<java.lang.String> getAllTables(java.lang.String dbName)
                                       throws MetaException,
                                              org.apache.thrift.TException,
                                              UnknownDBException

Get the names of all tables in the specified database.

Parameters:

dbName -

Returns:

List of table names.

Throws:

MetaException

org.apache.thrift.TException

UnknownDBException

listTableNamesByFilter

java.util.List<java.lang.String> listTableNamesByFilter(java.lang.String dbName,
                                                        java.lang.String filter,
                                                        short maxTables)
                                                 throws MetaException,
                                                        org.apache.thrift.TException,
                                                        InvalidOperationException,
                                                        UnknownDBException

Get a list of table names that match a filter. The filter operators are LIKE, <, <=, >, >=, =, <> In the filter statement, values interpreted as strings must be enclosed in quotes, while values interpreted as integers should not be. Strings and integers are the only supported value types. The currently supported key names in the filter are: Constants.HIVE_FILTER_FIELD_OWNER, which filters on the tables' owner's name and supports all filter operators Constants.HIVE_FILTER_FIELD_LAST_ACCESS, which filters on the last access times and supports all filter operators except LIKE Constants.HIVE_FILTER_FIELD_PARAMS, which filters on the tables' parameter keys and values and only supports the filter operators = and <>. Append the parameter key name to HIVE_FILTER_FIELD_PARAMS in the filter statement. For example, to filter on parameter keys called "retention", the key name in the filter statement should be Constants.HIVE_FILTER_FIELD_PARAMS + "retention" Also, = and <> only work for keys that exist in the tables. E.g., filtering on tables where key1 <> value will only return tables that have a value for the parameter key1. Some example filter statements include: filter = Constants.HIVE_FILTER_FIELD_OWNER + " like \".*test.*\" and " + Constants.HIVE_FILTER_FIELD_LAST_ACCESS + " = 0"; filter = Constants.HIVE_FILTER_FIELD_OWNER + " = \"test_user\" and (" + Constants.HIVE_FILTER_FIELD_PARAMS + "retention = \"30\" or " + Constants.HIVE_FILTER_FIELD_PARAMS + "retention = \"90\")"

Parameters:

dbName - The name of the database from which you will retrieve the table names

filter - The filter string

maxTables - The maximum number of tables returned

Returns:

A list of table names that match the desired filter

Throws:

MetaException

org.apache.thrift.TException

InvalidOperationException

UnknownDBException

dropTable

void dropTable(java.lang.String dbname,
               java.lang.String tableName,
               boolean deleteData,
               boolean ignoreUknownTab)
        throws MetaException,
               org.apache.thrift.TException,
               NoSuchObjectException

Drop the table.

Parameters:

dbname - The database for this table

tableName - The table to drop

Throws:

MetaException - Could not drop table properly.

NoSuchObjectException - The table wasn't found.

org.apache.thrift.TException - A thrift communication error occurred

ExistingDependentsException

dropTable

@Deprecated
void dropTable(java.lang.String tableName,
                           boolean deleteData)
                    throws MetaException,
                           UnknownTableException,
                           org.apache.thrift.TException,
                           NoSuchObjectException

Deprecated. As of release 0.6.0 replaced by dropTable(String, String, boolean, boolean). This method will be removed in release 0.7.0.

Drop the table in the DEFAULT database.

Parameters:

tableName - The table to drop

deleteData - Should we delete the underlying data

Throws:

MetaException - Could not drop table properly.

UnknownTableException - The table wasn't found.

org.apache.thrift.TException - A thrift communication error occurred

NoSuchObjectException - The table wasn't found.

dropTable

void dropTable(java.lang.String dbname,
               java.lang.String tableName)
        throws MetaException,
               org.apache.thrift.TException,
               NoSuchObjectException

Throws:

MetaException

org.apache.thrift.TException

NoSuchObjectException

tableExists

boolean tableExists(java.lang.String databaseName,
                    java.lang.String tableName)
             throws MetaException,
                    org.apache.thrift.TException,
                    UnknownDBException

Throws:

MetaException

org.apache.thrift.TException

UnknownDBException

tableExists

@Deprecated
boolean tableExists(java.lang.String tableName)
                         throws MetaException,
                                org.apache.thrift.TException,
                                UnknownDBException

Deprecated. As of release 0.6.0 replaced by tableExists(String, String). This method will be removed in release 0.7.0.

Check to see if the specified table exists in the DEFAULT database.

Parameters:

tableName -

Returns:

TRUE if DEFAULT.tableName exists, FALSE otherwise.

Throws:

MetaException

org.apache.thrift.TException

UnknownDBException

getTable

@Deprecated
Table getTable(java.lang.String tableName)
                    throws MetaException,
                           org.apache.thrift.TException,
                           NoSuchObjectException

Deprecated. As of release 0.6.0 replaced by getTable(String, String). This method will be removed in release 0.7.0.

Get a table object from the DEFAULT database.

Parameters:

tableName - Name of the table to fetch.

Returns:

An object representing the table.

Throws:

MetaException - Could not fetch the table

org.apache.thrift.TException - A thrift communication error occurred

NoSuchObjectException - In case the table wasn't found.

getDatabase

Database getDatabase(java.lang.String databaseName)
              throws NoSuchObjectException,
                     MetaException,
                     org.apache.thrift.TException

Get a Database Object

Parameters:

databaseName - name of the database to fetch

Returns:

the database

Throws:

NoSuchObjectException - The database does not exist

MetaException - Could not fetch the database

org.apache.thrift.TException - A thrift communication error occurred

getTable

Table getTable(java.lang.String dbName,
               java.lang.String tableName)
        throws MetaException,
               org.apache.thrift.TException,
               NoSuchObjectException

Get a table object.

Parameters:

dbName - The database the table is located in.

tableName - Name of the table to fetch.

Returns:

An object representing the table.

Throws:

MetaException - Could not fetch the table

org.apache.thrift.TException - A thrift communication error occurred

NoSuchObjectException - In case the table wasn't found.

getTableObjectsByName

java.util.List<Table> getTableObjectsByName(java.lang.String dbName,
                                            java.util.List<java.lang.String> tableNames)
                                     throws MetaException,
                                            InvalidOperationException,
                                            UnknownDBException,
                                            org.apache.thrift.TException

Parameters:

dbName - The database the tables are located in.

tableNames - The names of the tables to fetch

Returns:

A list of objects representing the tables. Only the tables that can be retrieved from the database are returned. For example, if none of the requested tables could be retrieved, an empty list is returned. There is no guarantee of ordering of the returned tables.

Throws:

InvalidOperationException - The input to this operation is invalid (e.g., the list of tables names is null)

UnknownDBException - The requested database could not be fetched.

org.apache.thrift.TException - A thrift communication error occurred

MetaException - Any other errors

appendPartition

Partition appendPartition(java.lang.String tableName,
                          java.lang.String dbName,
                          java.util.List<java.lang.String> partVals)
                   throws InvalidObjectException,
                          AlreadyExistsException,
                          MetaException,
                          org.apache.thrift.TException

Parameters:

tableName -

dbName -

partVals -

Returns:

the partition object

Throws:

InvalidObjectException

AlreadyExistsException

MetaException

org.apache.thrift.TException

See Also:

ThriftHiveMetastore.Iface.append_partition(java.lang.String, java.lang.String, java.util.List)

appendPartition

Partition appendPartition(java.lang.String tableName,
                          java.lang.String dbName,
                          java.lang.String name)
                   throws InvalidObjectException,
                          AlreadyExistsException,
                          MetaException,
                          org.apache.thrift.TException

Throws:

InvalidObjectException

AlreadyExistsException

MetaException

org.apache.thrift.TException

add_partition

Partition add_partition(Partition partition)
                 throws InvalidObjectException,
                        AlreadyExistsException,
                        MetaException,
                        org.apache.thrift.TException

Add a partition to the table.

Parameters:

partition - The partition to add

Returns:

The partition added

Throws:

InvalidObjectException - Could not find table to add to

AlreadyExistsException - Partition already exists

MetaException - Could not add partition

org.apache.thrift.TException - Thrift exception

add_partitions

int add_partitions(java.util.List<Partition> partitions)
            throws InvalidObjectException,
                   AlreadyExistsException,
                   MetaException,
                   org.apache.thrift.TException

Add partitions to the table.

Parameters:

partitions - The partitions to add

Throws:

InvalidObjectException - Could not find table to add to

AlreadyExistsException - Partition already exists

MetaException - Could not add partition

org.apache.thrift.TException - Thrift exception

getPartition

Partition getPartition(java.lang.String tblName,
                       java.lang.String dbName,
                       java.util.List<java.lang.String> partVals)
                throws NoSuchObjectException,
                       MetaException,
                       org.apache.thrift.TException

Parameters:

tblName -

dbName -

partVals -

Returns:

the partition object

Throws:

MetaException

org.apache.thrift.TException

NoSuchObjectException

See Also:

ThriftHiveMetastore.Iface.get_partition(java.lang.String, java.lang.String, java.util.List)

exchange_partition

Partition exchange_partition(java.util.Map<java.lang.String,java.lang.String> partitionSpecs,
                             java.lang.String sourceDb,
                             java.lang.String sourceTable,
                             java.lang.String destdb,
                             java.lang.String destTableName)
                      throws MetaException,
                             NoSuchObjectException,
                             InvalidObjectException,
                             org.apache.thrift.TException

Parameters:

partition -

destdb -

destTableName -

Returns:

partition object

Throws:

MetaException

NoSuchObjectException

InvalidObjectException

org.apache.thrift.TException

getPartition

Partition getPartition(java.lang.String dbName,
                       java.lang.String tblName,
                       java.lang.String name)
                throws MetaException,
                       UnknownTableException,
                       NoSuchObjectException,
                       org.apache.thrift.TException

Parameters:

dbName -

tblName -

name - - partition name i.e. 'ds=2010-02-03/ts=2010-02-03 18%3A16%3A01'

Returns:

the partition object

Throws:

MetaException

org.apache.thrift.TException

UnknownTableException

NoSuchObjectException

See Also:

ThriftHiveMetastore.Iface.get_partition(java.lang.String, java.lang.String, java.util.List)

getPartitionWithAuthInfo

Partition getPartitionWithAuthInfo(java.lang.String dbName,
                                   java.lang.String tableName,
                                   java.util.List<java.lang.String> pvals,
                                   java.lang.String userName,
                                   java.util.List<java.lang.String> groupNames)
                            throws MetaException,
                                   UnknownTableException,
                                   NoSuchObjectException,
                                   org.apache.thrift.TException

Parameters:

dbName -

tableName -

pvals -

userName -

groupNames -

Returns:

the partition

Throws:

MetaException

UnknownTableException

NoSuchObjectException

org.apache.thrift.TException

listPartitions

java.util.List<Partition> listPartitions(java.lang.String db_name,
                                         java.lang.String tbl_name,
                                         short max_parts)
                                  throws NoSuchObjectException,
                                         MetaException,
                                         org.apache.thrift.TException

Parameters:

tbl_name -

db_name -

max_parts -

Returns:

the list of partitions

Throws:

NoSuchObjectException

MetaException

org.apache.thrift.TException

listPartitions

java.util.List<Partition> listPartitions(java.lang.String db_name,
                                         java.lang.String tbl_name,
                                         java.util.List<java.lang.String> part_vals,
                                         short max_parts)
                                  throws NoSuchObjectException,
                                         MetaException,
                                         org.apache.thrift.TException

Throws:

NoSuchObjectException

MetaException

org.apache.thrift.TException

listPartitionNames

java.util.List<java.lang.String> listPartitionNames(java.lang.String db_name,
                                                    java.lang.String tbl_name,
                                                    short max_parts)
                                             throws MetaException,
                                                    org.apache.thrift.TException

Throws:

MetaException

org.apache.thrift.TException

listPartitionNames

java.util.List<java.lang.String> listPartitionNames(java.lang.String db_name,
                                                    java.lang.String tbl_name,
                                                    java.util.List<java.lang.String> part_vals,
                                                    short max_parts)
                                             throws MetaException,
                                                    org.apache.thrift.TException,
                                                    NoSuchObjectException

Throws:

MetaException

org.apache.thrift.TException

NoSuchObjectException

listPartitionsByFilter

java.util.List<Partition> listPartitionsByFilter(java.lang.String db_name,
                                                 java.lang.String tbl_name,
                                                 java.lang.String filter,
                                                 short max_parts)
                                          throws MetaException,
                                                 NoSuchObjectException,
                                                 org.apache.thrift.TException

Get list of partitions matching specified filter

Parameters:

db_name - the database name

tbl_name - the table name

filter - the filter string, for example "part1 = \"p1_abc\" and part2 <= "\p2_test\"". Filtering can be done only on string partition keys.

max_parts - the maximum number of partitions to return, all partitions are returned if -1 is passed

Returns:

list of partitions

Throws:

MetaException

NoSuchObjectException

org.apache.thrift.TException

listPartitionsWithAuthInfo

java.util.List<Partition> listPartitionsWithAuthInfo(java.lang.String dbName,
                                                     java.lang.String tableName,
                                                     short s,
                                                     java.lang.String userName,
                                                     java.util.List<java.lang.String> groupNames)
                                              throws MetaException,
                                                     org.apache.thrift.TException,
                                                     NoSuchObjectException

Parameters:

dbName -

tableName -

s -

userName -

groupNames -

Returns:

the list of partitions

Throws:

NoSuchObjectException

MetaException

org.apache.thrift.TException

getPartitionsByNames

java.util.List<Partition> getPartitionsByNames(java.lang.String db_name,
                                               java.lang.String tbl_name,
                                               java.util.List<java.lang.String> part_names)
                                        throws NoSuchObjectException,
                                               MetaException,
                                               org.apache.thrift.TException

Get partitions by a list of partition names.

Parameters:

db_name - database name

tbl_name - table name

part_names - list of partition names

Returns:

list of Partition objects

Throws:

NoSuchObjectException

MetaException

org.apache.thrift.TException

listPartitionsWithAuthInfo

java.util.List<Partition> listPartitionsWithAuthInfo(java.lang.String dbName,
                                                     java.lang.String tableName,
                                                     java.util.List<java.lang.String> partialPvals,
                                                     short s,
                                                     java.lang.String userName,
                                                     java.util.List<java.lang.String> groupNames)
                                              throws MetaException,
                                                     org.apache.thrift.TException,
                                                     NoSuchObjectException

Parameters:

dbName -

tableName -

partialPvals -

s -

userName -

groupNames -

Returns:

the list of paritions

Throws:

NoSuchObjectException

MetaException

org.apache.thrift.TException

markPartitionForEvent

void markPartitionForEvent(java.lang.String db_name,
                           java.lang.String tbl_name,
                           java.util.Map<java.lang.String,java.lang.String> partKVs,
                           PartitionEventType eventType)
                    throws MetaException,
                           NoSuchObjectException,
                           org.apache.thrift.TException,
                           UnknownTableException,
                           UnknownDBException,
                           UnknownPartitionException,
                           InvalidPartitionException

Parameters:

db_name -

tbl_name -

partKVs -

eventType -

Throws:

MetaException

NoSuchObjectException

org.apache.thrift.TException

UnknownTableException

UnknownDBException

UnknownPartitionException

InvalidPartitionException

isPartitionMarkedForEvent

boolean isPartitionMarkedForEvent(java.lang.String db_name,
                                  java.lang.String tbl_name,
                                  java.util.Map<java.lang.String,java.lang.String> partKVs,
                                  PartitionEventType eventType)
                           throws MetaException,
                                  NoSuchObjectException,
                                  org.apache.thrift.TException,
                                  UnknownTableException,
                                  UnknownDBException,
                                  UnknownPartitionException,
                                  InvalidPartitionException

Parameters:

db_name -

tbl_name -

partKVs -

eventType -

Throws:

MetaException

NoSuchObjectException

org.apache.thrift.TException

UnknownTableException

UnknownDBException

UnknownPartitionException

InvalidPartitionException

validatePartitionNameCharacters

void validatePartitionNameCharacters(java.util.List<java.lang.String> partVals)
                              throws org.apache.thrift.TException,
                                     MetaException

Parameters:

partVals -

Throws:

org.apache.thrift.TException

MetaException

createTable

void createTable(Table tbl)
          throws AlreadyExistsException,
                 InvalidObjectException,
                 MetaException,
                 NoSuchObjectException,
                 org.apache.thrift.TException

Parameters:

tbl -

Throws:

AlreadyExistsException

InvalidObjectException

MetaException

NoSuchObjectException

org.apache.thrift.TException

See Also:

ThriftHiveMetastore.Iface.create_table(org.apache.hadoop.hive.metastore.api.Table)

alter_table

void alter_table(java.lang.String defaultDatabaseName,
                 java.lang.String tblName,
                 Table table)
          throws InvalidOperationException,
                 MetaException,
                 org.apache.thrift.TException

Throws:

InvalidOperationException

MetaException

org.apache.thrift.TException

createDatabase

void createDatabase(Database db)
             throws InvalidObjectException,
                    AlreadyExistsException,
                    MetaException,
                    org.apache.thrift.TException

Throws:

InvalidObjectException

AlreadyExistsException

MetaException

org.apache.thrift.TException

dropDatabase

void dropDatabase(java.lang.String name)
           throws NoSuchObjectException,
                  InvalidOperationException,
                  MetaException,
                  org.apache.thrift.TException

Throws:

NoSuchObjectException

InvalidOperationException

MetaException

org.apache.thrift.TException

dropDatabase

void dropDatabase(java.lang.String name,
                  boolean deleteData,
                  boolean ignoreUnknownDb)
           throws NoSuchObjectException,
                  InvalidOperationException,
                  MetaException,
                  org.apache.thrift.TException

Throws:

NoSuchObjectException

InvalidOperationException

MetaException

org.apache.thrift.TException

dropDatabase

void dropDatabase(java.lang.String name,
                  boolean deleteData,
                  boolean ignoreUnknownDb,
                  boolean cascade)
           throws NoSuchObjectException,
                  InvalidOperationException,
                  MetaException,
                  org.apache.thrift.TException

Throws:

NoSuchObjectException

InvalidOperationException

MetaException

org.apache.thrift.TException

alterDatabase

void alterDatabase(java.lang.String name,
                   Database db)
            throws NoSuchObjectException,
                   MetaException,
                   org.apache.thrift.TException

Throws:

NoSuchObjectException

MetaException

org.apache.thrift.TException

dropPartition

boolean dropPartition(java.lang.String db_name,
                      java.lang.String tbl_name,
                      java.util.List<java.lang.String> part_vals,
                      boolean deleteData)
               throws NoSuchObjectException,
                      MetaException,
                      org.apache.thrift.TException

Parameters:

db_name -

tbl_name -

part_vals -

deleteData - delete the underlying data or just delete the table in metadata

Returns:

true or false

Throws:

NoSuchObjectException

MetaException

org.apache.thrift.TException

See Also:

ThriftHiveMetastore.Iface.drop_partition(java.lang.String, java.lang.String, java.util.List, boolean)

dropPartition

boolean dropPartition(java.lang.String db_name,
                      java.lang.String tbl_name,
                      java.lang.String name,
                      boolean deleteData)
               throws NoSuchObjectException,
                      MetaException,
                      org.apache.thrift.TException

Throws:

NoSuchObjectException

MetaException

org.apache.thrift.TException

alter_partition

void alter_partition(java.lang.String dbName,
                     java.lang.String tblName,
                     Partition newPart)
              throws InvalidOperationException,
                     MetaException,
                     org.apache.thrift.TException

updates a partition to new partition

Parameters:

dbName - database of the old partition

tblName - table name of the old partition

newPart - new partition

Throws:

InvalidOperationException - if the old partition does not exist

MetaException - if error in updating metadata

org.apache.thrift.TException - if error in communicating with metastore server

alter_partitions

void alter_partitions(java.lang.String dbName,
                      java.lang.String tblName,
                      java.util.List<Partition> newParts)
               throws InvalidOperationException,
                      MetaException,
                      org.apache.thrift.TException

updates a list of partitions

Parameters:

dbName - database of the old partition

tblName - table name of the old partition

newParts - list of partitions

Throws:

InvalidOperationException - if the old partition does not exist

MetaException - if error in updating metadata

org.apache.thrift.TException - if error in communicating with metastore server

renamePartition

void renamePartition(java.lang.String dbname,
                     java.lang.String name,
                     java.util.List<java.lang.String> part_vals,
                     Partition newPart)
              throws InvalidOperationException,
                     MetaException,
                     org.apache.thrift.TException

rename a partition to a new partition

Parameters:

dbname - database of the old partition

name - table name of the old partition

part_vals - values of the old partition

newPart - new partition

Throws:

InvalidOperationException - if srcFs and destFs are different

MetaException - if error in updating metadata

org.apache.thrift.TException - if error in communicating with metastore server

getFields

java.util.List<FieldSchema> getFields(java.lang.String db,
                                      java.lang.String tableName)
                               throws MetaException,
                                      org.apache.thrift.TException,
                                      UnknownTableException,
                                      UnknownDBException

Parameters:

db -

tableName -

Throws:

UnknownTableException

UnknownDBException

MetaException

org.apache.thrift.TException

See Also:

ThriftHiveMetastore.Iface.get_fields(java.lang.String, java.lang.String)

getSchema

java.util.List<FieldSchema> getSchema(java.lang.String db,
                                      java.lang.String tableName)
                               throws MetaException,
                                      org.apache.thrift.TException,
                                      UnknownTableException,
                                      UnknownDBException

Parameters:

db -

tableName -

Throws:

UnknownTableException

UnknownDBException

MetaException

org.apache.thrift.TException

See Also:

ThriftHiveMetastore.Iface.get_schema(java.lang.String, java.lang.String)

getConfigValue

java.lang.String getConfigValue(java.lang.String name,
                                java.lang.String defaultValue)
                         throws org.apache.thrift.TException,
                                ConfigValSecurityException

Parameters:

name - name of the configuration property to get the value of

defaultValue - the value to return if property with the given name doesn't exist

Returns:

value of the specified configuration property

Throws:

org.apache.thrift.TException

ConfigValSecurityException

partitionNameToVals

java.util.List<java.lang.String> partitionNameToVals(java.lang.String name)
                                              throws MetaException,
                                                     org.apache.thrift.TException

Parameters:

name - the partition name e.g. ("ds=2010-03-03/hr=12")

Returns:

a list containing the partition col values, in the same order as the name

Throws:

MetaException

org.apache.thrift.TException

partitionNameToSpec

java.util.Map<java.lang.String,java.lang.String> partitionNameToSpec(java.lang.String name)
                                                              throws MetaException,
                                                                     org.apache.thrift.TException

Parameters:

name - the partition name e.g. ("ds=2010-03-03/hr=12")

Returns:

a map from the partition col to the value, as listed in the name

Throws:

MetaException

org.apache.thrift.TException

createIndex

void createIndex(Index index,
                 Table indexTable)
          throws InvalidObjectException,
                 MetaException,
                 NoSuchObjectException,
                 org.apache.thrift.TException,
                 AlreadyExistsException

create an index

Parameters:

index - the index object

Throws:

InvalidObjectException

MetaException

NoSuchObjectException

org.apache.thrift.TException

AlreadyExistsException

alter_index

void alter_index(java.lang.String dbName,
                 java.lang.String tblName,
                 java.lang.String indexName,
                 Index index)
          throws InvalidOperationException,
                 MetaException,
                 org.apache.thrift.TException

Throws:

InvalidOperationException

MetaException

org.apache.thrift.TException

getIndex

Index getIndex(java.lang.String dbName,
               java.lang.String tblName,
               java.lang.String indexName)
        throws MetaException,
               UnknownTableException,
               NoSuchObjectException,
               org.apache.thrift.TException

Parameters:

dbName -

tblName -

indexName -

Returns:

the index

Throws:

MetaException

UnknownTableException

NoSuchObjectException

org.apache.thrift.TException

listIndexes

java.util.List<Index> listIndexes(java.lang.String db_name,
                                  java.lang.String tbl_name,
                                  short max)
                           throws NoSuchObjectException,
                                  MetaException,
                                  org.apache.thrift.TException

list indexes of the give base table

Parameters:

db_name -

tbl_name -

max -

Returns:

the list of indexes

Throws:

NoSuchObjectException

MetaException

org.apache.thrift.TException

listIndexNames

java.util.List<java.lang.String> listIndexNames(java.lang.String db_name,
                                                java.lang.String tbl_name,
                                                short max)
                                         throws MetaException,
                                                org.apache.thrift.TException

list all the index names of the give base table.

Parameters:

db_name -

tbl_name -

max -

Returns:

the list of names

Throws:

MetaException

org.apache.thrift.TException

dropIndex

boolean dropIndex(java.lang.String db_name,
                  java.lang.String tbl_name,
                  java.lang.String name,
                  boolean deleteData)
           throws NoSuchObjectException,
                  MetaException,
                  org.apache.thrift.TException

Parameters:

db_name -

tbl_name -

name - index name

deleteData -

Returns:

true on success

Throws:

NoSuchObjectException

MetaException

org.apache.thrift.TException

updateTableColumnStatistics

boolean updateTableColumnStatistics(ColumnStatistics statsObj)
                             throws NoSuchObjectException,
                                    InvalidObjectException,
                                    MetaException,
                                    org.apache.thrift.TException,
                                    InvalidInputException

Write table level column statistics to persistent store

Parameters:

statsObj -

Returns:

boolean indicating the status of the operation

Throws:

NoSuchObjectException

InvalidObjectException

MetaException

org.apache.thrift.TException

InvalidInputException

updatePartitionColumnStatistics

boolean updatePartitionColumnStatistics(ColumnStatistics statsObj)
                                 throws NoSuchObjectException,
                                        InvalidObjectException,
                                        MetaException,
                                        org.apache.thrift.TException,
                                        InvalidInputException

Write partition level column statistics to persistent store

Parameters:

statsObj -

Returns:

boolean indicating the status of the operation

Throws:

NoSuchObjectException

InvalidObjectException

MetaException

org.apache.thrift.TException

InvalidInputException

getTableColumnStatistics

ColumnStatistics getTableColumnStatistics(java.lang.String dbName,
                                          java.lang.String tableName,
                                          java.lang.String colName)
                                   throws NoSuchObjectException,
                                          MetaException,
                                          org.apache.thrift.TException,
                                          InvalidInputException,
                                          InvalidObjectException

Get table level column statistics given dbName, tableName and colName

Parameters:

dbName -

tableName -

colName -

Returns:

ColumnStatistics struct for a given db, table and col

Throws:

NoSuchObjectException

MetaException

org.apache.thrift.TException

InvalidInputException

InvalidObjectException

getPartitionColumnStatistics

ColumnStatistics getPartitionColumnStatistics(java.lang.String dbName,
                                              java.lang.String tableName,
                                              java.lang.String partitionName,
                                              java.lang.String colName)
                                       throws NoSuchObjectException,
                                              MetaException,
                                              org.apache.thrift.TException,
                                              InvalidInputException,
                                              InvalidObjectException

Get partition level column statistics given dbName, tableName, partitionName and colName

Parameters:

dbName -

tableName -

partitionName -

colName -

Returns:

ColumnStatistics struct for a given db, table, partition and col

Throws:

NoSuchObjectException

MetaException

org.apache.thrift.TException

InvalidInputException

InvalidObjectException

deletePartitionColumnStatistics

boolean deletePartitionColumnStatistics(java.lang.String dbName,
                                        java.lang.String tableName,
                                        java.lang.String partName,
                                        java.lang.String colName)
                                 throws NoSuchObjectException,
                                        MetaException,
                                        InvalidObjectException,
                                        org.apache.thrift.TException,
                                        InvalidInputException

Delete partition level column statistics given dbName, tableName, partName and colName

Parameters:

dbName -

tableName -

partName -

colName -

Returns:

boolean indicating outcome of the operation

Throws:

NoSuchObjectException

InvalidObjectException

MetaException

org.apache.thrift.TException

InvalidInputException

deleteTableColumnStatistics

boolean deleteTableColumnStatistics(java.lang.String dbName,
                                    java.lang.String tableName,
                                    java.lang.String colName)
                             throws NoSuchObjectException,
                                    MetaException,
                                    InvalidObjectException,
                                    org.apache.thrift.TException,
                                    InvalidInputException

Delete table level column statistics given dbName, tableName and colName

Parameters:

dbName -

tableName -

colName -

Returns:

boolean indicating the outcome of the operation

Throws:

NoSuchObjectException

MetaException

InvalidObjectException

org.apache.thrift.TException

InvalidInputException

create_role

boolean create_role(Role role)
             throws MetaException,
                    org.apache.thrift.TException

Parameters:

role - role object

Returns:

true on success

Throws:

MetaException

org.apache.thrift.TException

drop_role

boolean drop_role(java.lang.String role_name)
           throws MetaException,
                  org.apache.thrift.TException

Parameters:

role_name - role name

Returns:

true on success

Throws:

MetaException

org.apache.thrift.TException

listRoleNames

java.util.List<java.lang.String> listRoleNames()
                                        throws MetaException,
                                               org.apache.thrift.TException

list all role names

Returns:

list of names

Throws:

org.apache.thrift.TException

MetaException

grant_role

boolean grant_role(java.lang.String role_name,
                   java.lang.String user_name,
                   PrincipalType principalType,
                   java.lang.String grantor,
                   PrincipalType grantorType,
                   boolean grantOption)
            throws MetaException,
                   org.apache.thrift.TException

Parameters:

role_name -

user_name -

principalType -

grantor -

grantorType -

grantOption -

Returns:

true on success

Throws:

MetaException

org.apache.thrift.TException

revoke_role

boolean revoke_role(java.lang.String role_name,
                    java.lang.String user_name,
                    PrincipalType principalType)
             throws MetaException,
                    org.apache.thrift.TException

Parameters:

role_name - role name

user_name - user name

principalType -

Returns:

true on success

Throws:

MetaException

org.apache.thrift.TException

list_roles

java.util.List<Role> list_roles(java.lang.String principalName,
                                PrincipalType principalType)
                         throws MetaException,
                                org.apache.thrift.TException

Parameters:

principalName -

principalType -

Returns:

list of roles

Throws:

MetaException

org.apache.thrift.TException

get_privilege_set

PrincipalPrivilegeSet get_privilege_set(HiveObjectRef hiveObject,
                                        java.lang.String user_name,
                                        java.util.List<java.lang.String> group_names)
                                 throws MetaException,
                                        org.apache.thrift.TException

Parameters:

hiveObject -

user_name -

group_names -

Returns:

the privilege set

Throws:

MetaException

org.apache.thrift.TException

list_privileges

java.util.List<HiveObjectPrivilege> list_privileges(java.lang.String principal_name,
                                                    PrincipalType principal_type,
                                                    HiveObjectRef hiveObject)
                                             throws MetaException,
                                                    org.apache.thrift.TException

Parameters:

principal_name -

principal_type -

hiveObject -

Returns:

list of privileges

Throws:

MetaException

org.apache.thrift.TException

grant_privileges

boolean grant_privileges(PrivilegeBag privileges)
                  throws MetaException,
                         org.apache.thrift.TException

Parameters:

privileges -

Returns:

true on success

Throws:

MetaException

org.apache.thrift.TException

revoke_privileges

boolean revoke_privileges(PrivilegeBag privileges)
                   throws MetaException,
                          org.apache.thrift.TException

Parameters:

privileges -

Returns:

true on success

Throws:

MetaException

org.apache.thrift.TException

getDelegationToken

java.lang.String getDelegationToken(java.lang.String owner,
                                    java.lang.String renewerKerberosPrincipalName)
                             throws MetaException,
                                    org.apache.thrift.TException

Parameters:

owner - the intended owner for the token

renewerKerberosPrincipalName -

Returns:

the string of the token

Throws:

MetaException

org.apache.thrift.TException

renewDelegationToken

long renewDelegationToken(java.lang.String tokenStrForm)
                   throws MetaException,
                          org.apache.thrift.TException

Parameters:

tokenStrForm -

Returns:

the new expiration time

Throws:

MetaException

org.apache.thrift.TException

cancelDelegationToken

void cancelDelegationToken(java.lang.String tokenStrForm)
                    throws MetaException,
                           org.apache.thrift.TException

Parameters:

tokenStrForm -

Throws:

MetaException

org.apache.thrift.TException