IMetaStoreClient (Hive Standalone Metastore Common Code 4.0.0 API)

All Superinterfaces:

AutoCloseable

All Known Implementing Classes:

HiveMetaStoreClient
```
@InterfaceAudience.Public
 @InterfaceStability.Evolving
public interface IMetaStoreClient
extends AutoCloseable
```
Wrapper around hive metastore thrift api

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static class`	`IMetaStoreClient.IncompatibleMetastoreException`
`static interface`	`IMetaStoreClient.NotificationFilter` A filter provided by the client that determines if a given notification event should be returned.

Method Summary

All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods
Modifier and Type	Method and Description
`AbortCompactResponse`	`abortCompactions(AbortCompactionRequest request)`
`void`	`abortTxns(AbortTxnsRequest abortTxnsRequest)` Abort a list of transactions with additional information of errorcodes as defined in TxnErrorMsg.java.
`void`	`abortTxns(List<Long> txnids)` Abort a list of transactions.
`Partition`	`add_partition(Partition partition)` Add a partition to the table.
`int`	`add_partitions_pspec(PartitionSpecProxy partitionSpec)` Add a partitions using a spec proxy.
`int`	`add_partitions(List<Partition> partitions)` Add partitions to the table.
`List<Partition>`	`add_partitions(List<Partition> partitions, boolean ifNotExists, boolean needResults)` Add partitions to the table.
`void`	`addCheckConstraint(List<SQLCheckConstraint> checkConstraints)`
`void`	`addDefaultConstraint(List<SQLDefaultConstraint> defaultConstraints)`
`void`	`addDynamicPartitions(long txnId, long writeId, String dbName, String tableName, List<String> partNames)` Deprecated. in Hive 1.3.0/2.1.0 - will be removed in 2 releases
`void`	`addDynamicPartitions(long txnId, long writeId, String dbName, String tableName, List<String> partNames, DataOperationType operationType)` Send a list of partitions to the metastore to indicate which partitions were loaded dynamically.
`void`	`addForeignKey(List<SQLForeignKey> foreignKeyCols)` Add a foreign key
`int`	`addMasterKey(String key)`
`void`	`addNotNullConstraint(List<SQLNotNullConstraint> notNullConstraintCols)` Add a not null constraint
`void`	`addPackage(AddPackageRequest request)`
`void`	`addPrimaryKey(List<SQLPrimaryKey> primaryKeyCols)` Add a primary key.
`void`	`addReplicationMetrics(ReplicationMetricList replicationMetricList)` Adds replication metrics for the replication policies.
`void`	`addRuntimeStat(RuntimeStat stat)` Adds a RuntimeStat for metastore persistence.
`void`	`addSchemaVersion(SchemaVersion schemaVersion)` Add a new version to an existing schema.
`void`	`addSerDe(SerDeInfo serDeInfo)` Add a serde.
`boolean`	`addToken(String tokenIdentifier, String delegationToken)`
`void`	`addUniqueConstraint(List<SQLUniqueConstraint> uniqueConstraintCols)` Add a unique constraint
`void`	`addWriteIdsToMinHistory(long txnId, Map<String,Long> writeIds)` Persists minOpenWriteId list to identify obsolete directories eligible for cleanup
`void`	`addWriteNotificationLog(WriteNotificationLogRequest rqst)` Add a event related to write operations in an ACID table.
`void`	`addWriteNotificationLogInBatch(WriteNotificationLogBatchRequest rqst)` Add a batch of event related to write operations in an ACID table.
`long`	`allocateTableWriteId(long txnId, String dbName, String tableName)` Allocate a per table write ID and associate it with the given transaction.
`long`	`allocateTableWriteId(long txnId, String dbName, String tableName, boolean reallocate)` Allocate a per table write ID and associate it with the given transaction.
`List<TxnToWriteId>`	`allocateTableWriteIdsBatch(List<Long> txnIds, String dbName, String tableName)` Allocate a per table write ID and associate it with the given transaction.
`void`	`alter_partition(String dbName, String tblName, Partition newPart)` updates a partition to new partition
`void`	`alter_partition(String dbName, String tblName, Partition newPart, EnvironmentContext environmentContext)` Deprecated.
`default void`	`alter_partition(String catName, String dbName, String tblName, Partition newPart)` Deprecated.
`void`	`alter_partition(String catName, String dbName, String tblName, Partition newPart, EnvironmentContext environmentContext)` updates a partition to new partition
`void`	`alter_partition(String catName, String dbName, String tblName, Partition newPart, EnvironmentContext environmentContext, String writeIdList)`
`void`	`alter_partitions(String dbName, String tblName, List<Partition> newParts)` Deprecated.
`void`	`alter_partitions(String dbName, String tblName, List<Partition> newParts, EnvironmentContext environmentContext)` Deprecated.
`void`	`alter_partitions(String dbName, String tblName, List<Partition> newParts, EnvironmentContext environmentContext, String writeIdList, long writeId)`
`default void`	`alter_partitions(String catName, String dbName, String tblName, List<Partition> newParts)` Deprecated.
`void`	`alter_partitions(String catName, String dbName, String tblName, List<Partition> newParts, EnvironmentContext environmentContext, String writeIdList, long writeId)` updates a list of partitions
`void`	`alter_table_with_environmentContext(String databaseName, String tblName, Table table, EnvironmentContext environmentContext)` Deprecated.
`default void`	`alter_table(String catName, String dbName, String tblName, Table newTable)` Alter a table.
`void`	`alter_table(String catName, String dbName, String tblName, Table newTable, EnvironmentContext envContext)` Alter a table.
`void`	`alter_table(String catName, String databaseName, String tblName, Table table, EnvironmentContext environmentContext, String validWriteIdList)`
`void`	`alter_table(String databaseName, String tblName, Table table)` Alter a table
`void`	`alter_table(String defaultDatabaseName, String tblName, Table table, boolean cascade)` Deprecated. Use alter_table_with_environmentContext instead of alter_table with cascade option passed in EnvironmentContext using `StatsSetupConst.CASCADE`
`void`	`alterCatalog(String catalogName, Catalog newCatalog)` Alter an existing catalog.
`void`	`alterDatabase(String name, Database db)` Alter a database.
`void`	`alterDatabase(String catName, String dbName, Database newDb)` Alter a database.
`void`	`alterDataConnector(String name, DataConnector connector)` Alter a dataconnector.
`void`	`alterFunction(String dbName, String funcName, Function newFunction)` Alter a function.
`void`	`alterFunction(String catName, String dbName, String funcName, Function newFunction)` Alter a function.
`void`	`alterISchema(String catName, String dbName, String schemaName, ISchema newSchema)` Alter an existing schema.
`WMFullResourcePlan`	`alterResourcePlan(String resourcePlanName, String ns, WMNullableResourcePlan resourcePlan, boolean canActivateDisabled, boolean isForceDeactivate, boolean isReplace)`
`void`	`alterWMPool(WMNullablePool pool, String poolPath)`
`void`	`alterWMTrigger(WMTrigger trigger)`
`Partition`	`appendPartition(String dbName, String tableName, List<String> partVals)` /** Add a partition to a table and get back the resulting Partition object.
`Partition`	`appendPartition(String dbName, String tableName, String name)` Add a partition to a table and get back the resulting Partition object.
`Partition`	`appendPartition(String catName, String dbName, String tableName, List<String> partVals)` Add a partition to a table and get back the resulting Partition object.
`Partition`	`appendPartition(String catName, String dbName, String tableName, String name)` Add a partition to a table and get back the resulting Partition object.
`boolean`	`cacheFileMetadata(String dbName, String tableName, String partName, boolean allParts)`
`void`	`cancelDelegationToken(String tokenStrForm)`
`LockResponse`	`checkLock(long lockid)` Check the status of a set of locks requested via a `lock(org.apache.hadoop.hive.metastore.api.LockRequest)` call.
`void`	`clearFileMetadata(List<Long> fileIds)` Cleares the file metadata cache for respective file IDs.
`void`	`close()` close connection to meta store
`void`	`commitTxn(CommitTxnRequest rqst)` Commit a transaction.
`void`	`commitTxn(long txnid)` Commit a transaction.
`void`	`commitTxnWithKeyValue(long txnid, long tableId, String key, String value)` Like commitTxn but it will atomically store as well a key and a value.
`void`	`compact(String dbname, String tableName, String partitionName, CompactionType type)` Deprecated. use `compact2(CompactionRequest)`
`void`	`compact(String dbname, String tableName, String partitionName, CompactionType type, Map<String,String> tblproperties)` Deprecated. use `compact2(CompactionRequest)`
`CompactionResponse`	`compact2(CompactionRequest request)` Send a request to compact a table or partition.
`CompactionResponse`	`compact2(String dbname, String tableName, String partitionName, CompactionType type, Map<String,String> tblproperties)` Deprecated. use `compact2(CompactionRequest)`
`boolean`	`create_role(Role role)`
`void`	`createCatalog(Catalog catalog)` Create a new catalog.
`void`	`createDatabase(Database db)` Create a new database.
`void`	`createDataConnector(DataConnector connector)` Create a new dataconnector.
`void`	`createFunction(Function func)` Create a new function.
`void`	`createISchema(ISchema schema)` Create a new schema.
`void`	`createOrDropTriggerToPoolMapping(String resourcePlanName, String triggerName, String poolPath, boolean shouldDrop, String ns)`
`void`	`createOrUpdateWMMapping(WMMapping mapping, boolean isUpdate)`
`void`	`createResourcePlan(WMResourcePlan resourcePlan, String copyFromName)`
`void`	`createStoredProcedure(StoredProcedure proc)`
`void`	`createTable(CreateTableRequest request)`
`void`	`createTable(Table tbl)`
`void`	`createTableWithConstraints(Table tTbl, List<SQLPrimaryKey> primaryKeys, List<SQLForeignKey> foreignKeys, List<SQLUniqueConstraint> uniqueConstraints, List<SQLNotNullConstraint> notNullConstraints, List<SQLDefaultConstraint> defaultConstraints, List<SQLCheckConstraint> checkConstraints)`
`void`	`createWMPool(WMPool pool)`
`void`	`createWMTrigger(WMTrigger trigger)`
`boolean`	`deletePartitionColumnStatistics(String dbName, String tableName, String partName, String colName, String engine)` Delete partition level column statistics given dbName, tableName, partName and colName, or all columns in a partition.
`boolean`	`deletePartitionColumnStatistics(String catName, String dbName, String tableName, String partName, String colName, String engine)` Delete partition level column statistics given dbName, tableName, partName and colName, or all columns in a partition.
`boolean`	`deleteTableColumnStatistics(String dbName, String tableName, String colName, String engine)` Delete table level column statistics given dbName, tableName and colName, or all columns in a table.
`boolean`	`deleteTableColumnStatistics(String catName, String dbName, String tableName, String colName, String engine)` Delete table level column statistics given dbName, tableName and colName, or all columns in a table.
`boolean`	`drop_role(String role_name)`
`void`	`dropCatalog(String catName)` Drop a catalog.
`void`	`dropConstraint(String dbName, String tableName, String constraintName)` Drop a constraint.
`void`	`dropConstraint(String catName, String dbName, String tableName, String constraintName)` Drop a constraint.
`void`	`dropDatabase(DropDatabaseRequest req)`
`void`	`dropDatabase(String name)` Drop a database.
`void`	`dropDatabase(String name, boolean deleteData, boolean ignoreUnknownDb)` Drop a database.
`void`	`dropDatabase(String name, boolean deleteData, boolean ignoreUnknownDb, boolean cascade)` Drop a database.
`default void`	`dropDatabase(String catName, String dbName)` Drop a database.
`default void`	`dropDatabase(String catName, String dbName, boolean deleteData, boolean ignoreUnknownDb)` Deprecated.
`default void`	`dropDatabase(String catName, String dbName, boolean deleteData, boolean ignoreUnknownDb, boolean cascade)` Deprecated.
`void`	`dropDataConnector(String name, boolean ifNotExists, boolean checkReferences)` Drop a dataconnector.
`void`	`dropFunction(String dbName, String funcName)` Drop a function.
`void`	`dropFunction(String catName, String dbName, String funcName)` Drop a function.
`void`	`dropISchema(String catName, String dbName, String name)` Drop an existing schema.
`void`	`dropPackage(DropPackageRequest request)`
`boolean`	`dropPartition(String db_name, String tbl_name, List<String> part_vals, boolean deleteData)` Drop a partition.
`boolean`	`dropPartition(String db_name, String tbl_name, List<String> part_vals, PartitionDropOptions options)` Drop a partition with the option to purge the partition data directly, rather than to move data to trash.
`boolean`	`dropPartition(String db_name, String tbl_name, String name, boolean deleteData)` Drop a partition.
`boolean`	`dropPartition(String catName, String db_name, String tbl_name, List<String> part_vals, boolean deleteData)` Drop a partition.
`boolean`	`dropPartition(String catName, String db_name, String tbl_name, List<String> part_vals, PartitionDropOptions options)` Drop a partition with the option to purge the partition data directly, rather than to move data to trash.
`boolean`	`dropPartition(String catName, String db_name, String tbl_name, String name, boolean deleteData)` Drop a partition.
`List<Partition>`	`dropPartitions(String dbName, String tblName, List<org.apache.commons.lang3.tuple.Pair<Integer,byte[]>> partExprs, boolean deleteData, boolean ifExists)` Drop partitions based on an expression.
`List<Partition>`	`dropPartitions(String dbName, String tblName, List<org.apache.commons.lang3.tuple.Pair<Integer,byte[]>> partExprs, boolean deleteData, boolean ifExists, boolean needResults)` Deprecated. Use `dropPartitions(String, String, String, List, boolean, boolean, boolean)`
`List<Partition>`	`dropPartitions(String dbName, String tblName, List<org.apache.commons.lang3.tuple.Pair<Integer,byte[]>> partExprs, PartitionDropOptions options)` Generalization of dropPartitions(),
`default List<Partition>`	`dropPartitions(String catName, String dbName, String tblName, List<org.apache.commons.lang3.tuple.Pair<Integer,byte[]>> partExprs, boolean deleteData, boolean ifExists)` Drop partitions based on an expression.
`default List<Partition>`	`dropPartitions(String catName, String dbName, String tblName, List<org.apache.commons.lang3.tuple.Pair<Integer,byte[]>> partExprs, boolean deleteData, boolean ifExists, boolean needResults)` Drop partitions based on an expression.
`List<Partition>`	`dropPartitions(String catName, String dbName, String tblName, List<org.apache.commons.lang3.tuple.Pair<Integer,byte[]>> partExprs, PartitionDropOptions options)` Generalization of dropPartitions(),
`void`	`dropResourcePlan(String resourcePlanName, String ns)`
`void`	`dropSchemaVersion(String catName, String dbName, String schemaName, int version)` Drop a version of a schema.
`void`	`dropStoredProcedure(StoredProcedureRequest request)`
`void`	`dropTable(String dbname, String tableName)` Drop the table.
`void`	`dropTable(String dbname, String tableName, boolean deleteData, boolean ignoreUnknownTab)` Drop the table.
`void`	`dropTable(String dbname, String tableName, boolean deleteData, boolean ignoreUnknownTab, boolean ifPurge)` Deprecated.
`default void`	`dropTable(String catName, String dbName, String tableName)` Drop a table.
`default void`	`dropTable(String catName, String dbName, String tableName, boolean deleteData, boolean ignoreUnknownTable)` Drop a table.
`void`	`dropTable(String catName, String dbName, String tableName, boolean deleteData, boolean ignoreUnknownTable, boolean ifPurge)` Drop a table.
`void`	`dropTable(Table table, boolean deleteData, boolean ignoreUnknownTab, boolean ifPurge)`
`void`	`dropWMMapping(WMMapping mapping)`
`void`	`dropWMPool(String resourcePlanName, String poolPath, String ns)`
`void`	`dropWMTrigger(String resourcePlanName, String triggerName, String ns)`
`Partition`	`exchange_partition(Map<String,String> partitionSpecs, String sourceDb, String sourceTable, String destdb, String destTableName)` Move a partition from one table to another
`Partition`	`exchange_partition(Map<String,String> partitionSpecs, String sourceCat, String sourceDb, String sourceTable, String destCat, String destdb, String destTableName)` Move a partition from one table to another
`List<Partition>`	`exchange_partitions(Map<String,String> partitionSpecs, String sourceDb, String sourceTable, String destdb, String destTableName)` With the one partitionSpecs to exchange, multiple partitions could be exchanged.
`List<Partition>`	`exchange_partitions(Map<String,String> partitionSpecs, String sourceCat, String sourceDb, String sourceTable, String destCat, String destdb, String destTableName)` With the one partitionSpecs to exchange, multiple partitions could be exchanged.
`List<String>`	`findColumnsWithStats(CompactionInfoStruct cr)` Get columns.
`OptionalCompactionInfoStruct`	`findNextCompact(FindNextCompactRequest rqst)` Get the next compaction job to do.
`OptionalCompactionInfoStruct`	`findNextCompact(String workerId)` Deprecated. Use `findNextCompact(org.apache.hadoop.hive.metastore.api.FindNextCompactRequest)` instead
`Package`	`findPackage(GetPackageRequest request)`
`FireEventResponse`	`fireListenerEvent(FireEventRequest request)` Request that the metastore fire an event.
`void`	`flushCache()` Flush any catalog objects held by the metastore implementation.
`GetPrincipalsInRoleResponse`	`get_principals_in_role(GetPrincipalsInRoleRequest getPrincRoleReq)` get all role-grants for users/roles that have been granted the given role Note that in the returned list of RolePrincipalGrants, the roleName is redundant as it would match the role_name argument of this function
`PrincipalPrivilegeSet`	`get_privilege_set(HiveObjectRef hiveObject, String user_name, List<String> group_names)` Return the privileges that the user, group have directly and indirectly through roles on the given hiveObject
`GetRoleGrantsForPrincipalResponse`	`get_role_grants_for_principal(GetRoleGrantsForPrincipalRequest getRolePrincReq)` get all role-grants for roles that have been granted to given principal Note that in the returned list of RolePrincipalGrants, the principal information redundant as it would match the principal information in request
`WMFullResourcePlan`	`getActiveResourcePlan(String ns)`
`AggrStats`	`getAggrColStatsFor(String dbName, String tblName, List<String> colNames, List<String> partName, String engine)` Get aggregated column stats for a set of partitions.
`AggrStats`	`getAggrColStatsFor(String dbName, String tblName, List<String> colNames, List<String> partName, String engine, String writeIdList)`
`AggrStats`	`getAggrColStatsFor(String catName, String dbName, String tblName, List<String> colNames, List<String> partNames, String engine)` Get aggregated column stats for a set of partitions.
`AggrStats`	`getAggrColStatsFor(String catName, String dbName, String tblName, List<String> colNames, List<String> partNames, String engine, String writeIdList)`
`List<String>`	`getAllDatabases()` Get the names of all databases in the MetaStore.
`List<String>`	`getAllDatabases(String catName)` Get all databases in a catalog.
`List<String>`	`getAllDataConnectorNames()` Get the names of all dataconnectors in the MetaStore.
`GetAllFunctionsResponse`	`getAllFunctions()` Get all functions in the default catalog.
`List<Table>`	`getAllMaterializedViewObjectsForRewriting()` Retrieve all materialized views that have rewriting enabled.
`List<WMResourcePlan>`	`getAllResourcePlans(String ns)`
`List<String>`	`getAllStoredProcedures(ListStoredProcedureRequest request)`
`SQLAllTableConstraints`	`getAllTableConstraints(AllTableConstraintsRequest request)` Get all constraints of given table
`List<String>`	`getAllTables(String dbName)` Get the names of all tables in the specified database.
`List<String>`	`getAllTables(String catName, String dbName)` Get the names of all tables in the specified database.
`List<String>`	`getAllTokenIdentifiers()`
`List<WriteEventInfo>`	`getAllWriteEventInfo(GetAllWriteEventInfoRequest request)` Get acid write events of a specific transaction.
`Catalog`	`getCatalog(String catName)` Get a catalog object.
`List<String>`	`getCatalogs()` Get a list of all catalogs known to the system.
`List<SQLCheckConstraint>`	`getCheckConstraints(CheckConstraintsRequest request)`
`String`	`getConfigValue(String name, String defaultValue)`
`CurrentNotificationEventId`	`getCurrentNotificationEventId()` Get the last used notification event id.
`Database`	`getDatabase(String databaseName)` Get a Database Object in the default catalog
`Database`	`getDatabase(String catalogName, String databaseName)` Get a database.
`List<String>`	`getDatabases(String databasePattern)` Get the names of all databases in the default catalog that match the given pattern.
`List<String>`	`getDatabases(String catName, String databasePattern)` Get all databases in a catalog whose names match a pattern.
`DataConnector`	`getDataConnector(String name)` Get the dataconnector by name
`List<SQLDefaultConstraint>`	`getDefaultConstraints(DefaultConstraintsRequest request)`
`String`	`getDelegationToken(String owner, String renewerKerberosPrincipalName)` This is expected to be a no-op when in local mode, which means that the implementation will return null.
`List<FieldSchema>`	`getFields(String db, String tableName)` Get schema for a table, excluding the partition columns.
`List<FieldSchema>`	`getFields(String catName, String db, String tableName)` Get schema for a table, excluding the partition columns.
`GetFieldsResponse`	`getFieldsRequest(GetFieldsRequest req)` Get schema for a table, excluding the partition columns.
`Iterable<Map.Entry<Long,ByteBuffer>>`	`getFileMetadata(List<Long> fileIds)` Gets file metadata, as cached by metastore, for respective file IDs.
`Iterable<Map.Entry<Long,MetadataPpdResult>>`	`getFileMetadataBySarg(List<Long> fileIds, ByteBuffer sarg, boolean doGetFooters)`
`List<SQLForeignKey>`	`getForeignKeys(ForeignKeysRequest request)` Get a foreign key for a table.
`Function`	`getFunction(String dbName, String funcName)` Get a function.
`Function`	`getFunction(String catName, String dbName, String funcName)` Get a function.
`List<String>`	`getFunctions(String dbName, String pattern)` Get all functions matching a pattern
`List<String>`	`getFunctions(String catName, String dbName, String pattern)` Get all functions matching a pattern
`ISchema`	`getISchema(String catName, String dbName, String name)` Fetch a schema.
`GetLatestCommittedCompactionInfoResponse`	`getLatestCommittedCompactionInfo(GetLatestCommittedCompactionInfoRequest request)` Get one latest record of SUCCEEDED or READY_FOR_CLEANING compaction for a table/partition.
`long`	`getLatestTxnIdInConflict(long txnId)` Checks if there is a conflicting transaction
`String[]`	`getMasterKeys()`
`Materialization`	`getMaterializationInvalidationInfo(CreationMetadata cm, String validTxnList)` Returns the invalidation information for the materialized views given as input.
`List<String>`	`getMaterializedViewsForRewriting(String dbName)` Get materialized views that have rewriting enabled.
`List<String>`	`getMaterializedViewsForRewriting(String catName, String dbName)` Get materialized views that have rewriting enabled.
`long`	`getMaxAllocatedWriteId(String dbName, String tableName)` Get the maximum allocated writeId for the given table
`String`	`getMetaConf(String key)` get current meta variable
`String`	`getMetastoreDbUuid()` Gets the unique id of the backing database instance used for storing metadata
`NotificationEventResponse`	`getNextNotification(long lastEventId, int maxEvents, IMetaStoreClient.NotificationFilter filter)` Get the next set of notifications from the database.
`NotificationEventResponse`	`getNextNotification(NotificationEventRequest request, boolean allowGapsInEventIds, IMetaStoreClient.NotificationFilter filter)` Get the next set of notifications from the database.
`NotificationEventsCountResponse`	`getNotificationEventsCount(NotificationEventsCountRequest rqst)` Get the number of events from given eventID for the input database.
`List<SQLNotNullConstraint>`	`getNotNullConstraints(NotNullConstraintsRequest request)` Get a not null constraint for a table.
`int`	`getNumPartitionsByFilter(String dbName, String tableName, String filter)` Get number of partitions matching specified filter
`int`	`getNumPartitionsByFilter(String catName, String dbName, String tableName, String filter)` Get number of partitions matching specified filter
`GetOpenTxnsResponse`	`getOpenTxns()`
`Partition`	`getPartition(String dbName, String tblName, List<String> partVals)` Get a partition.
`Partition`	`getPartition(String dbName, String tblName, String name)` Get a Partition by name.
`Partition`	`getPartition(String catName, String dbName, String tblName, List<String> partVals)` Get a partition.
`Partition`	`getPartition(String catName, String dbName, String tblName, String name)` Get a Partition by name.
`Map<String,List<ColumnStatisticsObj>>`	`getPartitionColumnStatistics(String dbName, String tableName, List<String> partNames, List<String> colNames, String engine)` Get the column statistics for a set of columns in a partition.
`Map<String,List<ColumnStatisticsObj>>`	`getPartitionColumnStatistics(String dbName, String tableName, List<String> partNames, List<String> colNames, String engine, String validWriteIdList)`
`Map<String,List<ColumnStatisticsObj>>`	`getPartitionColumnStatistics(String catName, String dbName, String tableName, List<String> partNames, List<String> colNames, String engine)` Get the column statistics for a set of columns in a partition.
`Map<String,List<ColumnStatisticsObj>>`	`getPartitionColumnStatistics(String catName, String dbName, String tableName, List<String> partNames, List<String> colNames, String engine, String validWriteIdList)`
`GetPartitionResponse`	`getPartitionRequest(GetPartitionRequest req)` Get a partition.
`GetPartitionsByNamesResult`	`getPartitionsByNames(GetPartitionsByNamesRequest req)` Get partitions by a list of partition names.
`List<Partition>`	`getPartitionsByNames(String db_name, String tbl_name, List<String> part_names)` Deprecated. Use `getPartitionsByNames(GetPartitionsByNamesRequest)` instead
`List<Partition>`	`getPartitionsByNames(String catName, String db_name, String tbl_name, List<String> part_names)` Deprecated. Use `getPartitionsByNames(GetPartitionsByNamesRequest)` instead
`PartitionsResponse`	`getPartitionsRequest(PartitionsRequest req)` Get partitions by a list of partition names.
`GetPartitionsResponse`	`getPartitionsWithSpecs(GetPartitionsRequest request)` Generic Partition request API, providing different ways of filtering and controlling output.
`Partition`	`getPartitionWithAuthInfo(String dbName, String tableName, List<String> pvals, String userName, List<String> groupNames)` Get a Partition along with authorization information.
`Partition`	`getPartitionWithAuthInfo(String catName, String dbName, String tableName, List<String> pvals, String userName, List<String> groupNames)` Get a Partition along with authorization information.
`List<SQLPrimaryKey>`	`getPrimaryKeys(PrimaryKeysRequest request)` Get a primary key for a table.
`default Map<String,Map<String,String>>`	`getProperties(String nameSpace, String mapPrefix, String mapPredicate, String... selection)` Gets properties.
`ReplicationMetricList`	`getReplicationMetrics(GetReplicationMetricsRequest replicationMetricsRequest)`
`WMFullResourcePlan`	`getResourcePlan(String resourcePlanName, String ns)`
`List<RuntimeStat>`	`getRuntimeStats(int maxWeight, int maxCreateTime)` Reads runtime statistics.
`ScheduledQuery`	`getScheduledQuery(ScheduledQueryKey scheduleKey)` Returns details about a scheduled query by name.
`List<FieldSchema>`	`getSchema(String db, String tableName)` Get schema for a table, including the partition columns.
`List<FieldSchema>`	`getSchema(String catName, String db, String tableName)` Get schema for a table, including the partition columns.
`List<SchemaVersion>`	`getSchemaAllVersions(String catName, String dbName, String schemaName)` Get all the extant versions of a schema.
`FindSchemasByColsResp`	`getSchemaByCols(FindSchemasByColsRqst rqst)` Find all schema versions that have columns that match a query.
`SchemaVersion`	`getSchemaLatestVersion(String catName, String dbName, String schemaName)` Get the latest version of a schema.
`GetSchemaResponse`	`getSchemaRequest(GetSchemaRequest req)` Get schema for a table, including the partition columns.
`SchemaVersion`	`getSchemaVersion(String catName, String dbName, String schemaName, int version)` Get a specific version of a schema.
`SerDeInfo`	`getSerDe(String serDeName)` Fetch a serde.
`String`	`getServerVersion()` Gets the version string of the metastore server which this client is connected to
`StoredProcedure`	`getStoredProcedure(StoredProcedureRequest request)`
`Table`	`getTable(GetTableRequest getTableRequest)`
`Table`	`getTable(String dbName, String tableName)` Deprecated. use getTable(GetTableRequest getTableRequest)
`Table`	`getTable(String dbName, String tableName, boolean getColumnStats, String engine)` Deprecated. use getTable(GetTableRequest getTableRequest)
`Table`	`getTable(String catName, String dbName, String tableName)` Deprecated. use getTable(GetTableRequest getTableRequest)
`Table`	`getTable(String catName, String dbName, String tableName, String validWriteIdList)` Deprecated. use getTable(GetTableRequest getTableRequest)
`Table`	`getTable(String catName, String dbName, String tableName, String validWriteIdList, boolean getColumnStats, String engine)` Deprecated. use getTable(GetTableRequest getTableRequest)
`List<ColumnStatisticsObj>`	`getTableColumnStatistics(String dbName, String tableName, List<String> colNames, String engine)` Get the column statistics for a set of columns in a table.
`List<ColumnStatisticsObj>`	`getTableColumnStatistics(String dbName, String tableName, List<String> colNames, String engine, String validWriteIdList)`
`List<ColumnStatisticsObj>`	`getTableColumnStatistics(String catName, String dbName, String tableName, List<String> colNames, String engine)` Get the column statistics for a set of columns in a table.
`List<ColumnStatisticsObj>`	`getTableColumnStatistics(String catName, String dbName, String tableName, List<String> colNames, String engine, String validWriteIdList)`
`List<TableMeta>`	`getTableMeta(String dbPatterns, String tablePatterns, List<String> tableTypes)` Fetches just table name and comments.
`List<TableMeta>`	`getTableMeta(String catName, String dbPatterns, String tablePatterns, List<String> tableTypes)` Fetches just table name and comments.
`List<Table>`	`getTableObjectsByName(String dbName, List<String> tableNames)` Get tables as objects (rather than just fetching their names).
`List<Table>`	`getTableObjectsByName(String catName, String dbName, List<String> tableNames)` Get tables as objects (rather than just fetching their names).
`List<String>`	`getTables(String dbName, String tablePattern)` Get the names of all tables in the specified database that satisfy the supplied table name pattern.
`List<Table>`	`getTables(String catName, String dbName, List<String> tableNames, GetProjectionsSpec projectionsSpec)` Get tables as objects (rather than just fetching their names).
`List<String>`	`getTables(String catName, String dbName, String tablePattern)` Get the names of all tables in the specified database that satisfy the supplied table name pattern.
`List<String>`	`getTables(String catName, String dbName, String tablePattern, TableType tableType)` Get the names of all tables in the specified database that satisfy the supplied table name pattern and table type (MANAGED_TABLE \|\| EXTERNAL_TABLE \|\| VIRTUAL_VIEW)
`List<String>`	`getTables(String dbName, String tablePattern, TableType tableType)` Get the names of all tables in the specified database that satisfy the supplied table name pattern and table type (MANAGED_TABLE \|\| EXTERNAL_TABLE \|\| VIRTUAL_VIEW)
`List<ExtendedTableInfo>`	`getTablesExt(String catName, String dbName, String tablePattern, int requestedFields, int limit)` Get the names of all the tables along with extended table metadata
`String`	`getToken(String tokenIdentifier)`
`String`	`getTokenStrForm()`
`Table`	`getTranslateTableDryrun(Table tbl)` Dry run that translates table * * @param tbl * a table object * @throws HiveException
`List<WMTrigger>`	`getTriggersForResourcePlan(String resourcePlan, String ns)`
`List<SQLUniqueConstraint>`	`getUniqueConstraints(UniqueConstraintsRequest request)` Get a unique constraint for a table.
`ValidTxnList`	`getValidTxns()` Get a structure that details valid transactions.
`ValidTxnList`	`getValidTxns(long currentTxn)` Get a structure that details valid transactions.
`ValidTxnList`	`getValidTxns(long currentTxn, List<TxnType> excludeTxnTypes)` Get a structure that details valid transactions.
`List<TableValidWriteIds>`	`getValidWriteIds(List<String> tablesList, String validTxnList)` Get a structure that details valid write ids list for all tables read by current txn.
`ValidWriteIdList`	`getValidWriteIds(String fullTableName)` Get a structure that details valid write ids.
`ValidWriteIdList`	`getValidWriteIds(String fullTableName, Long writeId)` Get a structure that details valid write ids.
`boolean`	`grant_privileges(PrivilegeBag privileges)`
`boolean`	`grant_role(String role_name, String user_name, PrincipalType principalType, String grantor, PrincipalType grantorType, boolean grantOption)`
`void`	`heartbeat(long txnid, long lockid)` Send a heartbeat to indicate that the client holding these locks (if any) and that opened this transaction (if one exists) is still alive.
`boolean`	`heartbeatLockMaterializationRebuild(String dbName, String tableName, long txnId)` Method to refresh the acquisition of a given materialization rebuild lock.
`HeartbeatTxnRangeResponse`	`heartbeatTxnRange(long min, long max)` Send heartbeats for a range of transactions.
`void`	`insertTable(Table table, boolean overwrite)` Performs the commit/rollback to the metadata storage for insert operator from external storage handler.
`boolean`	`isCompatibleWith(org.apache.hadoop.conf.Configuration conf)` Returns whether current client is compatible with conf argument or not
`boolean`	`isLocalMetaStore()` Returns true if the current client is using an in process metastore (local metastore).
`boolean`	`isPartitionMarkedForEvent(String db_name, String tbl_name, Map<String,String> partKVs, PartitionEventType eventType)` Determine whether a partition has been marked with a particular event type.
`boolean`	`isPartitionMarkedForEvent(String catName, String db_name, String tbl_name, Map<String,String> partKVs, PartitionEventType eventType)` Determine whether a partition has been marked with a particular event type.
`boolean`	`isSameConfObj(org.apache.hadoop.conf.Configuration c)`
`List<HiveObjectPrivilege>`	`list_privileges(String principal_name, PrincipalType principal_type, HiveObjectRef hiveObject)` Return the privileges that this principal has directly over the object (not through roles).
`List<Role>`	`list_roles(String principalName, PrincipalType principalType)`
`List<String>`	`listPackages(ListPackageRequest request)`
`List<String>`	`listPartitionNames(PartitionsByExprRequest request)` Get a list of partition names matching the specified filter and return in order if specified.
`List<String>`	`listPartitionNames(String db_name, String tbl_name, List<String> part_vals, short max_parts)` Get a list of partition names matching a partial specification of the partition values.
`List<String>`	`listPartitionNames(String db_name, String tbl_name, short max_parts)` List Names of partitions in a table.
`List<String>`	`listPartitionNames(String catName, String db_name, String tbl_name, int max_parts)` List Names of partitions in a table.
`List<String>`	`listPartitionNames(String catName, String db_name, String tbl_name, List<String> part_vals, int max_parts)` Get a list of partition names matching a partial specification of the partition values.
`GetPartitionNamesPsResponse`	`listPartitionNamesRequest(GetPartitionNamesPsRequest req)` List Names of partitions in a table.
`List<Partition>`	`listPartitions(String db_name, String tbl_name, List<String> part_vals, short max_parts)` Get a list of partitions based on a (possibly partial) list of partition values.
`List<Partition>`	`listPartitions(String db_name, String tbl_name, short max_parts)` Get a list of partittions for a table.
`List<Partition>`	`listPartitions(String catName, String db_name, String tbl_name, int max_parts)` Get a list of partittions for a table.
`List<Partition>`	`listPartitions(String catName, String db_name, String tbl_name, List<String> part_vals, int max_parts)` Get a list of partitions based on a (possibly partial) list of partition values.
`boolean`	`listPartitionsByExpr(String db_name, String tbl_name, byte[] expr, String default_partition_name, short max_parts, List<Partition> result)` Get list of partitions matching specified serialized expression
`boolean`	`listPartitionsByExpr(String catName, String db_name, String tbl_name, byte[] expr, String default_partition_name, int max_parts, List<Partition> result)` Get list of partitions matching specified serialized expression
`List<Partition>`	`listPartitionsByFilter(String db_name, String tbl_name, String filter, short max_parts)` Get list of partitions matching specified filter
`List<Partition>`	`listPartitionsByFilter(String catName, String db_name, String tbl_name, String filter, int max_parts)` Get list of partitions matching specified filter
`PartitionSpecProxy`	`listPartitionSpecs(String dbName, String tableName, int maxParts)` Get a list of partitions from a table, returned in the form of PartitionSpecProxy
`PartitionSpecProxy`	`listPartitionSpecs(String catName, String dbName, String tableName, int maxParts)` Get a list of partitions from a table, returned in the form of PartitionSpecProxy
`PartitionSpecProxy`	`listPartitionSpecsByFilter(String db_name, String tbl_name, String filter, int max_parts)` Get a list of partitions in a PartitionSpec, using a filter to select which partitions to fetch.
`PartitionSpecProxy`	`listPartitionSpecsByFilter(String catName, String db_name, String tbl_name, String filter, int max_parts)` Get a list of partitions in a PartitionSpec, using a filter to select which partitions to fetch.
`boolean`	`listPartitionsSpecByExpr(PartitionsByExprRequest req, List<PartitionSpec> result)` Get list of `PartitionSpec` matching specified serialized expression.
`List<Partition>`	`listPartitionsWithAuthInfo(String dbName, String tableName, List<String> partialPvals, short maxParts, String userName, List<String> groupNames)` List partitions along with privilege information for a user or groups
`List<Partition>`	`listPartitionsWithAuthInfo(String dbName, String tableName, short maxParts, String userName, List<String> groupNames)` List partitions, fetching the authorization information along with the partitions.
`List<Partition>`	`listPartitionsWithAuthInfo(String catName, String dbName, String tableName, int maxParts, String userName, List<String> groupNames)` List partitions, fetching the authorization information along with the partitions.
`List<Partition>`	`listPartitionsWithAuthInfo(String catName, String dbName, String tableName, List<String> partialPvals, int maxParts, String userName, List<String> groupNames)` List partitions along with privilege information for a user or groups
`GetPartitionsPsWithAuthResponse`	`listPartitionsWithAuthInfoRequest(GetPartitionsPsWithAuthRequest req)` List partitions, fetching the authorization information along with the partitions.
`PartitionValuesResponse`	`listPartitionValues(PartitionValuesRequest request)` Get a list of partition values
`List<String>`	`listRoleNames()` list all role names
`List<String>`	`listTableNamesByFilter(String dbName, String filter, short maxTables)` Get a list of table names that match a filter.
`List<String>`	`listTableNamesByFilter(String catName, String dbName, String filter, int maxTables)` Get a list of table names that match a filter.
`LockResponse`	`lock(LockRequest request)` Request a set of locks.
`LockResponse`	`lockMaterializationRebuild(String dbName, String tableName, long txnId)` Acquire the materialization rebuild lock for a given view.
`void`	`mapSchemaVersionToSerde(String catName, String dbName, String schemaName, int version, String serdeName)` Map a schema version to a serde.
`void`	`markCleaned(CompactionInfoStruct cr)` Mark a finished compaction as cleaned.
`void`	`markCompacted(CompactionInfoStruct cr)` Mark a finished compaction as compacted.
`void`	`markFailed(CompactionInfoStruct cr)` Mark a finished compaction as failed.
`void`	`markPartitionForEvent(String db_name, String tbl_name, Map<String,String> partKVs, PartitionEventType eventType)` Mark an event as having occurred on a partition.
`void`	`markPartitionForEvent(String catName, String db_name, String tbl_name, Map<String,String> partKVs, PartitionEventType eventType)` Mark an event as having occurred on a partition.
`void`	`markRefused(CompactionInfoStruct cr)` Mark a compaction as refused (to run).
`long`	`openTxn(String user)` Initiate a transaction.
`long`	`openTxn(String user, TxnType txnType)` Initiate a transaction with given type.
`OpenTxnsResponse`	`openTxns(String user, int numTxns)` Initiate a batch of transactions.
`Map<String,String>`	`partitionNameToSpec(String name)`
`List<String>`	`partitionNameToVals(String name)`
`void`	`putFileMetadata(List<Long> fileIds, List<ByteBuffer> metadata)` Adds file metadata for respective file IDs to metadata cache in metastore.
`void`	`reconnect()` Tries to reconnect this MetaStoreClient to the MetaStore.
`CmRecycleResponse`	`recycleDirToCmPath(CmRecycleRequest request)` Recycles the files recursively from the input path to the cmroot directory either by copying or moving it.
`boolean`	`refresh_privileges(HiveObjectRef objToRefresh, String authorizer, PrivilegeBag grantPrivileges)`
`void`	`removeCompactionMetricsData(CompactionMetricsDataRequest request)` Remove records from the compaction metrics cache matching the filter criteria passed in as parameters
`boolean`	`removeMasterKey(Integer keySeq)`
`boolean`	`removeToken(String tokenIdentifier)`
`void`	`renamePartition(String dbname, String tableName, List<String> part_vals, Partition newPart)` Deprecated.
`default void`	`renamePartition(String catName, String dbname, String tableName, List<String> part_vals, Partition newPart, String validWriteIds)` rename a partition to a new partition
`void`	`renamePartition(String catName, String dbname, String tableName, List<String> part_vals, Partition newPart, String validWriteIds, long txnId, boolean makeCopy)`
`long`	`renewDelegationToken(String tokenStrForm)`
`List<TxnToWriteId>`	`replAllocateTableWriteIdsBatch(String dbName, String tableName, String replPolicy, List<TxnToWriteId> srcTxnToWriteIdList)` Allocate a per table write ID and associate it with the given transaction.
`List<Long>`	`replOpenTxn(String replPolicy, List<Long> srcTxnIds, String user, TxnType txnType)` Initiate a repl replayed or hive replication transaction (dump/load).
`void`	`replRollbackTxn(long srcTxnid, String replPolicy, TxnType txnType)` Rollback a transaction.
`void`	`replTableWriteIdState(String validWriteIdList, String dbName, String tableName, List<String> partNames)` Replicate Table Write Ids state to mark aborted write ids and writeid high water mark.
`boolean`	`revoke_privileges(PrivilegeBag privileges, boolean grantOption)`
`boolean`	`revoke_role(String role_name, String user_name, PrincipalType principalType, boolean grantOption)`
`void`	`rollbackTxn(AbortTxnRequest abortTxnRequest)` Rollback a transaction.
`void`	`rollbackTxn(long txnid)` Rollback a transaction.
`void`	`scheduledQueryMaintenance(ScheduledQueryMaintenanceRequest request)` Carries out maintenance of scheduled queries (insert/update/drop).
`ScheduledQueryPollResponse`	`scheduledQueryPoll(ScheduledQueryPollRequest request)` Checks whenever a query is available for execution.
`void`	`scheduledQueryProgress(ScheduledQueryProgressInfo info)` Registers the progress a scheduled query being executed.
`void`	`seedTxnId(long seedTxnId)` Seed or increment the global txnId to the given value.
`void`	`seedWriteId(String dbName, String tableName, long seedWriteId)` Seed an ACID table with the given writeId.
`void`	`setHadoopJobid(String jobId, long cqId)` Set the hadoop id for a compaction.
`void`	`setHiveAddedJars(String addedJars)` Set added jars path info to MetaStoreClient.
`void`	`setMetaConf(String key, String value)` set meta variable which is open to end users
`boolean`	`setPartitionColumnStatistics(SetPartitionsStatsRequest request)` Set table or partition column statistics.
`default boolean`	`setProperties(String nameSpace, Map<String,String> properties)` Sets properties.
`void`	`setSchemaVersionState(String catName, String dbName, String schemaName, int version, SchemaVersionState state)` Set the state of a schema version.
`ShowCompactResponse`	`showCompactions()` Get a list of all compactions.
`ShowCompactResponse`	`showCompactions(ShowCompactRequest request)` Get a list of compactions for the given request object.
`ShowLocksResponse`	`showLocks()` Deprecated.
`ShowLocksResponse`	`showLocks(ShowLocksRequest showLocksRequest)` Show all currently held and waiting locks.
`GetOpenTxnsInfoResponse`	`showTxns()` Show the list of currently open transactions.
`boolean`	`submitForCleanup(CompactionRequest rqst, long highestWriteId, long txnId)` Submit a request for performing cleanup of output directory.
`boolean`	`tableExists(String databaseName, String tableName)` Check whether a table exists in the default catalog.
`boolean`	`tableExists(String catName, String dbName, String tableName)` Check whether a table exists.
`void`	`truncateTable(String dbName, String tableName, List<String> partNames)` Truncate the table/partitions in the DEFAULT database.
`void`	`truncateTable(String dbName, String tableName, List<String> partNames, String validWriteIds, long writeId)`
`void`	`truncateTable(String dbName, String tableName, List<String> partNames, String validWriteIds, long writeId, boolean deleteData)`
`void`	`truncateTable(String catName, String dbName, String tableName, List<String> partNames)` Truncate the table/partitions in the DEFAULT database.
`void`	`unlock(long lockid)` Unlock a set of locks.
`boolean`	`updateCompactionMetricsData(CompactionMetricsDataStruct struct)` Create, update or delete one record in the compaction metrics cache.
`void`	`updateCompactorState(CompactionInfoStruct cr, long txnId)` Set the compaction highest write id.
`void`	`updateCreationMetadata(String dbName, String tableName, CreationMetadata cm)` Updates the creation metadata for the materialized view.
`void`	`updateCreationMetadata(String catName, String dbName, String tableName, CreationMetadata cm)` Updates the creation metadata for the materialized view.
`void`	`updateMasterKey(Integer seqNo, String key)`
`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`	`updateTransactionalStatistics(UpdateTransactionalStatsRequest req)`
`void`	`validatePartitionNameCharacters(List<String> partVals)`
`WMValidateResourcePlanResponse`	`validateResourcePlan(String resourcePlanName, String ns)`

Method Detail

isCompatibleWith
```
boolean isCompatibleWith(org.apache.hadoop.conf.Configuration conf)
```
Returns whether current client is compatible with conf argument or not

Returns:

setHiveAddedJars
```
void setHiveAddedJars(String addedJars)
```
Set added jars path info to MetaStoreClient.

Parameters:

addedJars - the hive.added.jars.path. It is qualified paths separated by commas.

isLocalMetaStore
```
boolean isLocalMetaStore()
```
Returns true if the current client is using an in process metastore (local metastore).

Returns:

reconnect
```
void reconnect()
        throws MetaException
```
Tries to reconnect this MetaStoreClient to the MetaStore.

Throws:

MetaException

close
```
void close()
```
close connection to meta store

Specified by:

close in interface AutoCloseable

setMetaConf

void setMetaConf(String key,
                 String value)
          throws MetaException,
                 org.apache.thrift.TException

set meta variable which is open to end users

Throws:: MetaException; org.apache.thrift.TException

getMetaConf

String getMetaConf(String key)
            throws MetaException,
                   org.apache.thrift.TException

get current meta variable

Throws:: MetaException; org.apache.thrift.TException

createCatalog
```
void createCatalog(Catalog catalog)
            throws AlreadyExistsException,
                   InvalidObjectException,
                   MetaException,
                   org.apache.thrift.TException
```
Create a new catalog.

Parameters:

catalog - catalog object to create.

Throws:

AlreadyExistsException - A catalog of this name already exists.

InvalidObjectException - There is something wrong with the passed in catalog object.

MetaException - something went wrong, usually either in the database or trying to create the directory for the catalog.

org.apache.thrift.TException - general thrift exception.

alterCatalog
```
void alterCatalog(String catalogName,
                  Catalog newCatalog)
           throws NoSuchObjectException,
                  InvalidObjectException,
                  MetaException,
                  org.apache.thrift.TException
```
Alter an existing catalog.

Parameters:

catalogName - the name of the catalog to alter.

newCatalog - the new catalog object. All relevant details of the catalog should be set, don't rely on the system to figure out what you changed and only copy that in.

Throws:

NoSuchObjectException - no catalog of this name exists

InvalidObjectException - an attempt was made to make an unsupported change (such as catalog name).

MetaException - usually indicates a database error

org.apache.thrift.TException - general thrift exception

getCatalog
```
Catalog getCatalog(String catName)
            throws NoSuchObjectException,
                   MetaException,
                   org.apache.thrift.TException
```
Get a catalog object.

Parameters:

catName - Name of the catalog to fetch.

Returns:

The catalog.

Throws:

NoSuchObjectException - no catalog of this name exists.

MetaException - something went wrong, usually in the database.

org.apache.thrift.TException - general thrift exception.

getCatalogs
```
List<String> getCatalogs()
                  throws MetaException,
                         org.apache.thrift.TException
```
Get a list of all catalogs known to the system.

Returns:

list of catalog names

Throws:

MetaException - something went wrong, usually in the database.

org.apache.thrift.TException - general thrift exception.

dropCatalog
```
void dropCatalog(String catName)
          throws NoSuchObjectException,
                 InvalidOperationException,
                 MetaException,
                 org.apache.thrift.TException
```
Drop a catalog. Catalogs must be empty to be dropped, there is no cascade for dropping a catalog.

Parameters:

catName - name of the catalog to drop

Throws:

NoSuchObjectException - no catalog of this name exists.

InvalidOperationException - The catalog is not empty and cannot be dropped.

MetaException - something went wrong, usually in the database.

org.apache.thrift.TException - general thrift exception.

getDatabases
```
List<String> getDatabases(String databasePattern)
                   throws MetaException,
                          org.apache.thrift.TException
```
Get the names of all databases in the default catalog that match the given pattern.

Parameters:

databasePattern - pattern for the database name to patch

Returns:

List of database names.

Throws:

MetaException - error accessing RDBMS.

org.apache.thrift.TException - thrift transport error

getDatabases
```
List<String> getDatabases(String catName,
                          String databasePattern)
                   throws MetaException,
                          org.apache.thrift.TException
```
Get all databases in a catalog whose names match a pattern.

Parameters:

catName - catalog name. Can be null, in which case the default catalog is assumed.

databasePattern - pattern for the database name to match

Returns:

list of database names

Throws:

MetaException - error accessing RDBMS.

org.apache.thrift.TException - thrift transport error

getAllDatabases
```
List<String> getAllDatabases()
                      throws MetaException,
                             org.apache.thrift.TException
```
Get the names of all databases in the MetaStore.

Returns:

List of database names in the default catalog.

Throws:

MetaException - error accessing RDBMS.

org.apache.thrift.TException - thrift transport error

getAllDatabases
```
List<String> getAllDatabases(String catName)
                      throws MetaException,
                             org.apache.thrift.TException
```
Get all databases in a catalog.

Parameters:

catName - catalog name. Can be null, in which case the default catalog is assumed.

Returns:

list of all database names

Throws:

MetaException - error accessing RDBMS.

org.apache.thrift.TException - thrift transport error

getTables
```
List<String> getTables(String dbName,
                       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 - database name.

tablePattern - pattern for table name to conform to

Returns:

List of table names.

Throws:

MetaException - error fetching information from the RDBMS

org.apache.thrift.TException - thrift transport error

UnknownDBException - indicated database to search in does not exist.

getTables
```
List<String> getTables(String catName,
                       String dbName,
                       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:

catName - catalog name.

dbName - database name.

tablePattern - pattern for table name to conform to

Returns:

List of table names.

Throws:

MetaException - error fetching information from the RDBMS

org.apache.thrift.TException - general thrift error

UnknownDBException - indicated database to search in does not exist.

getTables
```
List<String> getTables(String dbName,
                       String tablePattern,
                       TableType tableType)
                throws MetaException,
                       org.apache.thrift.TException,
                       UnknownDBException
```
Get the names of all tables in the specified database that satisfy the supplied table name pattern and table type (MANAGED_TABLE || EXTERNAL_TABLE || VIRTUAL_VIEW)

Parameters:

dbName - Name of the database to fetch tables in.

tablePattern - pattern to match for table names.

tableType - Type of the table in the HMS store. VIRTUAL_VIEW is for views.

Returns:

List of table names.

Throws:

MetaException - error fetching information from the RDBMS

org.apache.thrift.TException - thrift transport error

UnknownDBException - indicated database does not exist.

getTables
```
List<String> getTables(String catName,
                       String dbName,
                       String tablePattern,
                       TableType tableType)
                throws MetaException,
                       org.apache.thrift.TException,
                       UnknownDBException
```
Get the names of all tables in the specified database that satisfy the supplied table name pattern and table type (MANAGED_TABLE || EXTERNAL_TABLE || VIRTUAL_VIEW)

Parameters:

catName - catalog name.

dbName - Name of the database to fetch tables in.

tablePattern - pattern to match for table names.

tableType - Type of the table in the HMS store. VIRTUAL_VIEW is for views.

Returns:

List of table names.

Throws:

MetaException - error fetching information from the RDBMS

org.apache.thrift.TException - thrift transport error

UnknownDBException - indicated database does not exist.

getAllMaterializedViewObjectsForRewriting

List<Table> getAllMaterializedViewObjectsForRewriting()
                                               throws MetaException,
                                                      org.apache.thrift.TException,
                                                      UnknownDBException

Retrieve all materialized views that have rewriting enabled. This will use the default catalog.

Returns:: List of materialized views.
Throws:: MetaException - error fetching from the RDBMS; org.apache.thrift.TException - thrift transport error; UnknownDBException - no such database

getTablesExt
```
List<ExtendedTableInfo> getTablesExt(String catName,
                                     String dbName,
                                     String tablePattern,
                                     int requestedFields,
                                     int limit)
                              throws MetaException,
                                     org.apache.thrift.TException
```
Get the names of all the tables along with extended table metadata

Parameters:

catName - catalog name.

dbName - Name of the database to fetch tables from.

tablePattern - pattern to match the tables names.

requestedFields - An int bitmask to indicate the depth of the returned objects

limit - Maximum size of the result set. <=0 indicates no limit

Returns:

List of ExtendedTableInfo that match the input arguments.

Throws:

MetaException - Thrown if there is error on fetching from DBMS.

org.apache.thrift.TException - Thrown if there is a thrift transport exception.

getMaterializedViewsForRewriting
```
List<String> getMaterializedViewsForRewriting(String dbName)
                                       throws MetaException,
                                              org.apache.thrift.TException,
                                              UnknownDBException
```
Get materialized views that have rewriting enabled. This will use the default catalog.

Parameters:

dbName - Name of the database to fetch materialized views from.

Returns:

List of materialized view names.

Throws:

MetaException - error fetching from the RDBMS

org.apache.thrift.TException - thrift transport error

UnknownDBException - no such database

getMaterializedViewsForRewriting

List<String> getMaterializedViewsForRewriting(String catName,
                                              String dbName)
                                       throws MetaException,
                                              org.apache.thrift.TException,
                                              UnknownDBException

Get materialized views that have rewriting enabled.

Parameters:: catName - catalog name.; dbName - Name of the database to fetch materialized views from.
Returns:: List of materialized view names.
Throws:: MetaException - error fetching from the RDBMS; org.apache.thrift.TException - thrift transport error; UnknownDBException - no such database

getTableMeta
```
List<TableMeta> getTableMeta(String dbPatterns,
                             String tablePatterns,
                             List<String> tableTypes)
                      throws MetaException,
                             org.apache.thrift.TException,
                             UnknownDBException
```
Fetches just table name and comments. Useful when you need full table name (catalog.database.table) but don't need extra information like partition columns that require additional fetches from the database.

Parameters:

dbPatterns - database pattern to match, or null for all databases

tablePatterns - table pattern to match.

tableTypes - list of table types to fetch.

Returns:

list of TableMeta objects with information on matching tables

Throws:

MetaException - something went wrong with the fetch from the RDBMS

org.apache.thrift.TException - thrift transport error

UnknownDBException - No databases match the provided pattern.

getTableMeta
```
List<TableMeta> getTableMeta(String catName,
                             String dbPatterns,
                             String tablePatterns,
                             List<String> tableTypes)
                      throws MetaException,
                             org.apache.thrift.TException,
                             UnknownDBException
```
Fetches just table name and comments. Useful when you need full table name (catalog.database.table) but don't need extra information like partition columns that require additional fetches from the database.

Parameters:

catName - catalog to search in. Search cannot cross catalogs.

dbPatterns - database pattern to match, or null for all databases

tablePatterns - table pattern to match.

tableTypes - list of table types to fetch.

Returns:

list of TableMeta objects with information on matching tables

Throws:

MetaException - something went wrong with the fetch from the RDBMS

org.apache.thrift.TException - thrift transport error

UnknownDBException - No databases match the provided pattern.

getAllTables
```
List<String> getAllTables(String dbName)
                   throws MetaException,
                          org.apache.thrift.TException,
                          UnknownDBException
```
Get the names of all tables in the specified database.

Parameters:

dbName - database name

Returns:

List of table names.

Throws:

MetaException - something went wrong with the fetch from the RDBMS

org.apache.thrift.TException - thrift transport error

UnknownDBException - No databases match the provided pattern.

getAllTables
```
List<String> getAllTables(String catName,
                          String dbName)
                   throws MetaException,
                          org.apache.thrift.TException,
                          UnknownDBException
```
Get the names of all tables in the specified database.

Parameters:

catName - catalog name

dbName - database name

Returns:

List of table names.

Throws:

MetaException - something went wrong with the fetch from the RDBMS

org.apache.thrift.TException - thrift transport error

UnknownDBException - No databases match the provided pattern.

listTableNamesByFilter
```
List<String> listTableNamesByFilter(String dbName,
                                    String filter,
                                    short maxTables)
                             throws 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:

InvalidOperationException - invalid filter

UnknownDBException - no such database

org.apache.thrift.TException - thrift transport error

listTableNamesByFilter
```
List<String> listTableNamesByFilter(String catName,
                                    String dbName,
                                    String filter,
                                    int maxTables)
                             throws 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:

catName - catalog name

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:

InvalidOperationException - invalid filter

UnknownDBException - no such database

org.apache.thrift.TException - thrift transport error

dropTable
```
void dropTable(String dbname,
               String tableName,
               boolean deleteData,
               boolean ignoreUnknownTab)
        throws MetaException,
               org.apache.thrift.TException,
               NoSuchObjectException
```
Drop the table.

Parameters:

dbname - The database for this table

tableName - The table to drop

deleteData - Should we delete the underlying data

ignoreUnknownTab - don't throw if the requested table doesn't exist

Throws:

MetaException - Could not drop table properly.

NoSuchObjectException - The table wasn't found.

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

dropTable
```
@Deprecated
void dropTable(String dbname,
                           String tableName,
                           boolean deleteData,
                           boolean ignoreUnknownTab,
                           boolean ifPurge)
                    throws MetaException,
                           org.apache.thrift.TException,
                           NoSuchObjectException
```
Deprecated.

Drop the table.

Parameters:

dbname - The database for this table

tableName - The table to drop

deleteData - Should we delete the underlying data

ignoreUnknownTab - don't throw if the requested table doesn't exist

ifPurge - completely purge the table (skipping trash) while removing data from warehouse

Throws:

MetaException - Could not drop table properly.

NoSuchObjectException - The table wasn't found.

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

dropTable

void dropTable(Table table,
               boolean deleteData,
               boolean ignoreUnknownTab,
               boolean ifPurge)
        throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

dropTable
```
void dropTable(String dbname,
               String tableName)
        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

dropTable
```
void dropTable(String catName,
               String dbName,
               String tableName,
               boolean deleteData,
               boolean ignoreUnknownTable,
               boolean ifPurge)
        throws MetaException,
               NoSuchObjectException,
               org.apache.thrift.TException
```
Drop a table.

Parameters:

catName - catalog the table is in.

dbName - database the table is in.

tableName - table name.

deleteData - whether associated data should be deleted.

ignoreUnknownTable - whether a non-existent table name should be ignored

ifPurge - whether dropped data should be immediately removed rather than placed in HDFS trash.

Throws:

MetaException - something went wrong, usually in the RDBMS or storage.

NoSuchObjectException - No table of this name exists, only thrown if ignoreUnknownTable is false.

org.apache.thrift.TException - general thrift error.

dropTable
```
default void dropTable(String catName,
                       String dbName,
                       String tableName,
                       boolean deleteData,
                       boolean ignoreUnknownTable)
                throws MetaException,
                       NoSuchObjectException,
                       org.apache.thrift.TException
```
Drop a table. Equivalent to dropTable(String, String, String, boolean, boolean, boolean) with ifPurge set to false.

Parameters:

catName - catalog the table is in.

dbName - database the table is in.

tableName - table name.

deleteData - whether associated data should be deleted.

ignoreUnknownTable - whether a non-existent table name should be ignored

Throws:

MetaException - something went wrong, usually in the RDBMS or storage.

NoSuchObjectException - No table of this name exists, only thrown if ignoreUnknownTable is false.

org.apache.thrift.TException - general thrift error.

dropTable
```
default void dropTable(String catName,
                       String dbName,
                       String tableName)
                throws MetaException,
                       NoSuchObjectException,
                       org.apache.thrift.TException
```
Drop a table. Equivalent to dropTable(String, String, String, boolean, boolean, boolean) with deleteData set and ignoreUnknownTable set to true and ifPurge set to false.

Parameters:

catName - catalog the table is in.

dbName - database the table is in.

tableName - table name.

Throws:

MetaException - something went wrong, usually in the RDBMS or storage.

NoSuchObjectException - No table of this name exists, only thrown if ignoreUnknownTable is false.

org.apache.thrift.TException - general thrift error.

truncateTable
```
void truncateTable(String dbName,
                   String tableName,
                   List<String> partNames)
            throws MetaException,
                   org.apache.thrift.TException
```
Truncate the table/partitions in the DEFAULT database.

Parameters:

dbName - The db to which the table to be truncate belongs to

tableName - The table to truncate

partNames - List of partitions to truncate. NULL will truncate the whole table/all partitions

Throws:

MetaException - Failure in the RDBMS or storage

org.apache.thrift.TException - Thrift transport exception

truncateTable

void truncateTable(String dbName,
                   String tableName,
                   List<String> partNames,
                   String validWriteIds,
                   long writeId)
            throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

truncateTable

void truncateTable(String dbName,
                   String tableName,
                   List<String> partNames,
                   String validWriteIds,
                   long writeId,
                   boolean deleteData)
            throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

truncateTable
```
void truncateTable(String catName,
                   String dbName,
                   String tableName,
                   List<String> partNames)
            throws MetaException,
                   org.apache.thrift.TException
```
Truncate the table/partitions in the DEFAULT database.

Parameters:

catName - catalog name

dbName - The db to which the table to be truncate belongs to

tableName - The table to truncate

partNames - List of partitions to truncate. NULL will truncate the whole table/all partitions

Throws:

MetaException - Failure in the RDBMS or storage

org.apache.thrift.TException - Thrift transport exception

recycleDirToCmPath
```
CmRecycleResponse recycleDirToCmPath(CmRecycleRequest request)
                              throws MetaException,
                                     org.apache.thrift.TException
```
Recycles the files recursively from the input path to the cmroot directory either by copying or moving it.

Parameters:

request - Inputs for path of the data files to be recycled to cmroot and isPurge flag when set to true files which needs to be recycled are not moved to Trash

Returns:

Response which is currently void

Throws:

MetaException

org.apache.thrift.TException

tableExists
```
boolean tableExists(String databaseName,
                    String tableName)
             throws MetaException,
                    org.apache.thrift.TException,
                    UnknownDBException
```
Check whether a table exists in the default catalog.

Parameters:

databaseName - database name

tableName - table name

Returns:

true if the indicated table exists, false if not

Throws:

MetaException - error fetching form the RDBMS

org.apache.thrift.TException - thrift transport error

UnknownDBException - the indicated database does not exist.

tableExists
```
boolean tableExists(String catName,
                    String dbName,
                    String tableName)
             throws MetaException,
                    org.apache.thrift.TException,
                    UnknownDBException
```
Check whether a table exists.

Parameters:

catName - catalog name

dbName - database name

tableName - table name

Returns:

true if the indicated table exists, false if not

Throws:

MetaException - error fetching form the RDBMS

org.apache.thrift.TException - thrift transport error

UnknownDBException - the indicated database does not exist.

getDatabase
```
Database getDatabase(String databaseName)
              throws NoSuchObjectException,
                     MetaException,
                     org.apache.thrift.TException
```
Get a Database Object in the default catalog

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

getDatabase
```
Database getDatabase(String catalogName,
                     String databaseName)
              throws NoSuchObjectException,
                     MetaException,
                     org.apache.thrift.TException
```
Get a database.

Parameters:

catalogName - catalog name. Can be null, in which case Warehouse.DEFAULT_CATALOG_NAME will be assumed.

databaseName - database name

Returns:

the database object

Throws:

NoSuchObjectException - No database with this name exists in the specified catalog

MetaException - something went wrong, usually in the RDBMS

org.apache.thrift.TException - general thrift error

getTable
```
@Deprecated
Table getTable(String dbName,
                           String tableName)
                    throws MetaException,
                           org.apache.thrift.TException,
                           NoSuchObjectException
```
Deprecated. use getTable(GetTableRequest getTableRequest)

Get a table object in the default catalog.

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.

getTable
```
@Deprecated
Table getTable(String dbName,
                           String tableName,
                           boolean getColumnStats,
                           String engine)
                    throws MetaException,
                           org.apache.thrift.TException,
                           NoSuchObjectException
```
Deprecated. use getTable(GetTableRequest getTableRequest)

Get a table object in the default catalog.

Parameters:

dbName - The database the table is located in.

tableName - Name of the table to fetch.

getColumnStats - get the column stats, if available, when true

engine - engine sending the request

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.

getTable
```
@Deprecated
Table getTable(String catName,
                           String dbName,
                           String tableName)
                    throws MetaException,
                           org.apache.thrift.TException
```
Deprecated. use getTable(GetTableRequest getTableRequest)

Get a table object.

Parameters:

catName - catalog the table is in.

dbName - database the table is in.

tableName - table name.

Returns:

table object.

Throws:

MetaException - Something went wrong, usually in the RDBMS.

org.apache.thrift.TException - general thrift error.

getTable
```
@Deprecated
Table getTable(String catName,
                           String dbName,
                           String tableName,
                           String validWriteIdList)
                    throws org.apache.thrift.TException
```
Deprecated. use getTable(GetTableRequest getTableRequest)

Get a table object.

Parameters:

catName - catalog the table is in.

dbName - database the table is in.

tableName - table name.

validWriteIdList - applicable snapshot

Returns:

table object.

Throws:

MetaException - Something went wrong, usually in the RDBMS.

org.apache.thrift.TException - general thrift error.

getTable

@Deprecated
Table getTable(String catName,
                           String dbName,
                           String tableName,
                           String validWriteIdList,
                           boolean getColumnStats,
                           String engine)
                    throws org.apache.thrift.TException

Deprecated. use getTable(GetTableRequest getTableRequest)

Get a table object.

Parameters:: catName - catalog the table is in.; dbName - database the table is in.; tableName - table name.; validWriteIdList - applicable snapshot; getColumnStats - get the column stats, if available, when true; engine - engine sending the request
Returns:: table object.
Throws:: MetaException - Something went wrong, usually in the RDBMS.; org.apache.thrift.TException - general thrift error.

getTable
```
Table getTable(GetTableRequest getTableRequest)
        throws MetaException,
               org.apache.thrift.TException,
               NoSuchObjectException
```
Parameters:

getTableRequest - request object to query a table in HMS

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
```
List<Table> getTableObjectsByName(String dbName,
                                  List<String> tableNames)
                           throws MetaException,
                                  InvalidOperationException,
                                  UnknownDBException,
                                  org.apache.thrift.TException
```
Get tables as objects (rather than just fetching their names). This is more expensive and should only be used if you actually need all the information about the tables.

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

getTables
```
List<Table> getTables(String catName,
                      String dbName,
                      List<String> tableNames,
                      GetProjectionsSpec projectionsSpec)
               throws MetaException,
                      InvalidOperationException,
                      UnknownDBException,
                      org.apache.thrift.TException
```
Get tables as objects (rather than just fetching their names). This is more expensive and should only be used if you actually need all the information about the tables.

Parameters:

catName - catalog name

dbName - The database the tables are located in.

tableNames - The names of the tables to fetch.

projectionsSpec - The subset of columns that need to be fetched as part of the table object.

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

getTableObjectsByName
```
List<Table> getTableObjectsByName(String catName,
                                  String dbName,
                                  List<String> tableNames)
                           throws MetaException,
                                  InvalidOperationException,
                                  UnknownDBException,
                                  org.apache.thrift.TException
```
Get tables as objects (rather than just fetching their names). This is more expensive and should only be used if you actually need all the information about the tables.

Parameters:

catName - catalog name

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

getMaterializationInvalidationInfo

Materialization getMaterializationInvalidationInfo(CreationMetadata cm,
                                                   String validTxnList)
                                            throws MetaException,
                                                   InvalidOperationException,
                                                   UnknownDBException,
                                                   org.apache.thrift.TException

Returns the invalidation information for the materialized views given as input.

Throws:: MetaException; InvalidOperationException; UnknownDBException; org.apache.thrift.TException

updateCreationMetadata

void updateCreationMetadata(String dbName,
                            String tableName,
                            CreationMetadata cm)
                     throws MetaException,
                            org.apache.thrift.TException

Updates the creation metadata for the materialized view.

Throws:: MetaException; org.apache.thrift.TException

updateCreationMetadata

void updateCreationMetadata(String catName,
                            String dbName,
                            String tableName,
                            CreationMetadata cm)
                     throws MetaException,
                            org.apache.thrift.TException

Updates the creation metadata for the materialized view.

Throws:: MetaException; org.apache.thrift.TException

appendPartition
```
Partition appendPartition(String dbName,
                          String tableName,
                          List<String> partVals)
                   throws InvalidObjectException,
                          AlreadyExistsException,
                          MetaException,
                          org.apache.thrift.TException
```
/** Add a partition to a table and get back the resulting Partition object. This creates an empty default partition with just the partition values set.

Parameters:

dbName - database name

tableName - table name

partVals - partition values

Returns:

the partition object

Throws:

InvalidObjectException - no such table

AlreadyExistsException - a partition with these values already exists

MetaException - error accessing the RDBMS

org.apache.thrift.TException - thrift transport error

appendPartition

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

Add a partition to a table and get back the resulting Partition object. This creates an empty default partition with just the partition values set.

Parameters:: catName - catalog name; dbName - database name; tableName - table name; partVals - partition values
Returns:: the partition object
Throws:: InvalidObjectException - no such table; AlreadyExistsException - a partition with these values already exists; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

appendPartition
```
Partition appendPartition(String dbName,
                          String tableName,
                          String name)
                   throws InvalidObjectException,
                          AlreadyExistsException,
                          MetaException,
                          org.apache.thrift.TException
```
Add a partition to a table and get back the resulting Partition object. This creates an empty default partition with just the partition value set.

Parameters:

dbName - database name.

tableName - table name.

name - name of the partition, should be in the form partkey=partval.

Returns:

new partition object.

Throws:

InvalidObjectException - No such table.

AlreadyExistsException - Partition of this name already exists.

MetaException - error accessing the RDBMS

org.apache.thrift.TException - thrift transport error

appendPartition
```
Partition appendPartition(String catName,
                          String dbName,
                          String tableName,
                          String name)
                   throws InvalidObjectException,
                          AlreadyExistsException,
                          MetaException,
                          org.apache.thrift.TException
```
Add a partition to a table and get back the resulting Partition object. This creates an empty default partition with just the partition value set.

Parameters:

catName - catalog name.

dbName - database name.

tableName - table name.

name - name of the partition, should be in the form partkey=partval.

Returns:

new partition object.

Throws:

InvalidObjectException - No such table.

AlreadyExistsException - Partition of this name already exists.

MetaException - error accessing the RDBMS

org.apache.thrift.TException - thrift transport error

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(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

add_partitions_pspec
```
int add_partitions_pspec(PartitionSpecProxy partitionSpec)
                  throws InvalidObjectException,
                         AlreadyExistsException,
                         MetaException,
                         org.apache.thrift.TException
```
Add a partitions using a spec proxy.

Parameters:

partitionSpec - partition spec proxy

Returns:

number of partitions that were added

Throws:

InvalidObjectException - the partitionSpec is malformed.

AlreadyExistsException - one or more of the partitions already exist.

MetaException - error accessing the RDBMS or storage.

org.apache.thrift.TException - thrift transport error

add_partitions

List<Partition> add_partitions(List<Partition> partitions,
                               boolean ifNotExists,
                               boolean needResults)
                        throws InvalidObjectException,
                               AlreadyExistsException,
                               MetaException,
                               org.apache.thrift.TException

Add partitions to the table.

Parameters:: partitions - The partitions to add; ifNotExists - only add partitions if they don't exist; needResults - Whether the results are needed
Returns:: the partitions that were added, or null if !needResults
Throws:: InvalidObjectException; AlreadyExistsException; MetaException; org.apache.thrift.TException

getPartition
```
Partition getPartition(String dbName,
                       String tblName,
                       List<String> partVals)
                throws NoSuchObjectException,
                       MetaException,
                       org.apache.thrift.TException
```
Get a partition.

Parameters:

dbName - database name

tblName - table name

partVals - partition values for this partition, must be in the same order as the partition keys of the table.

Returns:

the partition object

Throws:

NoSuchObjectException - no such partition

MetaException - error access the RDBMS.

org.apache.thrift.TException - thrift transport error

getPartitionRequest

GetPartitionResponse getPartitionRequest(GetPartitionRequest req)
                                  throws NoSuchObjectException,
                                         MetaException,
                                         org.apache.thrift.TException

Get a partition.

Parameters:: req -
Returns:: GetPartitionResponse
Throws:: NoSuchObjectException - no such partition; MetaException - error access the RDBMS.; org.apache.thrift.TException - thrift transport error

getPartition

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

Get a partition.

Parameters:: catName - catalog name; dbName - database name; tblName - table name; partVals - partition values for this partition, must be in the same order as the partition keys of the table.
Returns:: the partition object
Throws:: NoSuchObjectException - no such partition; MetaException - error access the RDBMS.; org.apache.thrift.TException - thrift transport error

exchange_partition

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

Move a partition from one table to another

Parameters:: partitionSpecs - key value pairs that describe the partition to be moved.; sourceDb - database of the source table; sourceTable - name of the source table; destdb - database of the destination table; destTableName - name of the destination table
Returns:: partition object
Throws:: MetaException - error accessing the RDBMS or storage; NoSuchObjectException - no such table, for either source or destination table; InvalidObjectException - error in partition specifications; org.apache.thrift.TException - thrift transport error

exchange_partition

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

Move a partition from one table to another

Parameters:: partitionSpecs - key value pairs that describe the partition to be moved.; sourceCat - catalog of the source table; sourceDb - database of the source table; sourceTable - name of the source table; destCat - catalog of the destination table, for now must the same as sourceCat; destdb - database of the destination table; destTableName - name of the destination table
Returns:: partition object
Throws:: MetaException - error accessing the RDBMS or storage; NoSuchObjectException - no such table, for either source or destination table; InvalidObjectException - error in partition specifications; org.apache.thrift.TException - thrift transport error

exchange_partitions
```
List<Partition> exchange_partitions(Map<String,String> partitionSpecs,
                                    String sourceDb,
                                    String sourceTable,
                                    String destdb,
                                    String destTableName)
                             throws MetaException,
                                    NoSuchObjectException,
                                    InvalidObjectException,
                                    org.apache.thrift.TException
```
With the one partitionSpecs to exchange, multiple partitions could be exchanged. e.g., year=2015/month/day, exchanging partition year=2015 results to all the partitions belonging to it exchanged. This function returns the list of affected partitions.

Parameters:

partitionSpecs - key value pairs that describe the partition(s) to be moved.

sourceDb - database of the source table

sourceTable - name of the source table

destdb - database of the destination table

destTableName - name of the destination table

Returns:

the list of the new partitions

Throws:

MetaException - error accessing the RDBMS or storage

NoSuchObjectException - no such table, for either source or destination table

InvalidObjectException - error in partition specifications

org.apache.thrift.TException - thrift transport error

exchange_partitions

List<Partition> exchange_partitions(Map<String,String> partitionSpecs,
                                    String sourceCat,
                                    String sourceDb,
                                    String sourceTable,
                                    String destCat,
                                    String destdb,
                                    String destTableName)
                             throws MetaException,
                                    NoSuchObjectException,
                                    InvalidObjectException,
                                    org.apache.thrift.TException

With the one partitionSpecs to exchange, multiple partitions could be exchanged. e.g., year=2015/month/day, exchanging partition year=2015 results to all the partitions belonging to it exchanged. This function returns the list of affected partitions.

Parameters:: partitionSpecs - key value pairs that describe the partition(s) to be moved.; sourceCat - catalog of the source table; sourceDb - database of the source table; sourceTable - name of the source table; destCat - catalog of the destination table, for now must the same as sourceCat; destdb - database of the destination table; destTableName - name of the destination table
Returns:: the list of the new partitions
Throws:: MetaException - error accessing the RDBMS or storage; NoSuchObjectException - no such table, for either source or destination table; InvalidObjectException - error in partition specifications; org.apache.thrift.TException - thrift transport error

getPartition

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

Get a Partition by name.

Parameters:: dbName - database name.; tblName - table name.; name - - partition name i.e. 'ds=2010-02-03/ts=2010-02-03 18%3A16%3A01'
Returns:: the partition object
Throws:: MetaException - error access the RDBMS.; org.apache.thrift.TException - thrift transport error; UnknownTableException; NoSuchObjectException

getPartition

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

Get a Partition by name.

Parameters:: catName - catalog name.; dbName - database name.; tblName - table name.; name - - partition name i.e. 'ds=2010-02-03/ts=2010-02-03 18%3A16%3A01'
Returns:: the partition object
Throws:: MetaException - error access the RDBMS.; org.apache.thrift.TException - thrift transport error; UnknownTableException; NoSuchObjectException

getPartitionWithAuthInfo

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

Get a Partition along with authorization information.

Parameters:: dbName - database name; tableName - table name; pvals - partition values, must be in the same order as the tables partition keys; userName - name of the calling user; groupNames - groups the call
Returns:: the partition
Throws:: MetaException - error accessing the RDBMS; UnknownTableException - no such table; NoSuchObjectException - no such partition; org.apache.thrift.TException - thrift transport error

getPartitionWithAuthInfo

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

Get a Partition along with authorization information.

Parameters:: catName - catalog name; dbName - database name; tableName - table name; pvals - partition values, must be in the same order as the tables partition keys; userName - name of the calling user; groupNames - groups the call
Returns:: the partition
Throws:: MetaException - error accessing the RDBMS; UnknownTableException - no such table; NoSuchObjectException - no such partition; org.apache.thrift.TException - thrift transport error

listPartitions

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

Get a list of partittions for a table.

Parameters:: db_name - database name; tbl_name - table name; max_parts - maximum number of parts to return, -1 for all
Returns:: the list of partitions
Throws:: NoSuchObjectException - No such table.; MetaException - error accessing RDBMS.; org.apache.thrift.TException - thrift transport error

listPartitions

List<Partition> listPartitions(String catName,
                               String db_name,
                               String tbl_name,
                               int max_parts)
                        throws NoSuchObjectException,
                               MetaException,
                               org.apache.thrift.TException

Get a list of partittions for a table.

Parameters:: catName - catalog name; db_name - database name; tbl_name - table name; max_parts - maximum number of parts to return, -1 for all
Returns:: the list of partitions
Throws:: NoSuchObjectException - No such table.; MetaException - error accessing RDBMS.; org.apache.thrift.TException - thrift transport error

listPartitionSpecs
```
PartitionSpecProxy listPartitionSpecs(String dbName,
                                      String tableName,
                                      int maxParts)
                               throws org.apache.thrift.TException
```
Get a list of partitions from a table, returned in the form of PartitionSpecProxy

Parameters:

dbName - database name.

tableName - table name.

maxParts - maximum number of partitions to return, or -1 for all

Returns:

a PartitionSpecProxy

Throws:

org.apache.thrift.TException - thrift transport error

listPartitionSpecs

PartitionSpecProxy listPartitionSpecs(String catName,
                                      String dbName,
                                      String tableName,
                                      int maxParts)
                               throws org.apache.thrift.TException

Get a list of partitions from a table, returned in the form of PartitionSpecProxy

Parameters:: catName - catalog name.; dbName - database name.; tableName - table name.; maxParts - maximum number of partitions to return, or -1 for all
Returns:: a PartitionSpecProxy
Throws:: org.apache.thrift.TException - thrift transport error

listPartitions
```
List<Partition> listPartitions(String db_name,
                               String tbl_name,
                               List<String> part_vals,
                               short max_parts)
                        throws NoSuchObjectException,
                               MetaException,
                               org.apache.thrift.TException
```
Get a list of partitions based on a (possibly partial) list of partition values.

Parameters:

db_name - database name.

tbl_name - table name.

part_vals - partition values, in order of the table partition keys. These can be partial, or .* to match all values for a particular key.

max_parts - maximum number of partitions to return, or -1 for all.

Returns:

list of partitions

Throws:

NoSuchObjectException - no such table.

MetaException - error accessing the database or processing the partition values.

org.apache.thrift.TException - thrift transport error.

listPartitions
```
List<Partition> listPartitions(String catName,
                               String db_name,
                               String tbl_name,
                               List<String> part_vals,
                               int max_parts)
                        throws NoSuchObjectException,
                               MetaException,
                               org.apache.thrift.TException
```
Get a list of partitions based on a (possibly partial) list of partition values.

Parameters:

catName - catalog name.

db_name - database name.

tbl_name - table name.

part_vals - partition values, in order of the table partition keys. These can be partial, or .* to match all values for a particular key.

max_parts - maximum number of partitions to return, or -1 for all.

Returns:

list of partitions

Throws:

NoSuchObjectException - no such table.

MetaException - error accessing the database or processing the partition values.

org.apache.thrift.TException - thrift transport error.

listPartitionNames

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

List Names of partitions in a table.

Parameters:: db_name - database name.; tbl_name - table name.; max_parts - maximum number of parts of fetch, or -1 to fetch them all.
Returns:: list of partition names.
Throws:: NoSuchObjectException - No such table.; MetaException - Error accessing the RDBMS.; org.apache.thrift.TException - thrift transport error

listPartitionNamesRequest

GetPartitionNamesPsResponse listPartitionNamesRequest(GetPartitionNamesPsRequest req)
                                               throws NoSuchObjectException,
                                                      MetaException,
                                                      org.apache.thrift.TException

List Names of partitions in a table.

Parameters:: req -
Returns:: GetPartitionNamesPsResponse
Throws:: NoSuchObjectException - No such table.; MetaException - Error accessing the RDBMS.; org.apache.thrift.TException - thrift transport error

listPartitionNames

List<String> listPartitionNames(String catName,
                                String db_name,
                                String tbl_name,
                                int max_parts)
                         throws NoSuchObjectException,
                                MetaException,
                                org.apache.thrift.TException

List Names of partitions in a table.

Parameters:: catName - catalog name.; db_name - database name.; tbl_name - table name.; max_parts - maximum number of parts of fetch, or -1 to fetch them all.
Returns:: list of partition names.
Throws:: NoSuchObjectException - No such table.; MetaException - Error accessing the RDBMS.; org.apache.thrift.TException - thrift transport error

listPartitionNames
```
List<String> listPartitionNames(String db_name,
                                String tbl_name,
                                List<String> part_vals,
                                short max_parts)
                         throws MetaException,
                                org.apache.thrift.TException,
                                NoSuchObjectException
```
Get a list of partition names matching a partial specification of the partition values.

Parameters:

db_name - database name.

tbl_name - table name.

part_vals - partial list of partition values. These must be given in the order of the partition keys. If you wish to accept any value for a particular key you can pass ".*" for that value in this list.

max_parts - maximum number of partition names to return, or -1 to return all that are found.

Returns:

list of matching partition names.

Throws:

MetaException - error accessing the RDBMS.

org.apache.thrift.TException - thrift transport error.

NoSuchObjectException - no such table.

listPartitionNames
```
List<String> listPartitionNames(String catName,
                                String db_name,
                                String tbl_name,
                                List<String> part_vals,
                                int max_parts)
                         throws MetaException,
                                org.apache.thrift.TException,
                                NoSuchObjectException
```
Get a list of partition names matching a partial specification of the partition values.

Parameters:

catName - catalog name.

db_name - database name.

tbl_name - table name.

part_vals - partial list of partition values. These must be given in the order of the partition keys. If you wish to accept any value for a particular key you can pass ".*" for that value in this list.

max_parts - maximum number of partition names to return, or -1 to return all that are found.

Returns:

list of matching partition names.

Throws:

MetaException - error accessing the RDBMS.

org.apache.thrift.TException - thrift transport error.

NoSuchObjectException - no such table.

listPartitionNames
```
List<String> listPartitionNames(PartitionsByExprRequest request)
                         throws MetaException,
                                org.apache.thrift.TException,
                                NoSuchObjectException
```
Get a list of partition names matching the specified filter and return in order if specified.

Parameters:

request - request

Returns:

list of matching partition names.

Throws:

MetaException - error accessing the RDBMS.

org.apache.thrift.TException - thrift transport error.

NoSuchObjectException - no such table.

listPartitionValues

PartitionValuesResponse listPartitionValues(PartitionValuesRequest request)
                                     throws MetaException,
                                            org.apache.thrift.TException,
                                            NoSuchObjectException

Get a list of partition values

Parameters:: request - request
Returns:: reponse
Throws:: MetaException - error accessing RDBMS; org.apache.thrift.TException - thrift transport error; NoSuchObjectException - no such table

getNumPartitionsByFilter
```
int getNumPartitionsByFilter(String dbName,
                             String tableName,
                             String filter)
                      throws MetaException,
                             NoSuchObjectException,
                             org.apache.thrift.TException
```
Get number of partitions matching specified filter

Parameters:

dbName - the database name

tableName - 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.

Returns:

number of partitions

Throws:

MetaException - error accessing RDBMS or processing the filter

NoSuchObjectException - no such table

org.apache.thrift.TException - thrift transport error

getNumPartitionsByFilter
```
int getNumPartitionsByFilter(String catName,
                             String dbName,
                             String tableName,
                             String filter)
                      throws MetaException,
                             NoSuchObjectException,
                             org.apache.thrift.TException
```
Get number of partitions matching specified filter

Parameters:

catName - catalog name

dbName - the database name

tableName - 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.

Returns:

number of partitions

Throws:

MetaException - error accessing RDBMS or processing the filter

NoSuchObjectException - no such table

org.apache.thrift.TException - thrift transport error

listPartitionsByFilter
```
List<Partition> listPartitionsByFilter(String db_name,
                                       String tbl_name,
                                       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 - Error accessing the RDBMS or processing the filter.

NoSuchObjectException - No such table.

org.apache.thrift.TException - thrift transport error

listPartitionsByFilter

List<Partition> listPartitionsByFilter(String catName,
                                       String db_name,
                                       String tbl_name,
                                       String filter,
                                       int max_parts)
                                throws MetaException,
                                       NoSuchObjectException,
                                       org.apache.thrift.TException

Get list of partitions matching specified filter

Parameters:: catName - catalog name.; 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 - Error accessing the RDBMS or processing the filter.; NoSuchObjectException - No such table.; org.apache.thrift.TException - thrift transport error

listPartitionSpecsByFilter

PartitionSpecProxy listPartitionSpecsByFilter(String db_name,
                                              String tbl_name,
                                              String filter,
                                              int max_parts)
                                       throws MetaException,
                                              NoSuchObjectException,
                                              org.apache.thrift.TException

Get a list of partitions in a PartitionSpec, using a filter to select which partitions to fetch.

Parameters:: db_name - database name; tbl_name - table name; filter - SQL where clause filter; max_parts - maximum number of partitions to fetch, or -1 for all
Returns:: PartitionSpec
Throws:: MetaException - error accessing RDBMS or processing the filter; NoSuchObjectException - No table matches the request; org.apache.thrift.TException - thrift transport error

listPartitionSpecsByFilter

PartitionSpecProxy listPartitionSpecsByFilter(String catName,
                                              String db_name,
                                              String tbl_name,
                                              String filter,
                                              int max_parts)
                                       throws MetaException,
                                              NoSuchObjectException,
                                              org.apache.thrift.TException

Get a list of partitions in a PartitionSpec, using a filter to select which partitions to fetch.

Parameters:: catName - catalog name; db_name - database name; tbl_name - table name; filter - SQL where clause filter; max_parts - maximum number of partitions to fetch, or -1 for all
Returns:: PartitionSpec
Throws:: MetaException - error accessing RDBMS or processing the filter; NoSuchObjectException - No table matches the request; org.apache.thrift.TException - thrift transport error

listPartitionsSpecByExpr
```
boolean listPartitionsSpecByExpr(PartitionsByExprRequest req,
                                 List<PartitionSpec> result)
                          throws org.apache.thrift.TException
```
Get list of PartitionSpec matching specified serialized expression.

Parameters:

req - PartitionsByExprRequest object

Returns:

whether the resulting list contains partitions which may or may not match the expr

Throws:

org.apache.thrift.TException - thrift transport error or error executing the filter.

listPartitionsByExpr
```
boolean listPartitionsByExpr(String db_name,
                             String tbl_name,
                             byte[] expr,
                             String default_partition_name,
                             short max_parts,
                             List<Partition> result)
                      throws org.apache.thrift.TException
```
Get list of partitions matching specified serialized expression

Parameters:

db_name - the database name

tbl_name - the table name

expr - expression, serialized from ExprNodeDesc

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

default_partition_name - Default partition name from configuration. If blank, the metastore server-side configuration is used.

result - the resulting list of partitions

Returns:

whether the resulting list contains partitions which may or may not match the expr

Throws:

org.apache.thrift.TException - thrift transport error or error executing the filter.

listPartitionsByExpr
```
boolean listPartitionsByExpr(String catName,
                             String db_name,
                             String tbl_name,
                             byte[] expr,
                             String default_partition_name,
                             int max_parts,
                             List<Partition> result)
                      throws org.apache.thrift.TException
```
Get list of partitions matching specified serialized expression

Parameters:

catName - catalog name

db_name - the database name

tbl_name - the table name

expr - expression, serialized from ExprNodeDesc

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

default_partition_name - Default partition name from configuration. If blank, the metastore server-side configuration is used.

result - the resulting list of partitions

Returns:

whether the resulting list contains partitions which may or may not match the expr

Throws:

org.apache.thrift.TException - thrift transport error or error executing the filter.

listPartitionsWithAuthInfo

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

List partitions, fetching the authorization information along with the partitions.

Parameters:: dbName - database name; tableName - table name; maxParts - maximum number of partitions to fetch, or -1 for all; userName - user to fetch privileges for; groupNames - groups to fetch privileges for
Returns:: the list of partitions
Throws:: NoSuchObjectException - no partitions matching the criteria were found; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

listPartitionsWithAuthInfoRequest

GetPartitionsPsWithAuthResponse listPartitionsWithAuthInfoRequest(GetPartitionsPsWithAuthRequest req)
                                                           throws MetaException,
                                                                  org.apache.thrift.TException,
                                                                  NoSuchObjectException

List partitions, fetching the authorization information along with the partitions.

Parameters:: req -
Returns:: GetPartitionsPsWithAuthResponse
Throws:: NoSuchObjectException - no partitions matching the criteria were found; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

listPartitionsWithAuthInfo

List<Partition> listPartitionsWithAuthInfo(String catName,
                                           String dbName,
                                           String tableName,
                                           int maxParts,
                                           String userName,
                                           List<String> groupNames)
                                    throws MetaException,
                                           org.apache.thrift.TException,
                                           NoSuchObjectException

List partitions, fetching the authorization information along with the partitions.

Parameters:: catName - catalog name; dbName - database name; tableName - table name; maxParts - maximum number of partitions to fetch, or -1 for all; userName - user to fetch privileges for; groupNames - groups to fetch privileges for
Returns:: the list of partitions
Throws:: NoSuchObjectException - no partitions matching the criteria were found; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

getPartitionsByNames

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

Deprecated. Use getPartitionsByNames(GetPartitionsByNamesRequest) instead

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 - No such partitions; MetaException - error accessing the RDBMS.; org.apache.thrift.TException - thrift transport error

getPartitionsByNames

@Deprecated
List<Partition> getPartitionsByNames(String catName,
                                                 String db_name,
                                                 String tbl_name,
                                                 List<String> part_names)
                                          throws NoSuchObjectException,
                                                 MetaException,
                                                 org.apache.thrift.TException

Deprecated. Use getPartitionsByNames(GetPartitionsByNamesRequest) instead

Get partitions by a list of partition names.

Parameters:: catName - catalog name; db_name - database name; tbl_name - table name; part_names - list of partition names
Returns:: list of Partition objects
Throws:: NoSuchObjectException - No such partitions; MetaException - error accessing the RDBMS.; org.apache.thrift.TException - thrift transport error

getPartitionsRequest

PartitionsResponse getPartitionsRequest(PartitionsRequest req)
                                 throws NoSuchObjectException,
                                        MetaException,
                                        org.apache.thrift.TException

Get partitions by a list of partition names.

Parameters:: req -
Returns:: PartitionsResponse
Throws:: NoSuchObjectException - No such partitions; MetaException - error accessing the RDBMS.; org.apache.thrift.TException - thrift transport error

getPartitionsByNames
```
GetPartitionsByNamesResult getPartitionsByNames(GetPartitionsByNamesRequest req)
                                         throws org.apache.thrift.TException
```
Get partitions by a list of partition names.

Parameters:

req - GetPartitionsByNamesRequest

Returns:

list of Partition objects

Throws:

NoSuchObjectException - No such partitions

MetaException - error accessing the RDBMS.

org.apache.thrift.TException - thrift transport error

listPartitionsWithAuthInfo

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

List partitions along with privilege information for a user or groups

Parameters:: dbName - database name; tableName - table name; partialPvals - partition values, can be partial; maxParts - maximum number of partitions to fetch, or -1 for all; userName - user to fetch privilege information for; groupNames - group to fetch privilege information for
Returns:: the list of partitions
Throws:: NoSuchObjectException - no partitions matching the criteria were found; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

listPartitionsWithAuthInfo

List<Partition> listPartitionsWithAuthInfo(String catName,
                                           String dbName,
                                           String tableName,
                                           List<String> partialPvals,
                                           int maxParts,
                                           String userName,
                                           List<String> groupNames)
                                    throws MetaException,
                                           org.apache.thrift.TException,
                                           NoSuchObjectException

List partitions along with privilege information for a user or groups

Parameters:: dbName - database name; tableName - table name; partialPvals - partition values, can be partial; maxParts - maximum number of partitions to fetch, or -1 for all; userName - user to fetch privilege information for; groupNames - group to fetch privilege information for
Returns:: the list of partitions
Throws:: NoSuchObjectException - no partitions matching the criteria were found; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

markPartitionForEvent

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

Mark an event as having occurred on a partition.

Parameters:: db_name - database name; tbl_name - table name; partKVs - key value pairs that describe the partition; eventType - type of the event
Throws:: MetaException - error access the RDBMS; NoSuchObjectException - never throws this AFAICT; org.apache.thrift.TException - thrift transport error; UnknownTableException - no such table; UnknownDBException - no such database; UnknownPartitionException - no such partition; InvalidPartitionException - partition partKVs is invalid

markPartitionForEvent

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

Mark an event as having occurred on a partition.

Parameters:: catName - catalog name; db_name - database name; tbl_name - table name; partKVs - key value pairs that describe the partition; eventType - type of the event
Throws:: MetaException - error access the RDBMS; NoSuchObjectException - never throws this AFAICT; org.apache.thrift.TException - thrift transport error; UnknownTableException - no such table; UnknownDBException - no such database; UnknownPartitionException - no such partition; InvalidPartitionException - partition partKVs is invalid

isPartitionMarkedForEvent

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

Determine whether a partition has been marked with a particular event type.

Parameters:: db_name - database name; tbl_name - table name.; partKVs - key value pairs that describe the partition.; eventType - event type
Throws:: MetaException - error access the RDBMS; NoSuchObjectException - never throws this AFAICT; org.apache.thrift.TException - thrift transport error; UnknownTableException - no such table; UnknownDBException - no such database; UnknownPartitionException - no such partition; InvalidPartitionException - partition partKVs is invalid

isPartitionMarkedForEvent

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

Determine whether a partition has been marked with a particular event type.

Parameters:: catName - catalog name; db_name - database name; tbl_name - table name.; partKVs - key value pairs that describe the partition.; eventType - event type
Throws:: MetaException - error access the RDBMS; NoSuchObjectException - never throws this AFAICT; org.apache.thrift.TException - thrift transport error; UnknownTableException - no such table; UnknownDBException - no such database; UnknownPartitionException - no such partition; InvalidPartitionException - partition partKVs is invalid

validatePartitionNameCharacters

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

Parameters:: partVals -
Throws:: org.apache.thrift.TException; MetaException

getTranslateTableDryrun

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

Dry run that translates table * * @param tbl * a table object * @throws HiveException

Throws:: AlreadyExistsException; InvalidObjectException; MetaException; NoSuchObjectException; org.apache.thrift.TException

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

createTable

void createTable(CreateTableRequest request)
          throws AlreadyExistsException,
                 InvalidObjectException,
                 MetaException,
                 NoSuchObjectException,
                 org.apache.thrift.TException

Parameters:: request - CreateTableRequest
Throws:: AlreadyExistsException; InvalidObjectException; MetaException; NoSuchObjectException; org.apache.thrift.TException

alter_table
```
void alter_table(String databaseName,
                 String tblName,
                 Table table)
          throws InvalidOperationException,
                 MetaException,
                 org.apache.thrift.TException
```
Alter a table

Parameters:

databaseName - database name

tblName - table name

table - new table object, should be complete representation of the table, not just the things you want to change.

Throws:

InvalidOperationException - something is wrong with the new table object or an operation was attempted that is not allowed (such as changing partition columns).

MetaException - something went wrong, usually in the RDBMS

org.apache.thrift.TException - general thrift exception

alter_table
```
default void alter_table(String catName,
                         String dbName,
                         String tblName,
                         Table newTable)
                  throws InvalidOperationException,
                         MetaException,
                         org.apache.thrift.TException
```
Alter a table. Equivalent to alter_table(String, String, String, Table, EnvironmentContext) with EnvironmentContext set to null.

Parameters:

catName - catalog name.

dbName - database name.

tblName - table name.

newTable - new table object, should be complete representation of the table, not just the things you want to change.

Throws:

InvalidOperationException - something is wrong with the new table object or an operation was attempted that is not allowed (such as changing partition columns).

MetaException - something went wrong, usually in the RDBMS

org.apache.thrift.TException - general thrift exception

alter_table
```
void alter_table(String catName,
                 String dbName,
                 String tblName,
                 Table newTable,
                 EnvironmentContext envContext)
          throws InvalidOperationException,
                 MetaException,
                 org.apache.thrift.TException
```
Alter a table.

Parameters:

catName - catalog name.

dbName - database name.

tblName - table name.

newTable - new table object, should be complete representation of the table, not just the things you want to change.

envContext - options for the alter.

Throws:

InvalidOperationException - something is wrong with the new table object or an operation was attempted that is not allowed (such as changing partition columns).

MetaException - something went wrong, usually in the RDBMS

org.apache.thrift.TException - general thrift exception

alter_table

@Deprecated
void alter_table(String defaultDatabaseName,
                             String tblName,
                             Table table,
                             boolean cascade)
                      throws InvalidOperationException,
                             MetaException,
                             org.apache.thrift.TException

Deprecated. Use alter_table_with_environmentContext instead of alter_table with cascade option passed in EnvironmentContext using StatsSetupConst.CASCADE

Throws:: InvalidOperationException; MetaException; org.apache.thrift.TException

alter_table_with_environmentContext

@Deprecated
void alter_table_with_environmentContext(String databaseName,
                                                     String tblName,
                                                     Table table,
                                                     EnvironmentContext environmentContext)
                                              throws InvalidOperationException,
                                                     MetaException,
                                                     org.apache.thrift.TException

Deprecated.

Alter a table.

Parameters:: databaseName - database name; tblName - table name; table - new table object, should be complete representation of the table, not just the things you want to change.; environmentContext - options for the alter.
Throws:: InvalidOperationException - something is wrong with the new table object or an operation was attempted that is not allowed (such as changing partition columns).; MetaException - something went wrong, usually in the RDBMS; org.apache.thrift.TException - general thrift exception

alter_table

void alter_table(String catName,
                 String databaseName,
                 String tblName,
                 Table table,
                 EnvironmentContext environmentContext,
                 String validWriteIdList)
          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
```
Create a new database.

Parameters:

db - database object. If the catalog name is null it will be assumed to be Warehouse.DEFAULT_CATALOG_NAME.

Throws:

InvalidObjectException - There is something wrong with the database object.

AlreadyExistsException - There is already a database of this name in the specified catalog.

MetaException - something went wrong, usually in the RDBMS

org.apache.thrift.TException - general thrift error

dropDatabase
```
void dropDatabase(String name)
           throws NoSuchObjectException,
                  InvalidOperationException,
                  MetaException,
                  org.apache.thrift.TException
```
Drop a database.

Parameters:

name - name of the database to drop.

Throws:

NoSuchObjectException - No such database exists.

InvalidOperationException - The database cannot be dropped because it is not empty.

MetaException - something went wrong, usually either in the RDMBS or in storage.

org.apache.thrift.TException - general thrift error.

dropDatabase
```
void dropDatabase(String name,
                  boolean deleteData,
                  boolean ignoreUnknownDb)
           throws NoSuchObjectException,
                  InvalidOperationException,
                  MetaException,
                  org.apache.thrift.TException
```
Drop a database.

Parameters:

name - name of the database to drop.

deleteData - whether to drop the underlying HDFS directory.

ignoreUnknownDb - whether to ignore an attempt to drop a non-existant database

Throws:

NoSuchObjectException - No database of this name exists in the specified catalog and ignoreUnknownDb is false.

InvalidOperationException - The database cannot be dropped because it is not empty.

MetaException - something went wrong, usually either in the RDMBS or in storage.

org.apache.thrift.TException - general thrift error.

dropDatabase
```
void dropDatabase(String name,
                  boolean deleteData,
                  boolean ignoreUnknownDb,
                  boolean cascade)
           throws NoSuchObjectException,
                  InvalidOperationException,
                  MetaException,
                  org.apache.thrift.TException
```
Drop a database.

Parameters:

name - database name.

deleteData - whether to drop the underlying HDFS directory.

ignoreUnknownDb - whether to ignore an attempt to drop a non-existant database

cascade - whether to drop contained tables, etc. If this is false and there are objects still in the database the drop will fail.

Throws:

NoSuchObjectException - No database of this name exists in the specified catalog and ignoreUnknownDb is false.

InvalidOperationException - The database contains objects and cascade is false.

MetaException - something went wrong, usually either in the RDBMS or storage.

org.apache.thrift.TException - general thrift error.

dropDatabase
```
@Deprecated
default void dropDatabase(String catName,
                                      String dbName,
                                      boolean deleteData,
                                      boolean ignoreUnknownDb,
                                      boolean cascade)
                               throws NoSuchObjectException,
                                      InvalidOperationException,
                                      MetaException,
                                      org.apache.thrift.TException
```
Deprecated.

Drop a database.

Parameters:

catName - Catalog name. This can be null, in which case Warehouse.DEFAULT_CATALOG_NAME will be assumed.

dbName - database name.

deleteData - whether to drop the underlying HDFS directory.

ignoreUnknownDb - whether to ignore an attempt to drop a non-existant database

cascade - whether to drop contained tables, etc. If this is false and there are objects still in the database the drop will fail.

Throws:

NoSuchObjectException - No database of this name exists in the specified catalog and ignoreUnknownDb is false.

InvalidOperationException - The database contains objects and cascade is false.

MetaException - something went wrong, usually either in the RDBMS or storage.

org.apache.thrift.TException - general thrift error.

dropDatabase

void dropDatabase(DropDatabaseRequest req)
           throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

dropDatabase
```
@Deprecated
default void dropDatabase(String catName,
                                      String dbName,
                                      boolean deleteData,
                                      boolean ignoreUnknownDb)
                               throws NoSuchObjectException,
                                      InvalidOperationException,
                                      MetaException,
                                      org.apache.thrift.TException
```
Deprecated.

Drop a database. Equivalent to dropDatabase(String, String, boolean, boolean, boolean) with cascade = false.

Parameters:

catName - Catalog name. This can be null, in which case Warehouse.DEFAULT_CATALOG_NAME will be assumed.

dbName - database name.

deleteData - whether to drop the underlying HDFS directory.

ignoreUnknownDb - whether to ignore an attempt to drop a non-existant database

Throws:

NoSuchObjectException - No database of this name exists in the specified catalog and ignoreUnknownDb is false.

InvalidOperationException - The database contains objects and cascade is false.

MetaException - something went wrong, usually either in the RDBMS or storage.

org.apache.thrift.TException - general thrift error.

dropDatabase
```
default void dropDatabase(String catName,
                          String dbName)
                   throws NoSuchObjectException,
                          InvalidOperationException,
                          MetaException,
                          org.apache.thrift.TException
```
Drop a database. Equivalent to dropDatabase(String, String, boolean, boolean, boolean) with deleteData = true, ignoreUnknownDb = false, cascade = false.

Parameters:

catName - Catalog name. This can be null, in which case Warehouse.DEFAULT_CATALOG_NAME will be assumed.

dbName - database name.

Throws:

NoSuchObjectException - No database of this name exists in the specified catalog and ignoreUnknownDb is false.

InvalidOperationException - The database contains objects and cascade is false.

MetaException - something went wrong, usually either in the RDBMS or storage.

org.apache.thrift.TException - general thrift error.

alterDatabase
```
void alterDatabase(String name,
                   Database db)
            throws NoSuchObjectException,
                   MetaException,
                   org.apache.thrift.TException
```
Alter a database.

Parameters:

name - database name.

db - new database object.

Throws:

NoSuchObjectException - No database of this name exists in the specified catalog.

MetaException - something went wrong, usually in the RDBMS.

org.apache.thrift.TException - general thrift error.

alterDatabase
```
void alterDatabase(String catName,
                   String dbName,
                   Database newDb)
            throws NoSuchObjectException,
                   MetaException,
                   org.apache.thrift.TException
```
Alter a database.

Parameters:

catName - Catalog name. This can be null, in which case Warehouse.DEFAULT_CATALOG_NAME will be assumed.

dbName - database name.

newDb - new database object.

Throws:

NoSuchObjectException - No database of this name exists in the specified catalog.

MetaException - something went wrong, usually in the RDBMS.

org.apache.thrift.TException - general thrift error.

createDataConnector
```
void createDataConnector(DataConnector connector)
                  throws InvalidObjectException,
                         AlreadyExistsException,
                         MetaException,
                         org.apache.thrift.TException
```
Create a new dataconnector.

Parameters:

connector - object.

Throws:

InvalidObjectException - There is something wrong with the dataconnector object.

AlreadyExistsException - There is already a dataconnector with this name.

MetaException - something went wrong, usually in the RDBMS

org.apache.thrift.TException - general thrift error

dropDataConnector
```
void dropDataConnector(String name,
                       boolean ifNotExists,
                       boolean checkReferences)
                throws NoSuchObjectException,
                       InvalidOperationException,
                       MetaException,
                       org.apache.thrift.TException
```
Drop a dataconnector.

Parameters:

name - name of the dataconnector to drop.

ifNotExists - if specified, drop will not throw an exception if the connector does not exist.

checkReferences - drop only if there are no dbs referencing this connector.

Throws:

NoSuchObjectException - No such dataconnector exists.

InvalidOperationException - The dataconnector cannot be dropped because it is not allowed.

MetaException - something went wrong, usually either in the RDMBS or in storage.

org.apache.thrift.TException - general thrift error.

alterDataConnector
```
void alterDataConnector(String name,
                        DataConnector connector)
                 throws NoSuchObjectException,
                        MetaException,
                        org.apache.thrift.TException
```
Alter a dataconnector.

Parameters:

name - dataconnector name.

connector - new dataconnector object.

Throws:

NoSuchObjectException - No dataconnector with this name exists.

MetaException - Operation could not be completed, usually in the RDBMS.

org.apache.thrift.TException - thrift transport layer error.

getDataConnector
```
DataConnector getDataConnector(String name)
                        throws MetaException,
                               org.apache.thrift.TException
```
Get the dataconnector by name

Returns:

DataConnector if there is a match

Throws:

MetaException - error complete the operation

org.apache.thrift.TException - thrift transport error

getAllDataConnectorNames
```
List<String> getAllDataConnectorNames()
                               throws MetaException,
                                      org.apache.thrift.TException
```
Get the names of all dataconnectors in the MetaStore.

Returns:

List of dataconnector names.

Throws:

MetaException - error accessing RDBMS.

org.apache.thrift.TException - thrift transport error

dropPartition
```
boolean dropPartition(String db_name,
                      String tbl_name,
                      List<String> part_vals,
                      boolean deleteData)
               throws NoSuchObjectException,
                      MetaException,
                      org.apache.thrift.TException
```
Drop a partition.

Parameters:

db_name - database name

tbl_name - table name

part_vals - partition values, in the same order as the partition keys

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

Returns:

true or false

Throws:

NoSuchObjectException - partition does not exist

MetaException - error accessing the RDBMS or the storage.

org.apache.thrift.TException - thrift transport error

dropPartition

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

Drop a partition.

Parameters:: catName - catalog name.; db_name - database name; tbl_name - table name; part_vals - partition values, in the same order as the partition keys; deleteData - delete the underlying data or just delete the partition in metadata
Returns:: true or false
Throws:: NoSuchObjectException - partition does not exist; MetaException - error accessing the RDBMS or the storage.; org.apache.thrift.TException - thrift transport error

dropPartition
```
boolean dropPartition(String db_name,
                      String tbl_name,
                      List<String> part_vals,
                      PartitionDropOptions options)
               throws NoSuchObjectException,
                      MetaException,
                      org.apache.thrift.TException
```
Drop a partition with the option to purge the partition data directly, rather than to move data to trash.

Parameters:

db_name - Name of the database.

tbl_name - Name of the table.

part_vals - Specification of the partitions being dropped.

options - PartitionDropOptions for the operation.

Returns:

True (if partitions are dropped), else false.

Throws:

NoSuchObjectException - partition does not exist

MetaException - error accessing the RDBMS or the storage.

org.apache.thrift.TException - thrift transport error.

dropPartition
```
boolean dropPartition(String catName,
                      String db_name,
                      String tbl_name,
                      List<String> part_vals,
                      PartitionDropOptions options)
               throws NoSuchObjectException,
                      MetaException,
                      org.apache.thrift.TException
```
Drop a partition with the option to purge the partition data directly, rather than to move data to trash.

Parameters:

catName - catalog name.

db_name - Name of the database.

tbl_name - Name of the table.

part_vals - Specification of the partitions being dropped.

options - PartitionDropOptions for the operation.

Returns:

True (if partitions are dropped), else false.

Throws:

NoSuchObjectException - partition does not exist

MetaException - error accessing the RDBMS or the storage.

org.apache.thrift.TException - thrift transport error.

dropPartitions
```
List<Partition> dropPartitions(String dbName,
                               String tblName,
                               List<org.apache.commons.lang3.tuple.Pair<Integer,byte[]>> partExprs,
                               boolean deleteData,
                               boolean ifExists)
                        throws NoSuchObjectException,
                               MetaException,
                               org.apache.thrift.TException
```
Drop partitions based on an expression.

Parameters:

dbName - database name.

tblName - table name.

partExprs - I don't understand this fully, so can't completely explain it. The second half of the object pair is an expression used to determine which partitions to drop. The first half has something to do with archive level, but I don't understand what. I'm also not sure what happens if you pass multiple expressions.

deleteData - whether to delete the data as well as the metadata.

ifExists - if true, it is not an error if no partitions match the expression(s).

Returns:

list of deleted partitions.

Throws:

NoSuchObjectException - No partition matches the expression(s), and ifExists was false.

MetaException - error access the RDBMS or storage.

org.apache.thrift.TException - Thrift transport error.

dropPartitions
```
default List<Partition> dropPartitions(String catName,
                                       String dbName,
                                       String tblName,
                                       List<org.apache.commons.lang3.tuple.Pair<Integer,byte[]>> partExprs,
                                       boolean deleteData,
                                       boolean ifExists)
                                throws NoSuchObjectException,
                                       MetaException,
                                       org.apache.thrift.TException
```
Drop partitions based on an expression.

Parameters:

catName - catalog name.

dbName - database name.

tblName - table name.

partExprs - I don't understand this fully, so can't completely explain it. The second half of the object pair is an expression used to determine which partitions to drop. The first half has something to do with archive level, but I don't understand what. I'm also not sure what happens if you pass multiple expressions.

deleteData - whether to delete the data as well as the metadata.

ifExists - if true, it is not an error if no partitions match the expression(s).

Returns:

list of deleted partitions.

Throws:

NoSuchObjectException - No partition matches the expression(s), and ifExists was false.

MetaException - error access the RDBMS or storage.

org.apache.thrift.TException - Thrift transport error.

dropPartitions
```
@Deprecated
List<Partition> dropPartitions(String dbName,
                                           String tblName,
                                           List<org.apache.commons.lang3.tuple.Pair<Integer,byte[]>> partExprs,
                                           boolean deleteData,
                                           boolean ifExists,
                                           boolean needResults)
                                    throws NoSuchObjectException,
                                           MetaException,
                                           org.apache.thrift.TException
```
Deprecated. Use dropPartitions(String, String, String, List, boolean, boolean, boolean)

Drop partitions based on an expression.

Parameters:

dbName - database name.

tblName - table name.

partExprs - I don't understand this fully, so can't completely explain it. The second half of the object pair is an expression used to determine which partitions to drop. The first half has something to do with archive level, but I don't understand what. I'm also not sure what happens if you pass multiple expressions.

deleteData - whether to delete the data as well as the metadata.

ifExists - if true, it is not an error if no partitions match the expression(s).

needResults - if true, the list of deleted partitions will be returned, if not, null will be returned.

Returns:

list of deleted partitions.

Throws:

NoSuchObjectException - No partition matches the expression(s), and ifExists was false.

MetaException - error access the RDBMS or storage.

org.apache.thrift.TException - Thrift transport error.

dropPartitions
```
default List<Partition> dropPartitions(String catName,
                                       String dbName,
                                       String tblName,
                                       List<org.apache.commons.lang3.tuple.Pair<Integer,byte[]>> partExprs,
                                       boolean deleteData,
                                       boolean ifExists,
                                       boolean needResults)
                                throws NoSuchObjectException,
                                       MetaException,
                                       org.apache.thrift.TException
```
Drop partitions based on an expression.

Parameters:

catName - catalog name.

dbName - database name.

tblName - table name.

partExprs - I don't understand this fully, so can't completely explain it. The second half of the object pair is an expression used to determine which partitions to drop. The first half has something to do with archive level, but I don't understand what. I'm also not sure what happens if you pass multiple expressions.

deleteData - whether to delete the data as well as the metadata.

ifExists - if true, it is not an error if no partitions match the expression(s).

needResults - if true, the list of deleted partitions will be returned, if not, null will be returned.

Returns:

list of deleted partitions, if needResults is true

Throws:

NoSuchObjectException - No partition matches the expression(s), and ifExists was false.

MetaException - error access the RDBMS or storage.

org.apache.thrift.TException - Thrift transport error.

dropPartitions

List<Partition> dropPartitions(String dbName,
                               String tblName,
                               List<org.apache.commons.lang3.tuple.Pair<Integer,byte[]>> partExprs,
                               PartitionDropOptions options)
                        throws NoSuchObjectException,
                               MetaException,
                               org.apache.thrift.TException

Generalization of dropPartitions(),

Parameters:: dbName - Name of the database; tblName - Name of the table; partExprs - Partition-specification; options - Boolean options for dropping partitions
Returns:: List of Partitions dropped
Throws:: NoSuchObjectException - No partition matches the expression(s), and ifExists was false.; MetaException - error access the RDBMS or storage.; org.apache.thrift.TException - On failure

dropPartitions

List<Partition> dropPartitions(String catName,
                               String dbName,
                               String tblName,
                               List<org.apache.commons.lang3.tuple.Pair<Integer,byte[]>> partExprs,
                               PartitionDropOptions options)
                        throws NoSuchObjectException,
                               MetaException,
                               org.apache.thrift.TException

Generalization of dropPartitions(),

Parameters:: catName - catalog name; dbName - Name of the database; tblName - Name of the table; partExprs - Partition-specification; options - Boolean options for dropping partitions
Returns:: List of Partitions dropped
Throws:: NoSuchObjectException - No partition matches the expression(s), and ifExists was false.; MetaException - error access the RDBMS or storage.; org.apache.thrift.TException - On failure

dropPartition

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

Drop a partition.

Parameters:: db_name - database name.; tbl_name - table name.; name - partition name.; deleteData - whether to delete the data or just the metadata.
Returns:: true if the partition was dropped.
Throws:: NoSuchObjectException - no such partition.; MetaException - error accessing the RDBMS or storage; org.apache.thrift.TException - thrift transport error

dropPartition

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

Drop a partition.

Parameters:: catName - catalog name.; db_name - database name.; tbl_name - table name.; name - partition name.; deleteData - whether to delete the data or just the metadata.
Returns:: true if the partition was dropped.
Throws:: NoSuchObjectException - no such partition.; MetaException - error accessing the RDBMS or storage; org.apache.thrift.TException - thrift transport error

alter_partition
```
void alter_partition(String dbName,
                     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_partition

@Deprecated
default void alter_partition(String catName,
                                         String dbName,
                                         String tblName,
                                         Partition newPart)
                                  throws InvalidOperationException,
                                         MetaException,
                                         org.apache.thrift.TException

Deprecated.

updates a partition to new partition

Parameters:: catName - catalog name; 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_partition

@Deprecated
void alter_partition(String dbName,
                                 String tblName,
                                 Partition newPart,
                                 EnvironmentContext environmentContext)
                          throws InvalidOperationException,
                                 MetaException,
                                 org.apache.thrift.TException

Deprecated.

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_partition

void alter_partition(String catName,
                     String dbName,
                     String tblName,
                     Partition newPart,
                     EnvironmentContext environmentContext,
                     String writeIdList)
              throws InvalidOperationException,
                     MetaException,
                     org.apache.thrift.TException

Throws:: InvalidOperationException; MetaException; org.apache.thrift.TException

alter_partition

void alter_partition(String catName,
                     String dbName,
                     String tblName,
                     Partition newPart,
                     EnvironmentContext environmentContext)
              throws InvalidOperationException,
                     MetaException,
                     org.apache.thrift.TException

updates a partition to new partition

Parameters:: catName - catalog name.; 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

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

Deprecated.

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

alter_partitions

@Deprecated
void alter_partitions(String dbName,
                                  String tblName,
                                  List<Partition> newParts,
                                  EnvironmentContext environmentContext)
                           throws InvalidOperationException,
                                  MetaException,
                                  org.apache.thrift.TException

Deprecated.

updates a list of partitions

Parameters:: dbName - database of the old partition; tblName - table name of the old partition; newParts - list of partitions; environmentContext - key value pairs to pass to alter function.
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(String dbName,
                      String tblName,
                      List<Partition> newParts,
                      EnvironmentContext environmentContext,
                      String writeIdList,
                      long writeId)
               throws InvalidOperationException,
                      MetaException,
                      org.apache.thrift.TException

Throws:: InvalidOperationException; MetaException; org.apache.thrift.TException

alter_partitions

@Deprecated
default void alter_partitions(String catName,
                                          String dbName,
                                          String tblName,
                                          List<Partition> newParts)
                                   throws InvalidOperationException,
                                          MetaException,
                                          org.apache.thrift.TException

Deprecated.

updates a list of partitions

Parameters:: catName - catalog name.; 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

alter_partitions

void alter_partitions(String catName,
                      String dbName,
                      String tblName,
                      List<Partition> newParts,
                      EnvironmentContext environmentContext,
                      String writeIdList,
                      long writeId)
               throws InvalidOperationException,
                      MetaException,
                      org.apache.thrift.TException

updates a list of partitions

Parameters:: catName - catalog name.; dbName - database of the old partition; tblName - table name of the old partition; newParts - list of partitions; environmentContext - key value pairs to pass to alter function.
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

@Deprecated
void renamePartition(String dbname,
                                 String tableName,
                                 List<String> part_vals,
                                 Partition newPart)
                          throws InvalidOperationException,
                                 MetaException,
                                 org.apache.thrift.TException

Deprecated.

rename a partition to a new partition

Parameters:: dbname - database of the old partition; tableName - table name of the old partition; part_vals - values of the old partition; newPart - new partition
Throws:: InvalidOperationException - if srcFs and destFs are different, or trying to rename to an already existing partition name; MetaException - if error in updating metadata; org.apache.thrift.TException - if error in communicating with metastore server

renamePartition

default void renamePartition(String catName,
                             String dbname,
                             String tableName,
                             List<String> part_vals,
                             Partition newPart,
                             String validWriteIds)
                      throws org.apache.thrift.TException

rename a partition to a new partition

Parameters:: catName - catalog name.; dbname - database of the old partition; tableName - table name of the old partition; part_vals - values of the old partition; newPart - new partition
Throws:: InvalidOperationException - if srcFs and destFs are different, or trying to rename to an already existing partition name; MetaException - if error in updating metadata; org.apache.thrift.TException - if error in communicating with metastore server

renamePartition

void renamePartition(String catName,
                     String dbname,
                     String tableName,
                     List<String> part_vals,
                     Partition newPart,
                     String validWriteIds,
                     long txnId,
                     boolean makeCopy)
              throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

getFields

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

Get schema for a table, excluding the partition columns.

Parameters:: db - database name; tableName - table name
Returns:: list of field schemas describing the table's schema
Throws:: UnknownTableException - no such table; UnknownDBException - no such database; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

getFields

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

Get schema for a table, excluding the partition columns.

Parameters:: catName - catalog name; db - database name; tableName - table name
Returns:: list of field schemas describing the table's schema
Throws:: UnknownTableException - no such table; UnknownDBException - no such database; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

getFieldsRequest

GetFieldsResponse getFieldsRequest(GetFieldsRequest req)
                            throws MetaException,
                                   org.apache.thrift.TException,
                                   UnknownTableException,
                                   UnknownDBException

Get schema for a table, excluding the partition columns.

Parameters:: req -
Returns:: GetFieldsResponse
Throws:: UnknownTableException - no such table; UnknownDBException - no such database; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

getSchema

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

Get schema for a table, including the partition columns.

Parameters:: db - database name; tableName - table name
Returns:: list of field schemas describing the table's schema
Throws:: UnknownTableException - no such table; UnknownDBException - no such database; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

getSchema

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

Get schema for a table, including the partition columns.

Parameters:: catName - catalog name; db - database name; tableName - table name
Returns:: list of field schemas describing the table's schema
Throws:: UnknownTableException - no such table; UnknownDBException - no such database; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

getSchemaRequest

GetSchemaResponse getSchemaRequest(GetSchemaRequest req)
                            throws MetaException,
                                   org.apache.thrift.TException,
                                   UnknownTableException,
                                   UnknownDBException

Get schema for a table, including the partition columns.

Parameters:: req -
Returns:: GetSchemaResponse
Throws:: UnknownTableException - no such table; UnknownDBException - no such database; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

getConfigValue
```
String getConfigValue(String name,
                      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
```
List<String> partitionNameToVals(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
```
Map<String,String> partitionNameToSpec(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

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

List<ColumnStatisticsObj> getTableColumnStatistics(String dbName,
                                                   String tableName,
                                                   List<String> colNames,
                                                   String engine)
                                            throws NoSuchObjectException,
                                                   MetaException,
                                                   org.apache.thrift.TException

Get the column statistics for a set of columns in a table. This should only be used for non-partitioned tables. For partitioned tables use getPartitionColumnStatistics(String, String, List, List, String).

Parameters:: dbName - database name; tableName - table name; colNames - list of column names; engine - engine sending the request
Returns:: list of column statistics objects, one per column
Throws:: NoSuchObjectException - no such table; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

getTableColumnStatistics

List<ColumnStatisticsObj> getTableColumnStatistics(String dbName,
                                                   String tableName,
                                                   List<String> colNames,
                                                   String engine,
                                                   String validWriteIdList)
                                            throws NoSuchObjectException,
                                                   MetaException,
                                                   org.apache.thrift.TException

Throws:: NoSuchObjectException; MetaException; org.apache.thrift.TException

getTableColumnStatistics

List<ColumnStatisticsObj> getTableColumnStatistics(String catName,
                                                   String dbName,
                                                   String tableName,
                                                   List<String> colNames,
                                                   String engine)
                                            throws NoSuchObjectException,
                                                   MetaException,
                                                   org.apache.thrift.TException

Parameters:: catName - catalog name; dbName - database name; tableName - table name; colNames - list of column names; engine - engine sending the request
Returns:: list of column statistics objects, one per column
Throws:: NoSuchObjectException - no such table; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

getTableColumnStatistics

List<ColumnStatisticsObj> getTableColumnStatistics(String catName,
                                                   String dbName,
                                                   String tableName,
                                                   List<String> colNames,
                                                   String engine,
                                                   String validWriteIdList)
                                            throws NoSuchObjectException,
                                                   MetaException,
                                                   org.apache.thrift.TException

Throws:: NoSuchObjectException; MetaException; org.apache.thrift.TException

getPartitionColumnStatistics

Map<String,List<ColumnStatisticsObj>> getPartitionColumnStatistics(String dbName,
                                                                   String tableName,
                                                                   List<String> partNames,
                                                                   List<String> colNames,
                                                                   String engine)
                                                            throws NoSuchObjectException,
                                                                   MetaException,
                                                                   org.apache.thrift.TException

Get the column statistics for a set of columns in a partition.

Parameters:: dbName - database name; tableName - table name; partNames - partition names. Since these are names they should be of the form "key1=value1[/key2=value2...]"; colNames - list of column names; engine - engine sending the request
Returns:: map of columns to statistics
Throws:: NoSuchObjectException - no such partition; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

getPartitionColumnStatistics

Map<String,List<ColumnStatisticsObj>> getPartitionColumnStatistics(String dbName,
                                                                   String tableName,
                                                                   List<String> partNames,
                                                                   List<String> colNames,
                                                                   String engine,
                                                                   String validWriteIdList)
                                                            throws NoSuchObjectException,
                                                                   MetaException,
                                                                   org.apache.thrift.TException

Throws:: NoSuchObjectException; MetaException; org.apache.thrift.TException

getPartitionColumnStatistics

Map<String,List<ColumnStatisticsObj>> getPartitionColumnStatistics(String catName,
                                                                   String dbName,
                                                                   String tableName,
                                                                   List<String> partNames,
                                                                   List<String> colNames,
                                                                   String engine)
                                                            throws NoSuchObjectException,
                                                                   MetaException,
                                                                   org.apache.thrift.TException

Get the column statistics for a set of columns in a partition.

Parameters:: catName - catalog name; dbName - database name; tableName - table name; partNames - partition names. Since these are names they should be of the form "key1=value1[/key2=value2...]"; colNames - list of column names; engine - engine sending the request
Returns:: map of columns to statistics
Throws:: NoSuchObjectException - no such partition; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

getPartitionColumnStatistics

Map<String,List<ColumnStatisticsObj>> getPartitionColumnStatistics(String catName,
                                                                   String dbName,
                                                                   String tableName,
                                                                   List<String> partNames,
                                                                   List<String> colNames,
                                                                   String engine,
                                                                   String validWriteIdList)
                                                            throws NoSuchObjectException,
                                                                   MetaException,
                                                                   org.apache.thrift.TException

Throws:: NoSuchObjectException; MetaException; org.apache.thrift.TException

deletePartitionColumnStatistics

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

Delete partition level column statistics given dbName, tableName, partName and colName, or all columns in a partition.

Parameters:: dbName - database name.; tableName - table name.; partName - partition name.; colName - column name, or null for all columns; engine - engine, or null for all engines
Returns:: boolean indicating outcome of the operation
Throws:: NoSuchObjectException - no such partition exists; InvalidObjectException - error dropping the stats data; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error; InvalidInputException - input is invalid or null.

deletePartitionColumnStatistics

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

Delete partition level column statistics given dbName, tableName, partName and colName, or all columns in a partition.

Parameters:: catName - catalog name.; dbName - database name.; tableName - table name.; partName - partition name.; colName - column name, or null for all columns; engine - engine, or null for all engines
Returns:: boolean indicating outcome of the operation
Throws:: NoSuchObjectException - no such partition exists; InvalidObjectException - error dropping the stats data; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error; InvalidInputException - input is invalid or null.

deleteTableColumnStatistics

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

Delete table level column statistics given dbName, tableName and colName, or all columns in a table. This should be used for non-partitioned tables.

Parameters:: dbName - database name; tableName - table name; colName - column name, or null to drop stats for all columns; engine - engine, or null for all engines
Returns:: boolean indicating the outcome of the operation
Throws:: NoSuchObjectException - No such table; MetaException - error accessing the RDBMS; InvalidObjectException - error dropping the stats; org.apache.thrift.TException - thrift transport error; InvalidInputException - bad input, like a null table name.

deleteTableColumnStatistics

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

Delete table level column statistics given dbName, tableName and colName, or all columns in a table. This should be used for non-partitioned tables.

Parameters:: catName - catalog name; dbName - database name; tableName - table name; colName - column name, or null to drop stats for all columns; engine - engine, or null for all engines
Returns:: boolean indicating the outcome of the operation
Throws:: NoSuchObjectException - No such table; MetaException - error accessing the RDBMS; InvalidObjectException - error dropping the stats; org.apache.thrift.TException - thrift transport error; InvalidInputException - bad input, like a null table name.

updateTransactionalStatistics

void updateTransactionalStatistics(UpdateTransactionalStatsRequest req)
                            throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

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(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

List<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(String role_name,
                   String user_name,
                   PrincipalType principalType,
                   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(String role_name,
                    String user_name,
                    PrincipalType principalType,
                    boolean grantOption)
             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

List<Role> list_roles(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,
                                        String user_name,
                                        List<String> group_names)
                                 throws MetaException,
                                        org.apache.thrift.TException

Return the privileges that the user, group have directly and indirectly through roles on the given hiveObject

Parameters:: hiveObject -; user_name -; group_names -
Returns:: the privilege set
Throws:: MetaException; org.apache.thrift.TException

list_privileges

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

Return the privileges that this principal has directly over the object (not through roles).

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,
                          boolean grantOption)
                   throws MetaException,
                          org.apache.thrift.TException

Parameters:: privileges -
Returns:: true on success
Throws:: MetaException; org.apache.thrift.TException

refresh_privileges

boolean refresh_privileges(HiveObjectRef objToRefresh,
                           String authorizer,
                           PrivilegeBag grantPrivileges)
                    throws MetaException,
                           org.apache.thrift.TException

Parameters:: authorizer -; objToRefresh -
Returns:: true on success
Throws:: MetaException; org.apache.thrift.TException

getDelegationToken
```
String getDelegationToken(String owner,
                          String renewerKerberosPrincipalName)
                   throws MetaException,
                          org.apache.thrift.TException
```
This is expected to be a no-op when in local mode, which means that the implementation will return null.

Parameters:

owner - the intended owner for the token

renewerKerberosPrincipalName -

Returns:

the string of the token

Throws:

MetaException

org.apache.thrift.TException

renewDelegationToken

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

Parameters:: tokenStrForm -
Returns:: the new expiration time
Throws:: MetaException; org.apache.thrift.TException

cancelDelegationToken

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

Parameters:: tokenStrForm -
Throws:: MetaException; org.apache.thrift.TException

getTokenStrForm

String getTokenStrForm()
                throws IOException

Throws:: IOException

addToken

boolean addToken(String tokenIdentifier,
                 String delegationToken)
          throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

removeToken

boolean removeToken(String tokenIdentifier)
             throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

getToken

String getToken(String tokenIdentifier)
         throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

getAllTokenIdentifiers

List<String> getAllTokenIdentifiers()
                             throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

addMasterKey

int addMasterKey(String key)
          throws MetaException,
                 org.apache.thrift.TException

Throws:: MetaException; org.apache.thrift.TException

updateMasterKey

void updateMasterKey(Integer seqNo,
                     String key)
              throws NoSuchObjectException,
                     MetaException,
                     org.apache.thrift.TException

Throws:: NoSuchObjectException; MetaException; org.apache.thrift.TException

removeMasterKey

boolean removeMasterKey(Integer keySeq)
                 throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

getMasterKeys

String[] getMasterKeys()
                throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

createFunction
```
void createFunction(Function func)
             throws InvalidObjectException,
                    MetaException,
                    org.apache.thrift.TException
```
Create a new function.

Parameters:

func - function specification

Throws:

InvalidObjectException - the function object is invalid

MetaException - error accessing the RDBMS

org.apache.thrift.TException - thrift transport error

alterFunction
```
void alterFunction(String dbName,
                   String funcName,
                   Function newFunction)
            throws InvalidObjectException,
                   MetaException,
                   org.apache.thrift.TException
```
Alter a function.

Parameters:

dbName - database name.

funcName - function name.

newFunction - new function specification. This should be complete, not just the changes.

Throws:

InvalidObjectException - the function object is invalid

MetaException - error accessing the RDBMS

org.apache.thrift.TException - thrift transport error

alterFunction

void alterFunction(String catName,
                   String dbName,
                   String funcName,
                   Function newFunction)
            throws InvalidObjectException,
                   MetaException,
                   org.apache.thrift.TException

Alter a function.

Parameters:: catName - catalog name.; dbName - database name.; funcName - function name.; newFunction - new function specification. This should be complete, not just the changes.
Throws:: InvalidObjectException - the function object is invalid; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

dropFunction

void dropFunction(String dbName,
                  String funcName)
           throws MetaException,
                  NoSuchObjectException,
                  InvalidObjectException,
                  InvalidInputException,
                  org.apache.thrift.TException

Drop a function.

Parameters:: dbName - database name.; funcName - function name.
Throws:: MetaException - error accessing the RDBMS; NoSuchObjectException - no such function; InvalidObjectException - not sure when this is thrown; InvalidInputException - not sure when this is thrown; org.apache.thrift.TException - thrift transport error

dropFunction

void dropFunction(String catName,
                  String dbName,
                  String funcName)
           throws MetaException,
                  NoSuchObjectException,
                  InvalidObjectException,
                  InvalidInputException,
                  org.apache.thrift.TException

Drop a function.

Parameters:: catName - catalog name.; dbName - database name.; funcName - function name.
Throws:: MetaException - error accessing the RDBMS; NoSuchObjectException - no such function; InvalidObjectException - not sure when this is thrown; InvalidInputException - not sure when this is thrown; org.apache.thrift.TException - thrift transport error

getFunction

Function getFunction(String dbName,
                     String funcName)
              throws MetaException,
                     org.apache.thrift.TException

Get a function.

Parameters:: dbName - database name.; funcName - function name.
Throws:: MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

getFunction

Function getFunction(String catName,
                     String dbName,
                     String funcName)
              throws MetaException,
                     org.apache.thrift.TException

Get a function.

Parameters:: catName - catalog name.; dbName - database name.; funcName - function name.
Throws:: MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

getFunctions
```
List<String> getFunctions(String dbName,
                          String pattern)
                   throws MetaException,
                          org.apache.thrift.TException
```
Get all functions matching a pattern

Parameters:

dbName - database name.

pattern - to match. This is a java regex pattern.

Throws:

MetaException - error accessing the RDBMS

org.apache.thrift.TException - thrift transport error

getFunctions

List<String> getFunctions(String catName,
                          String dbName,
                          String pattern)
                   throws MetaException,
                          org.apache.thrift.TException

Get all functions matching a pattern

Parameters:: catName - catalog name.; dbName - database name.; pattern - to match. This is a java regex pattern.
Throws:: MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport error

getAllFunctions
```
GetAllFunctionsResponse getAllFunctions()
                                 throws MetaException,
                                        org.apache.thrift.TException
```
Get all functions in the default catalog.

Returns:

list of functions

Throws:

MetaException - error accessing the RDBMS

org.apache.thrift.TException - thrift transport error

getOpenTxns

GetOpenTxnsResponse getOpenTxns()
                         throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

getValidTxns
```
ValidTxnList getValidTxns()
                   throws org.apache.thrift.TException
```
Get a structure that details valid transactions.

Returns:

list of valid transactions

Throws:

org.apache.thrift.TException

getValidTxns
```
ValidTxnList getValidTxns(long currentTxn)
                   throws org.apache.thrift.TException
```
Get a structure that details valid transactions.

Parameters:

currentTxn - The current transaction of the caller. This will be removed from the exceptions list so that the caller sees records from his own transaction.

Returns:

list of valid transactions and also valid write IDs for each input table.

Throws:

org.apache.thrift.TException

getValidTxns
```
ValidTxnList getValidTxns(long currentTxn,
                          List<TxnType> excludeTxnTypes)
                   throws org.apache.thrift.TException
```
Get a structure that details valid transactions.

Parameters:

currentTxn - The current transaction of the caller. This will be removed from the exceptions list so that the caller sees records from his own transaction.

excludeTxnTypes - list of transaction types that should be excluded from the valid transaction list.

Returns:

list of valid transactions and also valid write IDs for each input table.

Throws:

org.apache.thrift.TException

getValidWriteIds
```
ValidWriteIdList getValidWriteIds(String fullTableName)
                           throws org.apache.thrift.TException
```
Get a structure that details valid write ids.

Parameters:

fullTableName - full table name of format <db_name>.<table_name>

Returns:

list of valid write ids for the given table

Throws:

org.apache.thrift.TException

getValidWriteIds
```
ValidWriteIdList getValidWriteIds(String fullTableName,
                                  Long writeId)
                           throws org.apache.thrift.TException
```
Get a structure that details valid write ids.

Parameters:

fullTableName - full table name of format <db_name>.<table_name>

writeId - The write id to get the corresponding txn

Returns:

list of valid write ids for the given table

Throws:

org.apache.thrift.TException

getValidWriteIds
```
List<TableValidWriteIds> getValidWriteIds(List<String> tablesList,
                                          String validTxnList)
                                   throws org.apache.thrift.TException
```
Get a structure that details valid write ids list for all tables read by current txn.

Parameters:

tablesList - list of tables (format: <db_name>.<table_name>) read from the current transaction for which needs to populate the valid write ids

validTxnList - snapshot of valid txns for the current txn

Returns:

list of valid write ids for the given list of tables.

Throws:

org.apache.thrift.TException

addWriteIdsToMinHistory
```
void addWriteIdsToMinHistory(long txnId,
                             Map<String,Long> writeIds)
                      throws org.apache.thrift.TException
```
Persists minOpenWriteId list to identify obsolete directories eligible for cleanup

Parameters:

txnId - transaction identifier

writeIds - list of minOpenWriteId

Throws:

org.apache.thrift.TException

openTxn
```
long openTxn(String user)
      throws org.apache.thrift.TException
```
Initiate a transaction.

Parameters:

user - User who is opening this transaction. This is the Hive user, not necessarily the OS user. It is assumed that this user has already been authenticated and authorized at this point.

Returns:

transaction identifier

Throws:

org.apache.thrift.TException

openTxn
```
long openTxn(String user,
             TxnType txnType)
      throws org.apache.thrift.TException
```
Initiate a transaction with given type.

Parameters:

user - User who is opening this transaction.

txnType - Type of needed transaction.

Returns:

transaction identifier

Throws:

org.apache.thrift.TException

replOpenTxn
```
List<Long> replOpenTxn(String replPolicy,
                       List<Long> srcTxnIds,
                       String user,
                       TxnType txnType)
                throws org.apache.thrift.TException
```
Initiate a repl replayed or hive replication transaction (dump/load).

Parameters:

replPolicy - Contains replication policy to uniquely identify the source cluster in case of repl replayed txns or database under replication name for hive replication txns

srcTxnIds - The list of transaction ids at the source cluster in case of repl replayed transactions or null in case of hive replication transactions.

user - The user who has fired the command.

txnType - Type of transaction to open: REPL_CREATED for repl replayed transactions DEFAULT for hive replication transactions.

Returns:

transaction identifiers

Throws:

org.apache.thrift.TException

openTxns
```
OpenTxnsResponse openTxns(String user,
                          int numTxns)
                   throws org.apache.thrift.TException
```
Initiate a batch of transactions. It is not guaranteed that the requested number of transactions will be instantiated. The system has a maximum number instantiated per request, controlled by hive.txn.max .batch.open in hive-site.xml. If the user requests more than this value, only the configured max will be returned.
Increasing the number of transactions requested in the batch will allow applications that stream data into Hive to place more commits in a single file, thus reducing load on the namenode and making reads of the data more efficient. However, opening more transactions in a batch will also result in readers needing to keep a larger list of open transactions to ignore, potentially slowing their reads. Users will need to test in their system to understand the optimal number of transactions to request in a batch.

Parameters:

user - User who is opening this transaction. This is the Hive user, not necessarily the OS user. It is assumed that this user has already been authenticated and authorized at this point.

numTxns - number of requested transactions to open

Returns:

list of opened txn ids. As noted above, this may be less than requested, so the user should check how many were returned rather than optimistically assuming that the result matches the request.

Throws:

org.apache.thrift.TException

rollbackTxn
```
void rollbackTxn(long txnid)
          throws NoSuchTxnException,
                 org.apache.thrift.TException
```
Rollback a transaction. This will also unlock any locks associated with this transaction.

Parameters:

txnid - id of transaction to be rolled back.

Throws:

NoSuchTxnException - if the requested transaction does not exist. Note that this can result from the transaction having timed out and been deleted.

org.apache.thrift.TException

rollbackTxn
```
void rollbackTxn(AbortTxnRequest abortTxnRequest)
          throws NoSuchTxnException,
                 org.apache.thrift.TException
```
Rollback a transaction. This will also unlock any locks associated with this transaction.

Parameters:

abortTxnRequest - AbortTxnRequest object containing transaction id and error codes.

Throws:

NoSuchTxnException - if the requested transaction does not exist. Note that this can result from the transaction having timed out and been deleted.

org.apache.thrift.TException

replRollbackTxn
```
void replRollbackTxn(long srcTxnid,
                     String replPolicy,
                     TxnType txnType)
              throws NoSuchTxnException,
                     org.apache.thrift.TException
```
Rollback a transaction. This will also unlock any locks associated with this transaction.

Parameters:

srcTxnid - id of transaction at source while is rolled back and to be replicated or null in case of hive replication transactions

replPolicy - Contains replication policy to uniquely identify the source cluster in case of repl replayed txns or database under replication name for hive replication txns

txnType - Type of transaction to Rollback: REPL_CREATED for repl replayed transactions DEFAULT for hive replication transactions.

Throws:

NoSuchTxnException - if the requested transaction does not exist. Note that this can result from the transaction having timed out and been deleted.

org.apache.thrift.TException

commitTxn
```
void commitTxn(long txnid)
        throws NoSuchTxnException,
               TxnAbortedException,
               org.apache.thrift.TException
```
Commit a transaction. This will also unlock any locks associated with this transaction.

Parameters:

txnid - id of transaction to be committed.

Throws:

NoSuchTxnException - if the requested transaction does not exist. This can result fro the transaction having timed out and been deleted by the compactor.

TxnAbortedException - if the requested transaction has been aborted. This can result from the transaction timing out.

org.apache.thrift.TException

commitTxnWithKeyValue
```
void commitTxnWithKeyValue(long txnid,
                           long tableId,
                           String key,
                           String value)
                    throws NoSuchTxnException,
                           TxnAbortedException,
                           org.apache.thrift.TException
```
Like commitTxn but it will atomically store as well a key and a value. This can be useful for example to know if the transaction corresponding to txnid has been committed by later querying with DESCRIBE EXTENDED TABLE. TABLE_PARAMS from the metastore must already have a row with the TBL_ID corresponding to the table in the parameters and PARAM_KEY the same as key in the parameters. The way to update this table is with an ALTER command to overwrite/create the table properties.

Parameters:

txnid - id of transaction to be committed.

tableId - id of the table to associate the key/value with

key - key to be committed. It must start with "_meta". The reason for this is to prevent important keys being updated, like owner.

value - value to be committed.

Throws:

NoSuchTxnException - if the requested transaction does not exist. This can result fro the transaction having timed out and been deleted by the compactor.

TxnAbortedException - if the requested transaction has been aborted. This can result from the transaction timing out.

IllegalStateException - if not exactly one row corresponding to tableId and key are found in TABLE_PARAMS while updating.

org.apache.thrift.TException

commitTxn
```
void commitTxn(CommitTxnRequest rqst)
        throws NoSuchTxnException,
               TxnAbortedException,
               org.apache.thrift.TException
```
Commit a transaction. This will also unlock any locks associated with this transaction.

Parameters:

rqst - Information containing the txn info and write event information of transaction at source which is committed and to be replicated

Throws:

NoSuchTxnException - if the requested transaction does not exist. This can result fro the transaction having timed out and been deleted by the compactor.

TxnAbortedException - if the requested transaction has been aborted. This can result from the transaction timing out.

org.apache.thrift.TException

abortTxns
```
void abortTxns(List<Long> txnids)
        throws org.apache.thrift.TException
```
Abort a list of transactions. This is for use by "ABORT TRANSACTIONS" in the grammar.

Throws:

org.apache.thrift.TException

abortTxns
```
void abortTxns(AbortTxnsRequest abortTxnsRequest)
        throws org.apache.thrift.TException
```
Abort a list of transactions with additional information of errorcodes as defined in TxnErrorMsg.java.

Parameters:

abortTxnsRequest - Information containing txnIds and error codes

Throws:

org.apache.thrift.TException

allocateTableWriteId
```
long allocateTableWriteId(long txnId,
                          String dbName,
                          String tableName)
                   throws org.apache.thrift.TException
```
Allocate a per table write ID and associate it with the given transaction.

Parameters:

txnId - id of transaction to which the allocated write ID to be associated.

dbName - name of DB in which the table belongs.

tableName - table to which the write ID to be allocated

Throws:

org.apache.thrift.TException

allocateTableWriteId
```
long allocateTableWriteId(long txnId,
                          String dbName,
                          String tableName,
                          boolean reallocate)
                   throws org.apache.thrift.TException
```
Allocate a per table write ID and associate it with the given transaction.

Parameters:

txnId - id of transaction to which the allocated write ID to be associated.

dbName - name of DB in which the table belongs.

tableName - table to which the write ID to be allocated

reallocate - should we reallocate already mapped writeId (if true) or reuse (if false)

Throws:

org.apache.thrift.TException

replTableWriteIdState
```
void replTableWriteIdState(String validWriteIdList,
                           String dbName,
                           String tableName,
                           List<String> partNames)
                    throws org.apache.thrift.TException
```
Replicate Table Write Ids state to mark aborted write ids and writeid high water mark.

Parameters:

validWriteIdList - Snapshot of writeid list when the table/partition is dumped.

dbName - Database name

tableName - Table which is written.

partNames - List of partitions being written.

Throws:

org.apache.thrift.TException - in case of failure to replicate the writeid state

allocateTableWriteIdsBatch

List<TxnToWriteId> allocateTableWriteIdsBatch(List<Long> txnIds,
                                              String dbName,
                                              String tableName)
                                       throws org.apache.thrift.TException

Allocate a per table write ID and associate it with the given transaction.

Parameters:: txnIds - ids of transaction batchto which the allocated write ID to be associated.; dbName - name of DB in which the table belongs.; tableName - table to which the write ID to be allocated
Throws:: org.apache.thrift.TException

replAllocateTableWriteIdsBatch

List<TxnToWriteId> replAllocateTableWriteIdsBatch(String dbName,
                                                  String tableName,
                                                  String replPolicy,
                                                  List<TxnToWriteId> srcTxnToWriteIdList)
                                           throws org.apache.thrift.TException

Allocate a per table write ID and associate it with the given transaction. Used by replication load task.

Parameters:: dbName - name of DB in which the table belongs.; tableName - table to which the write ID to be allocated; replPolicy - Used by replication task to identify the source cluster.; srcTxnToWriteIdList - List of txn to write id map sent from the source cluster.
Throws:: org.apache.thrift.TException

getMaxAllocatedWriteId
```
long getMaxAllocatedWriteId(String dbName,
                            String tableName)
                     throws org.apache.thrift.TException
```
Get the maximum allocated writeId for the given table

Parameters:

dbName - name of DB in which the table belongs.

tableName - table from which the writeId is queried

Returns:

the maximum allocated writeId

Throws:

org.apache.thrift.TException

seedWriteId
```
void seedWriteId(String dbName,
                 String tableName,
                 long seedWriteId)
          throws org.apache.thrift.TException
```
Seed an ACID table with the given writeId. If the table already contains writes it will fail.

Parameters:

dbName - name of DB in which the table belongs.

tableName - table to which the writeId will be set

seedWriteId - the start value of writeId

Throws:

org.apache.thrift.TException

seedTxnId
```
void seedTxnId(long seedTxnId)
        throws org.apache.thrift.TException
```
Seed or increment the global txnId to the given value. If the actual txnId is greater or equal than the seed value, it wil fail

Parameters:

seedTxnId - The seed value for the next transactions

Throws:

org.apache.thrift.TException

showTxns
```
GetOpenTxnsInfoResponse showTxns()
                          throws org.apache.thrift.TException
```
Show the list of currently open transactions. This is for use by "show transactions" in the grammar, not for applications that want to find a list of current transactions to work with. Those wishing the latter should call getValidTxns().

Returns:

List of currently opened transactions, included aborted ones.

Throws:

org.apache.thrift.TException

lock
```
LockResponse lock(LockRequest request)
           throws NoSuchTxnException,
                  TxnAbortedException,
                  org.apache.thrift.TException
```
Request a set of locks. All locks needed for a particular query, DML, or DDL operation should be batched together and requested in one lock call. This avoids deadlocks. It also avoids blocking other users who only require some of the locks required by this user.
If the operation requires a transaction (INSERT, UPDATE, or DELETE) that transaction id must be provided as part this lock request. All locks associated with a transaction will be released when that transaction is committed or rolled back.
*
Once a lock is acquired, heartbeat(long, long) must be called on a regular basis to avoid the lock being timed out by the system.

Parameters:

request - The lock request. LockRequestBuilder can be used construct this request.

Returns:

a lock response, which will provide two things, the id of the lock (to be used in all further calls regarding this lock) as well as a state of the lock. If the state is ACQUIRED then the user can proceed. If it is WAITING the user should wait and call checkLock(long) before proceeding. All components of the lock will have the same state.

Throws:

NoSuchTxnException - if the requested transaction does not exist. This can result fro the transaction having timed out and been deleted by the compactor.

TxnAbortedException - if the requested transaction has been aborted. This can result from the transaction timing out.

org.apache.thrift.TException

checkLock
```
LockResponse checkLock(long lockid)
                throws NoSuchTxnException,
                       TxnAbortedException,
                       NoSuchLockException,
                       org.apache.thrift.TException
```
Check the status of a set of locks requested via a lock(org.apache.hadoop.hive.metastore.api.LockRequest) call. Once a lock is acquired, heartbeat(long, long) must be called on a regular basis to avoid the lock being timed out by the system.

Parameters:

lockid - lock id returned by lock().

Returns:

a lock response, which will provide two things, the id of the lock (to be used in all further calls regarding this lock) as well as a state of the lock. If the state is ACQUIRED then the user can proceed. If it is WAITING the user should wait and call this method again before proceeding. All components of the lock will have the same state.

Throws:

NoSuchTxnException - if the requested transaction does not exist. This can result fro the transaction having timed out and been deleted by the compactor.

TxnAbortedException - if the requested transaction has been aborted. This can result from the transaction timing out.

NoSuchLockException - if the requested lockid does not exist. This can result from the lock timing out and being unlocked by the system.

org.apache.thrift.TException

unlock
```
void unlock(long lockid)
     throws NoSuchLockException,
            TxnOpenException,
            org.apache.thrift.TException
```
Unlock a set of locks. This can only be called when the locks are not associated with a transaction.

Parameters:

lockid - lock id returned by lock(org.apache.hadoop.hive.metastore.api.LockRequest)

Throws:

NoSuchLockException - if the requested lockid does not exist. This can result from the lock timing out and being unlocked by the system.

TxnOpenException - if the locks are are associated with a transaction.

org.apache.thrift.TException

showLocks
```
@Deprecated
ShowLocksResponse showLocks()
                                 throws org.apache.thrift.TException
```
Deprecated.

Show all currently held and waiting locks.

Returns:

List of currently held and waiting locks.

Throws:

org.apache.thrift.TException

showLocks
```
ShowLocksResponse showLocks(ShowLocksRequest showLocksRequest)
                     throws org.apache.thrift.TException
```
Show all currently held and waiting locks.

Parameters:

showLocksRequest - SHOW LOCK request

Returns:

List of currently held and waiting locks.

Throws:

org.apache.thrift.TException

heartbeat
```
void heartbeat(long txnid,
               long lockid)
        throws NoSuchLockException,
               NoSuchTxnException,
               TxnAbortedException,
               org.apache.thrift.TException
```
Send a heartbeat to indicate that the client holding these locks (if any) and that opened this transaction (if one exists) is still alive. The default timeout for transactions and locks is 300 seconds, though it is configurable. To determine how often to heartbeat you will need to ask your system administrator how the metastore thrift service has been configured.

Parameters:

txnid - the id of the open transaction. If no transaction is open (it is a DDL or query) then this can be set to 0.

lockid - the id of the locks obtained. If no locks have been obtained then this can be set to 0.

Throws:

NoSuchTxnException - if the requested transaction does not exist. This can result fro the transaction having timed out and been deleted by the compactor.

TxnAbortedException - if the requested transaction has been aborted. This can result from the transaction timing out.

NoSuchLockException - if the requested lockid does not exist. This can result from the lock timing out and being unlocked by the system.

org.apache.thrift.TException

heartbeatTxnRange
```
HeartbeatTxnRangeResponse heartbeatTxnRange(long min,
                                            long max)
                                     throws org.apache.thrift.TException
```
Send heartbeats for a range of transactions. This is for the streaming ingest client that will have many transactions open at once. Everyone else should use heartbeat(long, long).

Parameters:

min - minimum transaction id to heartbeat, inclusive

max - maximum transaction id to heartbeat, inclusive

Returns:

a pair of lists that tell which transactions in the list did not exist (they may have already been closed) and which were aborted.

Throws:

org.apache.thrift.TException

compact
```
@Deprecated
void compact(String dbname,
                         String tableName,
                         String partitionName,
                         CompactionType type)
                  throws org.apache.thrift.TException
```
Deprecated. use compact2(CompactionRequest)

Send a request to compact a table or partition. This will not block until the compaction is complete. It will instead put a request on the queue for that table or partition to be compacted. No checking is done on the dbname, tableName, or partitionName to make sure they refer to valid objects. It is assumed this has already been done by the caller.

Parameters:

dbname - Name of the database the table is in. If null, this will be assumed to be 'default'.

tableName - Name of the table to be compacted. This cannot be null. If partitionName is null, this must be a non-partitioned table.

partitionName - Name of the partition to be compacted

type - Whether this is a major or minor compaction.

Throws:

org.apache.thrift.TException

compact

@Deprecated
void compact(String dbname,
                         String tableName,
                         String partitionName,
                         CompactionType type,
                         Map<String,String> tblproperties)
                  throws org.apache.thrift.TException

Deprecated. use compact2(CompactionRequest)

Throws:: org.apache.thrift.TException

compact2
```
@Deprecated
CompactionResponse compact2(String dbname,
                                        String tableName,
                                        String partitionName,
                                        CompactionType type,
                                        Map<String,String> tblproperties)
                                 throws org.apache.thrift.TException
```
Deprecated. use compact2(CompactionRequest)

Send a request to compact a table or partition. This will not block until the compaction is complete. It will instead put a request on the queue for that table or partition to be compacted. No checking is done on the dbname, tableName, or partitionName to make sure they refer to valid objects. It is assumed this has already been done by the caller. At most one Compaction can be scheduled/running for any given resource at a time.

Parameters:

dbname - Name of the database the table is in. If null, this will be assumed to be 'default'.

tableName - Name of the table to be compacted. This cannot be null. If partitionName is null, this must be a non-partitioned table.

partitionName - Name of the partition to be compacted

type - Whether this is a major or minor compaction.

tblproperties - the list of tblproperties to override for this compact. Can be null.

Returns:

id of newly scheduled compaction or id/state of one which is already scheduled/running

Throws:

org.apache.thrift.TException

compact2
```
CompactionResponse compact2(CompactionRequest request)
                     throws org.apache.thrift.TException
```
Send a request to compact a table or partition. This will not block until the compaction is complete. It will instead put a request on the queue for that table or partition to be compacted. No checking is done on the dbname, tableName, or partitionName to make sure they refer to valid objects. It is assumed this has already been done by the caller. At most one Compaction can be scheduled/running for any given resource at a time.

Parameters:

request - The CompactionRequest object containing the details required to enqueue a compaction request.

Throws:

org.apache.thrift.TException

showCompactions
```
ShowCompactResponse showCompactions()
                             throws org.apache.thrift.TException
```
Get a list of all compactions.

Returns:

List of all current compactions. This includes compactions waiting to happen, in progress, and finished but waiting to clean the existing files.

Throws:

org.apache.thrift.TException

showCompactions

ShowCompactResponse showCompactions(ShowCompactRequest request)
                             throws org.apache.thrift.TException

Get a list of compactions for the given request object.

Throws:: org.apache.thrift.TException

submitForCleanup
```
boolean submitForCleanup(CompactionRequest rqst,
                         long highestWriteId,
                         long txnId)
                  throws org.apache.thrift.TException
```
Submit a request for performing cleanup of output directory. This is particularly useful for CTAS when the query fails after write and before creation of table.

Parameters:

rqst - Request containing the table directory which needs to be cleaned up.

highestWriteId - The highest write ID that was used while writing the table directory.

txnId - The transaction ID of the query.

Returns:

Status of whether the request was successfully submitted. True indicates the request was successfully submitted and false indicates failure of request submitted.

Throws:

org.apache.thrift.TException

getLatestCommittedCompactionInfo
```
GetLatestCommittedCompactionInfoResponse getLatestCommittedCompactionInfo(GetLatestCommittedCompactionInfoRequest request)
                                                                   throws org.apache.thrift.TException
```
Get one latest record of SUCCEEDED or READY_FOR_CLEANING compaction for a table/partition. No checking is done on the dbname, tablename, or partitionname to make sure they refer to valid objects. Is is assumed to be done by the caller. Note that partition names should be supplied with the request for a partitioned table; otherwise, no records will be returned.

Parameters:

request - info on which compaction to retrieve

Returns:

one latest compaction record for a non partitioned table or one latest record for each partition specified by the request.

Throws:

org.apache.thrift.TException

addDynamicPartitions

@Deprecated
void addDynamicPartitions(long txnId,
                                      long writeId,
                                      String dbName,
                                      String tableName,
                                      List<String> partNames)
                               throws org.apache.thrift.TException

Deprecated. in Hive 1.3.0/2.1.0 - will be removed in 2 releases

Throws:: org.apache.thrift.TException

addDynamicPartitions

void addDynamicPartitions(long txnId,
                          long writeId,
                          String dbName,
                          String tableName,
                          List<String> partNames,
                          DataOperationType operationType)
                   throws org.apache.thrift.TException

Send a list of partitions to the metastore to indicate which partitions were loaded dynamically.

Parameters:: txnId - id of the transaction; writeId - table write id for this txn; dbName - database name; tableName - table name; partNames - partition name, as constructed by Warehouse.makePartName
Throws:: org.apache.thrift.TException

insertTable
```
void insertTable(Table table,
                 boolean overwrite)
          throws MetaException
```
Performs the commit/rollback to the metadata storage for insert operator from external storage handler.

Parameters:

table - table name

overwrite - true if the insert is overwrite

Throws:

MetaException

getLatestTxnIdInConflict
```
long getLatestTxnIdInConflict(long txnId)
                       throws org.apache.thrift.TException
```
Checks if there is a conflicting transaction

Parameters:

txnId -

Returns:

latest txnId in conflict

Throws:

org.apache.thrift.TException

getNextNotification
```
@InterfaceAudience.LimitedPrivate(value="HCatalog")
NotificationEventResponse getNextNotification(long lastEventId,
                                                                                                  int maxEvents,
                                                                                                  IMetaStoreClient.NotificationFilter filter)
                                                                                           throws org.apache.thrift.TException
```
Get the next set of notifications from the database.

Parameters:

lastEventId - The last event id that was consumed by this reader. The returned notifications will start at the next eventId available after this eventId.

maxEvents - Maximum number of events to return. If < 1, then all available events will be returned.

filter - User provided filter to remove unwanted events. If null, all events will be returned.

Returns:

list of notifications, sorted by eventId. It is guaranteed that the events are in the order that the operations were done on the database.

Throws:

org.apache.thrift.TException

getNextNotification
```
@InterfaceAudience.LimitedPrivate(value="HCatalog")
NotificationEventResponse getNextNotification(NotificationEventRequest request,
                                                                                                  boolean allowGapsInEventIds,
                                                                                                  IMetaStoreClient.NotificationFilter filter)
                                                                                           throws org.apache.thrift.TException
```
Get the next set of notifications from the database.

Parameters:

request - The NotificationEventRequest request to be sent to the server to fetch the next set of events.

allowGapsInEventIds - If this flag is true, the returned event ids may contain gaps in the event ids. This could happen if on the server side some of the events since the requested eventId have been garbage collected. If the flag is false, the method will throw MetaException if the returned events from the server are not in sequence from the requested event id.

filter - User provided filter to remove unwanted events. If null, all events will be returned.

Returns:

list of notifications, sorted by eventId. It is guaranteed that the events are in the order that the operations were done on the database.

Throws:

org.apache.thrift.TException

getCurrentNotificationEventId

@InterfaceAudience.LimitedPrivate(value="HCatalog")
CurrentNotificationEventId getCurrentNotificationEventId()
                                                                                                      throws org.apache.thrift.TException

Get the last used notification event id.

Returns:: last used id
Throws:: org.apache.thrift.TException

getNotificationEventsCount

@InterfaceAudience.LimitedPrivate(value="HCatalog")
NotificationEventsCountResponse getNotificationEventsCount(NotificationEventsCountRequest rqst)
                                                                                                        throws org.apache.thrift.TException

Get the number of events from given eventID for the input database.

Returns:: number of events
Throws:: org.apache.thrift.TException

fireListenerEvent
```
@InterfaceAudience.LimitedPrivate(value="Apache Hive, HCatalog")
FireEventResponse fireListenerEvent(FireEventRequest request)
                                                                                              throws org.apache.thrift.TException
```
Request that the metastore fire an event. Currently this is only supported for DML operations, since the metastore knows when DDL operations happen.

Parameters:

request -

Returns:

response, type depends on type of request

Throws:

org.apache.thrift.TException

addWriteNotificationLog

@InterfaceAudience.LimitedPrivate(value="Apache Hive, HCatalog")
void addWriteNotificationLog(WriteNotificationLogRequest rqst)
                                                                                       throws org.apache.thrift.TException

Add a event related to write operations in an ACID table.

Parameters:: rqst - message containing information for acid write operation.
Throws:: org.apache.thrift.TException

addWriteNotificationLogInBatch

@InterfaceAudience.LimitedPrivate(value="Apache Hive, HCatalog")
void addWriteNotificationLogInBatch(WriteNotificationLogBatchRequest rqst)
                                                                                              throws org.apache.thrift.TException

Add a batch of event related to write operations in an ACID table.

Parameters:: rqst - message containing information for acid write operations.
Throws:: org.apache.thrift.TException

get_principals_in_role
```
GetPrincipalsInRoleResponse get_principals_in_role(GetPrincipalsInRoleRequest getPrincRoleReq)
                                            throws MetaException,
                                                   org.apache.thrift.TException
```
get all role-grants for users/roles that have been granted the given role Note that in the returned list of RolePrincipalGrants, the roleName is redundant as it would match the role_name argument of this function

Parameters:

getPrincRoleReq -

Returns:

Throws:

MetaException

org.apache.thrift.TException

get_role_grants_for_principal
```
GetRoleGrantsForPrincipalResponse get_role_grants_for_principal(GetRoleGrantsForPrincipalRequest getRolePrincReq)
                                                         throws MetaException,
                                                                org.apache.thrift.TException
```
get all role-grants for roles that have been granted to given principal Note that in the returned list of RolePrincipalGrants, the principal information redundant as it would match the principal information in request

Parameters:

getRolePrincReq -

Returns:

Throws:

MetaException

org.apache.thrift.TException

getAggrColStatsFor

AggrStats getAggrColStatsFor(String dbName,
                             String tblName,
                             List<String> colNames,
                             List<String> partName,
                             String engine)
                      throws NoSuchObjectException,
                             MetaException,
                             org.apache.thrift.TException

Get aggregated column stats for a set of partitions.

Parameters:: dbName - database name; tblName - table name; colNames - list of column names; partName - list of partition names (not values).; engine - engine sending the request
Returns:: aggregated stats for requested partitions
Throws:: NoSuchObjectException - no such table; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport exception

getAggrColStatsFor

AggrStats getAggrColStatsFor(String dbName,
                             String tblName,
                             List<String> colNames,
                             List<String> partName,
                             String engine,
                             String writeIdList)
                      throws NoSuchObjectException,
                             MetaException,
                             org.apache.thrift.TException

Throws:: NoSuchObjectException; MetaException; org.apache.thrift.TException

getAggrColStatsFor

AggrStats getAggrColStatsFor(String catName,
                             String dbName,
                             String tblName,
                             List<String> colNames,
                             List<String> partNames,
                             String engine)
                      throws NoSuchObjectException,
                             MetaException,
                             org.apache.thrift.TException

Get aggregated column stats for a set of partitions.

Parameters:: catName - catalog name; dbName - database name; tblName - table name; colNames - list of column names; partNames - list of partition names (not values).; engine - engine sending the request
Returns:: aggregated stats for requested partitions
Throws:: NoSuchObjectException - no such table; MetaException - error accessing the RDBMS; org.apache.thrift.TException - thrift transport exception

getAggrColStatsFor

AggrStats getAggrColStatsFor(String catName,
                             String dbName,
                             String tblName,
                             List<String> colNames,
                             List<String> partNames,
                             String engine,
                             String writeIdList)
                      throws NoSuchObjectException,
                             MetaException,
                             org.apache.thrift.TException

Throws:: NoSuchObjectException; MetaException; org.apache.thrift.TException

setPartitionColumnStatistics
```
boolean setPartitionColumnStatistics(SetPartitionsStatsRequest request)
                              throws NoSuchObjectException,
                                     InvalidObjectException,
                                     MetaException,
                                     org.apache.thrift.TException,
                                     InvalidInputException
```
Set table or partition column statistics.

Parameters:

request - request object, contains all the table, partition, and statistics information

Returns:

true if the set was successful.

Throws:

NoSuchObjectException - the table, partition, or columns specified do not exist.

InvalidObjectException - the stats object is not valid.

MetaException - error accessing the RDBMS.

org.apache.thrift.TException - thrift transport error.

InvalidInputException - the input is invalid (eg, a null table name)

flushCache
```
void flushCache()
```
Flush any catalog objects held by the metastore implementation. Note that this does not flush statistics objects. This should be called at the beginning of each query.

getFileMetadata
```
Iterable<Map.Entry<Long,ByteBuffer>> getFileMetadata(List<Long> fileIds)
                                              throws org.apache.thrift.TException
```
Gets file metadata, as cached by metastore, for respective file IDs. The metadata that is not cached in metastore may be missing.

Throws:

org.apache.thrift.TException

getFileMetadataBySarg

Iterable<Map.Entry<Long,MetadataPpdResult>> getFileMetadataBySarg(List<Long> fileIds,
                                                                  ByteBuffer sarg,
                                                                  boolean doGetFooters)
                                                           throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

clearFileMetadata
```
void clearFileMetadata(List<Long> fileIds)
                throws org.apache.thrift.TException
```
Cleares the file metadata cache for respective file IDs.

Throws:

org.apache.thrift.TException

putFileMetadata

void putFileMetadata(List<Long> fileIds,
                     List<ByteBuffer> metadata)
              throws org.apache.thrift.TException

Adds file metadata for respective file IDs to metadata cache in metastore.

Throws:: org.apache.thrift.TException

isSameConfObj

boolean isSameConfObj(org.apache.hadoop.conf.Configuration c)

cacheFileMetadata

boolean cacheFileMetadata(String dbName,
                          String tableName,
                          String partName,
                          boolean allParts)
                   throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

getPrimaryKeys
```
List<SQLPrimaryKey> getPrimaryKeys(PrimaryKeysRequest request)
                            throws MetaException,
                                   NoSuchObjectException,
                                   org.apache.thrift.TException
```
Get a primary key for a table.

Parameters:

request - Request info

Returns:

List of primary key columns

Throws:

MetaException - error reading the RDBMS

NoSuchObjectException - no primary key exists on this table, or maybe no such table

org.apache.thrift.TException - thrift transport error

getForeignKeys
```
List<SQLForeignKey> getForeignKeys(ForeignKeysRequest request)
                            throws MetaException,
                                   NoSuchObjectException,
                                   org.apache.thrift.TException
```
Get a foreign key for a table.

Parameters:

request - Request info

Returns:

List of foreign key columns

Throws:

MetaException - error reading the RDBMS

NoSuchObjectException - no foreign key exists on this table, or maybe no such table

org.apache.thrift.TException - thrift transport error

getUniqueConstraints

List<SQLUniqueConstraint> getUniqueConstraints(UniqueConstraintsRequest request)
                                        throws MetaException,
                                               NoSuchObjectException,
                                               org.apache.thrift.TException

Get a unique constraint for a table.

Parameters:: request - Request info
Returns:: List of unique constraint columns
Throws:: MetaException - error reading the RDBMS; NoSuchObjectException - no unique constraint on this table, or maybe no such table; org.apache.thrift.TException - thrift transport error

getNotNullConstraints

List<SQLNotNullConstraint> getNotNullConstraints(NotNullConstraintsRequest request)
                                          throws MetaException,
                                                 NoSuchObjectException,
                                                 org.apache.thrift.TException

Get a not null constraint for a table.

Parameters:: request - Request info
Returns:: List of not null constraint columns
Throws:: MetaException - error reading the RDBMS; NoSuchObjectException - no not null constraint on this table, or maybe no such table; org.apache.thrift.TException - thrift transport error

getDefaultConstraints

List<SQLDefaultConstraint> getDefaultConstraints(DefaultConstraintsRequest request)
                                          throws MetaException,
                                                 NoSuchObjectException,
                                                 org.apache.thrift.TException

Throws:: MetaException; NoSuchObjectException; org.apache.thrift.TException

getCheckConstraints

List<SQLCheckConstraint> getCheckConstraints(CheckConstraintsRequest request)
                                      throws MetaException,
                                             NoSuchObjectException,
                                             org.apache.thrift.TException

Throws:: MetaException; NoSuchObjectException; org.apache.thrift.TException

getAllTableConstraints

SQLAllTableConstraints getAllTableConstraints(AllTableConstraintsRequest request)
                                       throws MetaException,
                                              NoSuchObjectException,
                                              org.apache.thrift.TException

Get all constraints of given table

Parameters:: request - Request info
Returns:: all constraints of this table
Throws:: MetaException; NoSuchObjectException; org.apache.thrift.TException

createTableWithConstraints

void createTableWithConstraints(Table tTbl,
                                List<SQLPrimaryKey> primaryKeys,
                                List<SQLForeignKey> foreignKeys,
                                List<SQLUniqueConstraint> uniqueConstraints,
                                List<SQLNotNullConstraint> notNullConstraints,
                                List<SQLDefaultConstraint> defaultConstraints,
                                List<SQLCheckConstraint> checkConstraints)
                         throws AlreadyExistsException,
                                InvalidObjectException,
                                MetaException,
                                NoSuchObjectException,
                                org.apache.thrift.TException

Throws:: AlreadyExistsException; InvalidObjectException; MetaException; NoSuchObjectException; org.apache.thrift.TException

dropConstraint
```
void dropConstraint(String dbName,
                    String tableName,
                    String constraintName)
             throws MetaException,
                    NoSuchObjectException,
                    org.apache.thrift.TException
```
Drop a constraint. This can be used for primary keys, foreign keys, unique constraints, or not null constraints.

Parameters:

dbName - database name

tableName - table name

constraintName - name of the constraint

Throws:

MetaException - RDBMS access error

NoSuchObjectException - no such constraint exists

org.apache.thrift.TException - thrift transport error

dropConstraint
```
void dropConstraint(String catName,
                    String dbName,
                    String tableName,
                    String constraintName)
             throws MetaException,
                    NoSuchObjectException,
                    org.apache.thrift.TException
```
Drop a constraint. This can be used for primary keys, foreign keys, unique constraints, or not null constraints.

Parameters:

catName - catalog name

dbName - database name

tableName - table name

constraintName - name of the constraint

Throws:

MetaException - RDBMS access error

NoSuchObjectException - no such constraint exists

org.apache.thrift.TException - thrift transport error

addPrimaryKey
```
void addPrimaryKey(List<SQLPrimaryKey> primaryKeyCols)
            throws MetaException,
                   NoSuchObjectException,
                   org.apache.thrift.TException
```
Add a primary key.

Parameters:

primaryKeyCols - Primary key columns.

Throws:

MetaException - error reading or writing to the RDBMS or a primary key already exists

NoSuchObjectException - no such table exists

org.apache.thrift.TException - thrift transport error

addForeignKey
```
void addForeignKey(List<SQLForeignKey> foreignKeyCols)
            throws MetaException,
                   NoSuchObjectException,
                   org.apache.thrift.TException
```
Add a foreign key

Parameters:

foreignKeyCols - Foreign key definition

Throws:

MetaException - error reading or writing to the RDBMS or foreign key already exists

NoSuchObjectException - one of the tables in the foreign key does not exist.

org.apache.thrift.TException - thrift transport error

addUniqueConstraint
```
void addUniqueConstraint(List<SQLUniqueConstraint> uniqueConstraintCols)
                  throws MetaException,
                         NoSuchObjectException,
                         org.apache.thrift.TException
```
Add a unique constraint

Parameters:

uniqueConstraintCols - Unique constraint definition

Throws:

MetaException - error reading or writing to the RDBMS or unique constraint already exists

NoSuchObjectException - no such table

org.apache.thrift.TException - thrift transport error

addNotNullConstraint
```
void addNotNullConstraint(List<SQLNotNullConstraint> notNullConstraintCols)
                   throws MetaException,
                          NoSuchObjectException,
                          org.apache.thrift.TException
```
Add a not null constraint

Parameters:

notNullConstraintCols - Notnull constraint definition

Throws:

MetaException - error reading or writing to the RDBMS or not null constraint already exists

NoSuchObjectException - no such table

org.apache.thrift.TException - thrift transport error

addDefaultConstraint

void addDefaultConstraint(List<SQLDefaultConstraint> defaultConstraints)
                   throws MetaException,
                          NoSuchObjectException,
                          org.apache.thrift.TException

Throws:: MetaException; NoSuchObjectException; org.apache.thrift.TException

addCheckConstraint

void addCheckConstraint(List<SQLCheckConstraint> checkConstraints)
                 throws MetaException,
                        NoSuchObjectException,
                        org.apache.thrift.TException

Throws:: MetaException; NoSuchObjectException; org.apache.thrift.TException

getMetastoreDbUuid
```
String getMetastoreDbUuid()
                   throws MetaException,
                          org.apache.thrift.TException
```
Gets the unique id of the backing database instance used for storing metadata

Returns:

unique id of the backing database instance

Throws:

MetaException - if HMS is not able to fetch the UUID or if there are multiple UUIDs found in the database

org.apache.thrift.TException - in case of Thrift errors

createResourcePlan

void createResourcePlan(WMResourcePlan resourcePlan,
                        String copyFromName)
                 throws InvalidObjectException,
                        MetaException,
                        org.apache.thrift.TException

Throws:: InvalidObjectException; MetaException; org.apache.thrift.TException

getResourcePlan

WMFullResourcePlan getResourcePlan(String resourcePlanName,
                                   String ns)
                            throws NoSuchObjectException,
                                   MetaException,
                                   org.apache.thrift.TException

Throws:: NoSuchObjectException; MetaException; org.apache.thrift.TException

getAllResourcePlans

List<WMResourcePlan> getAllResourcePlans(String ns)
                                  throws NoSuchObjectException,
                                         MetaException,
                                         org.apache.thrift.TException

Throws:: NoSuchObjectException; MetaException; org.apache.thrift.TException

dropResourcePlan

void dropResourcePlan(String resourcePlanName,
                      String ns)
               throws NoSuchObjectException,
                      MetaException,
                      org.apache.thrift.TException

Throws:: NoSuchObjectException; MetaException; org.apache.thrift.TException

alterResourcePlan

WMFullResourcePlan alterResourcePlan(String resourcePlanName,
                                     String ns,
                                     WMNullableResourcePlan resourcePlan,
                                     boolean canActivateDisabled,
                                     boolean isForceDeactivate,
                                     boolean isReplace)
                              throws NoSuchObjectException,
                                     InvalidObjectException,
                                     MetaException,
                                     org.apache.thrift.TException

Throws:: NoSuchObjectException; InvalidObjectException; MetaException; org.apache.thrift.TException

getActiveResourcePlan

WMFullResourcePlan getActiveResourcePlan(String ns)
                                  throws MetaException,
                                         org.apache.thrift.TException

Throws:: MetaException; org.apache.thrift.TException

validateResourcePlan

WMValidateResourcePlanResponse validateResourcePlan(String resourcePlanName,
                                                    String ns)
                                             throws NoSuchObjectException,
                                                    InvalidObjectException,
                                                    MetaException,
                                                    org.apache.thrift.TException

Throws:: NoSuchObjectException; InvalidObjectException; MetaException; org.apache.thrift.TException

createWMTrigger

void createWMTrigger(WMTrigger trigger)
              throws InvalidObjectException,
                     MetaException,
                     org.apache.thrift.TException

Throws:: InvalidObjectException; MetaException; org.apache.thrift.TException

alterWMTrigger

void alterWMTrigger(WMTrigger trigger)
             throws NoSuchObjectException,
                    InvalidObjectException,
                    MetaException,
                    org.apache.thrift.TException

Throws:: NoSuchObjectException; InvalidObjectException; MetaException; org.apache.thrift.TException

dropWMTrigger

void dropWMTrigger(String resourcePlanName,
                   String triggerName,
                   String ns)
            throws NoSuchObjectException,
                   MetaException,
                   org.apache.thrift.TException

Throws:: NoSuchObjectException; MetaException; org.apache.thrift.TException

getTriggersForResourcePlan

List<WMTrigger> getTriggersForResourcePlan(String resourcePlan,
                                           String ns)
                                    throws NoSuchObjectException,
                                           MetaException,
                                           org.apache.thrift.TException

Throws:: NoSuchObjectException; MetaException; org.apache.thrift.TException

createWMPool

void createWMPool(WMPool pool)
           throws NoSuchObjectException,
                  InvalidObjectException,
                  MetaException,
                  org.apache.thrift.TException

Throws:: NoSuchObjectException; InvalidObjectException; MetaException; org.apache.thrift.TException

alterWMPool

void alterWMPool(WMNullablePool pool,
                 String poolPath)
          throws NoSuchObjectException,
                 InvalidObjectException,
                 org.apache.thrift.TException

Throws:: NoSuchObjectException; InvalidObjectException; org.apache.thrift.TException

dropWMPool

void dropWMPool(String resourcePlanName,
                String poolPath,
                String ns)
         throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

createOrUpdateWMMapping

void createOrUpdateWMMapping(WMMapping mapping,
                             boolean isUpdate)
                      throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

dropWMMapping

void dropWMMapping(WMMapping mapping)
            throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

createOrDropTriggerToPoolMapping

void createOrDropTriggerToPoolMapping(String resourcePlanName,
                                      String triggerName,
                                      String poolPath,
                                      boolean shouldDrop,
                                      String ns)
                               throws AlreadyExistsException,
                                      NoSuchObjectException,
                                      InvalidObjectException,
                                      MetaException,
                                      org.apache.thrift.TException

Throws:: AlreadyExistsException; NoSuchObjectException; InvalidObjectException; MetaException; org.apache.thrift.TException

createISchema
```
void createISchema(ISchema schema)
            throws org.apache.thrift.TException
```
Create a new schema. This is really a schema container, as there will be specific versions of the schema that have columns, etc.

Parameters:

schema - schema to create

Throws:

AlreadyExistsException - if a schema of this name already exists

NoSuchObjectException - database references by this schema does not exist

MetaException - general metastore error

org.apache.thrift.TException - general thrift error

alterISchema
```
void alterISchema(String catName,
                  String dbName,
                  String schemaName,
                  ISchema newSchema)
           throws org.apache.thrift.TException
```
Alter an existing schema.

Parameters:

catName - catalog name

dbName - database the schema is in

schemaName - name of the schema

newSchema - altered schema object

Throws:

NoSuchObjectException - no schema with this name could be found

MetaException - general metastore error

org.apache.thrift.TException - general thrift error

getISchema
```
ISchema getISchema(String catName,
                   String dbName,
                   String name)
            throws org.apache.thrift.TException
```
Fetch a schema.

Parameters:

catName - catalog name

dbName - database the schema is in

name - name of the schema

Returns:

the schema or null if no such schema

Throws:

NoSuchObjectException - no schema matching this name exists

MetaException - general metastore error

org.apache.thrift.TException - general thrift error

dropISchema
```
void dropISchema(String catName,
                 String dbName,
                 String name)
          throws org.apache.thrift.TException
```
Drop an existing schema. If there are schema versions of this, this call will fail.

Parameters:

catName - catalog name

dbName - database the schema is in

name - name of the schema to drop

Throws:

NoSuchObjectException - no schema with this name could be found

InvalidOperationException - attempt to drop a schema that has versions

MetaException - general metastore error

org.apache.thrift.TException - general thrift error

addSchemaVersion
```
void addSchemaVersion(SchemaVersion schemaVersion)
               throws org.apache.thrift.TException
```
Add a new version to an existing schema.

Parameters:

schemaVersion - version object to add

Throws:

AlreadyExistsException - a version of this schema with the same version id already exists

NoSuchObjectException - no schema with this name could be found

MetaException - general metastore error

org.apache.thrift.TException - general thrift error

getSchemaVersion
```
SchemaVersion getSchemaVersion(String catName,
                               String dbName,
                               String schemaName,
                               int version)
                        throws org.apache.thrift.TException
```
Get a specific version of a schema.

Parameters:

dbName - database the schema is in

schemaName - name of the schema

version - version of the schema

Returns:

the schema version or null if no such schema version

Throws:

NoSuchObjectException - no schema matching this name and version exists

MetaException - general metastore error

org.apache.thrift.TException - general thrift error

getSchemaLatestVersion
```
SchemaVersion getSchemaLatestVersion(String catName,
                                     String dbName,
                                     String schemaName)
                              throws org.apache.thrift.TException
```
Get the latest version of a schema.

Parameters:

catName - catalog name

dbName - database the schema is in

schemaName - name of the schema

Returns:

latest version of the schema or null if the schema does not exist or there are no version of the schema.

Throws:

NoSuchObjectException - no versions of schema matching this name exist

MetaException - general metastore error

org.apache.thrift.TException - general thrift error

getSchemaAllVersions
```
List<SchemaVersion> getSchemaAllVersions(String catName,
                                         String dbName,
                                         String schemaName)
                                  throws org.apache.thrift.TException
```
Get all the extant versions of a schema.

Parameters:

catName - catalog name

dbName - database the schema is in

schemaName - name of the schema.

Returns:

list of all the schema versions or null if this schema does not exist or has no versions.

Throws:

NoSuchObjectException - no versions of schema matching this name exist

MetaException - general metastore error

org.apache.thrift.TException - general thrift error

dropSchemaVersion
```
void dropSchemaVersion(String catName,
                       String dbName,
                       String schemaName,
                       int version)
                throws org.apache.thrift.TException
```
Drop a version of a schema. Given that versions are supposed to be immutable you should think really hard before you call this method. It should only be used for schema versions that were added in error and never referenced any data.

Parameters:

catName - catalog name

dbName - database the schema is in

schemaName - name of the schema

version - version of the schema

Throws:

NoSuchObjectException - no matching version of the schema could be found

MetaException - general metastore error

org.apache.thrift.TException - general thrift error

getSchemaByCols
```
FindSchemasByColsResp getSchemaByCols(FindSchemasByColsRqst rqst)
                               throws org.apache.thrift.TException
```
Find all schema versions that have columns that match a query.

Parameters:

rqst - query, this can include column names, namespaces (actually stored in the description field in FieldSchema), and types.

Returns:

The (possibly empty) list of schema name/version pairs that match.

Throws:

MetaException - general metastore error

org.apache.thrift.TException - general thrift error

mapSchemaVersionToSerde
```
void mapSchemaVersionToSerde(String catName,
                             String dbName,
                             String schemaName,
                             int version,
                             String serdeName)
                      throws org.apache.thrift.TException
```
Map a schema version to a serde. This mapping is one-to-one, thus this will destroy any previous mappings for this schema version.

Parameters:

catName - catalog name

dbName - database the schema is in

schemaName - name of the schema

version - version of the schema

serdeName - name of the serde

Throws:

NoSuchObjectException - no matching version of the schema could be found or no serde of the provided name could be found

MetaException - general metastore error

org.apache.thrift.TException - general thrift error

setSchemaVersionState
```
void setSchemaVersionState(String catName,
                           String dbName,
                           String schemaName,
                           int version,
                           SchemaVersionState state)
                    throws org.apache.thrift.TException
```
Set the state of a schema version.

Parameters:

catName - catalog name

dbName - database the schema is in

schemaName - name of the schema

version - version of the schema

state - state to set the schema too

Throws:

NoSuchObjectException - no matching version of the schema could be found

InvalidOperationException - attempt to make a state change that is not valid

MetaException - general metastore error

org.apache.thrift.TException - general thrift error

addSerDe
```
void addSerDe(SerDeInfo serDeInfo)
       throws org.apache.thrift.TException
```
Add a serde. This is primarily intended for use with SchemaRegistry objects, since serdes are automatically added when needed as part of creating and altering tables and partitions.

Parameters:

serDeInfo - serde to add

Throws:

AlreadyExistsException - serde of this name already exists

MetaException - general metastore error

org.apache.thrift.TException - general thrift error

getSerDe
```
SerDeInfo getSerDe(String serDeName)
            throws org.apache.thrift.TException
```
Fetch a serde. This is primarily intended for use with SchemaRegistry objects, since serdes are automatically fetched along with other information for tables and partitions.

Parameters:

serDeName - name of the serde

Returns:

the serde.

Throws:

NoSuchObjectException - no serde with this name exists.

MetaException - general metastore error

org.apache.thrift.TException - general thrift error

lockMaterializationRebuild
```
LockResponse lockMaterializationRebuild(String dbName,
                                        String tableName,
                                        long txnId)
                                 throws org.apache.thrift.TException
```
Acquire the materialization rebuild lock for a given view. We need to specify the fully qualified name of the materialized view and the open transaction ID so we can identify uniquely the lock.

Parameters:

dbName - db name for the materialized view

tableName - table name for the materialized view

txnId - transaction id for the rebuild

Returns:

the response from the metastore, where the lock id is equal to the txn id and the status can be either ACQUIRED or NOT ACQUIRED

Throws:

org.apache.thrift.TException

heartbeatLockMaterializationRebuild
```
boolean heartbeatLockMaterializationRebuild(String dbName,
                                            String tableName,
                                            long txnId)
                                     throws org.apache.thrift.TException
```
Method to refresh the acquisition of a given materialization rebuild lock.

Parameters:

dbName - db name for the materialized view

tableName - table name for the materialized view

txnId - transaction id for the rebuild

Returns:

true if the lock could be renewed, false otherwise

Throws:

org.apache.thrift.TException

addRuntimeStat
```
void addRuntimeStat(RuntimeStat stat)
             throws org.apache.thrift.TException
```
Adds a RuntimeStat for metastore persistence.

Throws:

org.apache.thrift.TException

getRuntimeStats

List<RuntimeStat> getRuntimeStats(int maxWeight,
                                  int maxCreateTime)
                           throws org.apache.thrift.TException

Reads runtime statistics.

Throws:: org.apache.thrift.TException

getPartitionsWithSpecs
```
GetPartitionsResponse getPartitionsWithSpecs(GetPartitionsRequest request)
                                      throws org.apache.thrift.TException
```
Generic Partition request API, providing different ways of filtering and controlling output. The API entry point is getPartitionsWithSpecs(), which is based on a single request/response object model. The request (GetPartitionsRequest) defines any filtering that should be done for partitions as well as the list of fields that should be returned (this is called ProjectionSpec). Projection is simply a list of dot separated strings which represent the fields which should be returned. Projection may also include whitelist or blacklist of parameters to include in the partition. When both blacklist and whitelist are present, the blacklist supersedes the whitelist in case of conflicts. Partition filter spec is the generalization of various types of partition filtering. Partitions can be filtered by names, by values or by partition expressions.

Throws:

org.apache.thrift.TException

findNextCompact
```
@Deprecated
OptionalCompactionInfoStruct findNextCompact(String workerId)
                                                  throws MetaException,
                                                         org.apache.thrift.TException
```
Deprecated. Use findNextCompact(org.apache.hadoop.hive.metastore.api.FindNextCompactRequest) instead

Get the next compaction job to do.

Parameters:

workerId - id of the worker requesting.

Returns:

next compaction job encapsulated in a CompactionInfoStruct.

Throws:

MetaException

org.apache.thrift.TException

findNextCompact
```
OptionalCompactionInfoStruct findNextCompact(FindNextCompactRequest rqst)
                                      throws MetaException,
                                             org.apache.thrift.TException
```
Get the next compaction job to do.

Parameters:

rqst - Information about the worker id and version

Returns:

next compaction job encapsulated in a CompactionInfoStruct.

Throws:

MetaException

org.apache.thrift.TException

updateCompactorState
```
void updateCompactorState(CompactionInfoStruct cr,
                          long txnId)
                   throws org.apache.thrift.TException
```
Set the compaction highest write id.

Parameters:

cr - compaction job being done.

txnId - transaction id.

Throws:

org.apache.thrift.TException

findColumnsWithStats

List<String> findColumnsWithStats(CompactionInfoStruct cr)
                           throws org.apache.thrift.TException

Get columns.

Parameters:: cr - compaction job.
Returns:
Throws:: org.apache.thrift.TException

markCleaned
```
void markCleaned(CompactionInfoStruct cr)
          throws MetaException,
                 org.apache.thrift.TException
```
Mark a finished compaction as cleaned.

Parameters:

cr - compaction job.

Throws:

MetaException

org.apache.thrift.TException

markCompacted
```
void markCompacted(CompactionInfoStruct cr)
            throws MetaException,
                   org.apache.thrift.TException
```
Mark a finished compaction as compacted.

Parameters:

cr - compaction job.

Throws:

MetaException

org.apache.thrift.TException

markFailed
```
void markFailed(CompactionInfoStruct cr)
         throws MetaException,
                org.apache.thrift.TException
```
Mark a finished compaction as failed.

Parameters:

cr - compaction job.

Throws:

MetaException

org.apache.thrift.TException

markRefused
```
void markRefused(CompactionInfoStruct cr)
          throws MetaException,
                 org.apache.thrift.TException
```
Mark a compaction as refused (to run).

Parameters:

cr - compaction job.

Throws:

MetaException

org.apache.thrift.TException

updateCompactionMetricsData
```
boolean updateCompactionMetricsData(CompactionMetricsDataStruct struct)
                             throws MetaException,
                                    org.apache.thrift.TException
```
Create, update or delete one record in the compaction metrics cache.
If the metric is not found in the metrics cache, it will be created.

If the metric is found, it will be updated. This operation uses an optimistic locking mechanism, meaning if another operation changed the value of this metric, the update will abort and won't be retried.

If the new metric value is below CompactionMetricsDataStruct.getThreshold(), it will be deleted.

Parameters:

struct - the object that is used for the update, always non-null

Returns:

true, if update finished successfully

Throws:

MetaException

org.apache.thrift.TException

removeCompactionMetricsData
```
void removeCompactionMetricsData(CompactionMetricsDataRequest request)
                          throws MetaException,
                                 org.apache.thrift.TException
```
Remove records from the compaction metrics cache matching the filter criteria passed in as parameters

Parameters:

request - the request object, that contains the filter parameters, must be non-null

Throws:

MetaException

org.apache.thrift.TException

setHadoopJobid
```
void setHadoopJobid(String jobId,
                    long cqId)
             throws MetaException,
                    org.apache.thrift.TException
```
Set the hadoop id for a compaction.

Parameters:

jobId - mapreduce job id that will do the compaction.

cqId - compaction id.

Throws:

MetaException

org.apache.thrift.TException

getServerVersion
```
String getServerVersion()
                 throws org.apache.thrift.TException
```
Gets the version string of the metastore server which this client is connected to

Returns:

String representation of the version number of Metastore server (eg: 3.1.0-SNAPSHOT)

Throws:

org.apache.thrift.TException

getScheduledQuery
```
ScheduledQuery getScheduledQuery(ScheduledQueryKey scheduleKey)
                          throws org.apache.thrift.TException
```
Returns details about a scheduled query by name.

Throws:

NoSuchObjectException - if an object by the given name dosen't exists.

org.apache.thrift.TException

scheduledQueryMaintenance

void scheduledQueryMaintenance(ScheduledQueryMaintenanceRequest request)
                        throws MetaException,
                               org.apache.thrift.TException

Carries out maintenance of scheduled queries (insert/update/drop).

Throws:: MetaException; org.apache.thrift.TException

scheduledQueryPoll

ScheduledQueryPollResponse scheduledQueryPoll(ScheduledQueryPollRequest request)
                                       throws MetaException,
                                              org.apache.thrift.TException

Checks whenever a query is available for execution.

Returns:: optionally a scheduled query to be processed.
Throws:: MetaException; org.apache.thrift.TException

scheduledQueryProgress

void scheduledQueryProgress(ScheduledQueryProgressInfo info)
                     throws org.apache.thrift.TException

Registers the progress a scheduled query being executed.

Throws:: org.apache.thrift.TException

addReplicationMetrics

void addReplicationMetrics(ReplicationMetricList replicationMetricList)
                    throws MetaException,
                           org.apache.thrift.TException

Adds replication metrics for the replication policies.

Parameters:: replicationMetricList -
Throws:: MetaException; org.apache.thrift.TException

getReplicationMetrics

ReplicationMetricList getReplicationMetrics(GetReplicationMetricsRequest replicationMetricsRequest)
                                     throws MetaException,
                                            org.apache.thrift.TException

Throws:: MetaException; org.apache.thrift.TException

createStoredProcedure

void createStoredProcedure(StoredProcedure proc)
                    throws NoSuchObjectException,
                           MetaException,
                           org.apache.thrift.TException

Throws:: NoSuchObjectException; MetaException; org.apache.thrift.TException

getStoredProcedure

StoredProcedure getStoredProcedure(StoredProcedureRequest request)
                            throws MetaException,
                                   NoSuchObjectException,
                                   org.apache.thrift.TException

Throws:: MetaException; NoSuchObjectException; org.apache.thrift.TException

dropStoredProcedure

void dropStoredProcedure(StoredProcedureRequest request)
                  throws MetaException,
                         NoSuchObjectException,
                         org.apache.thrift.TException

Throws:: MetaException; NoSuchObjectException; org.apache.thrift.TException

getAllStoredProcedures

List<String> getAllStoredProcedures(ListStoredProcedureRequest request)
                             throws MetaException,
                                    org.apache.thrift.TException

Throws:: MetaException; org.apache.thrift.TException

addPackage

void addPackage(AddPackageRequest request)
         throws NoSuchObjectException,
                MetaException,
                org.apache.thrift.TException

Throws:: NoSuchObjectException; MetaException; org.apache.thrift.TException

findPackage

Package findPackage(GetPackageRequest request)
             throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

listPackages

List<String> listPackages(ListPackageRequest request)
                   throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

dropPackage

void dropPackage(DropPackageRequest request)
          throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

getAllWriteEventInfo

List<WriteEventInfo> getAllWriteEventInfo(GetAllWriteEventInfoRequest request)
                                   throws org.apache.thrift.TException

Get acid write events of a specific transaction.

Throws:: org.apache.thrift.TException

abortCompactions

AbortCompactResponse abortCompactions(AbortCompactionRequest request)
                               throws org.apache.thrift.TException

Throws:: org.apache.thrift.TException

setProperties
```
default boolean setProperties(String nameSpace,
                              Map<String,String> properties)
                       throws org.apache.thrift.TException
```
Sets properties.

Parameters:

nameSpace - the property store namespace

properties - a map keyed by property path mapped to property values

Returns:

true if successful, false otherwise

Throws:

org.apache.thrift.TException

getProperties

default Map<String,Map<String,String>> getProperties(String nameSpace,
                                                     String mapPrefix,
                                                     String mapPredicate,
                                                     String... selection)
                                              throws org.apache.thrift.TException

Gets properties.

Parameters:: nameSpace - the property store namespace.; mapPrefix - the map prefix (ala starts-with) to select maps; mapPredicate - predicate expression on properties to further reduce the selected maps; selection - the list of properties to return, null for all
Returns:: a map keyed by property map path to maps keyed by property name mapped to property values
Throws:: org.apache.thrift.TException

Interface IMetaStoreClient

Nested Class Summary

Method Summary

Method Detail

isCompatibleWith

setHiveAddedJars

isLocalMetaStore

reconnect

close

setMetaConf

getMetaConf

createCatalog

alterCatalog

getCatalog

getCatalogs

dropCatalog

getDatabases

getDatabases

getAllDatabases

getAllDatabases

getTables

getTables

getTables

getTables

getAllMaterializedViewObjectsForRewriting

getTablesExt

getMaterializedViewsForRewriting

getMaterializedViewsForRewriting

getTableMeta

getTableMeta

getAllTables

getAllTables

listTableNamesByFilter

listTableNamesByFilter

dropTable

dropTable

dropTable

dropTable

dropTable

dropTable

dropTable

truncateTable

truncateTable

truncateTable

truncateTable

recycleDirToCmPath

tableExists

tableExists

getDatabase

getDatabase

getTable

getTable

getTable

getTable

getTable

getTable

getTableObjectsByName

getTables

getTableObjectsByName

getMaterializationInvalidationInfo

updateCreationMetadata

updateCreationMetadata

appendPartition

appendPartition

appendPartition

appendPartition

add_partition

add_partitions

add_partitions_pspec

add_partitions

getPartition

getPartitionRequest

getPartition

exchange_partition

exchange_partition

exchange_partitions

exchange_partitions

getPartition

getPartition

getPartitionWithAuthInfo