RawStore (Hive Metastore Server 4.0.0 API)

All Superinterfaces:

org.apache.hadoop.conf.Configurable

All Known Implementing Classes:

CachedStore, ObjectStore
```
public interface RawStore
extends org.apache.hadoop.conf.Configurable
```

Nested Class Summary

Nested Classes
Modifier and Type Interface and Description

static interface RawStore.CanNotRetry
Annotation to skip retries

Nested Classes
Modifier and Type	Interface and Description
`static interface`	`RawStore.CanNotRetry` Annotation to skip retries

Method Summary

All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods
Modifier and Type	Method and Description
`List<SQLCheckConstraint>`	`addCheckConstraints(List<SQLCheckConstraint> cc)` Add check constraints to a table.
`List<SQLDefaultConstraint>`	`addDefaultConstraints(List<SQLDefaultConstraint> dv)` Add default values to a table definition.
`List<SQLForeignKey>`	`addForeignKeys(List<SQLForeignKey> fks)` Add a foreign key to a table.
`int`	`addMasterKey(String key)`
`void`	`addNotificationEvent(NotificationEvent event)` Add a notification entry.
`List<SQLNotNullConstraint>`	`addNotNullConstraints(List<SQLNotNullConstraint> nns)` Add not null constraints to a table.
`void`	`addPackage(AddPackageRequest request)`
`boolean`	`addPartition(Partition part)` Add a partition.
`boolean`	`addPartitions(String catName, String dbName, String tblName, List<Partition> parts)` Add a list of partitions to a table.
`boolean`	`addPartitions(String catName, String dbName, String tblName, PartitionSpecProxy partitionSpec, boolean ifNotExists)` Deprecated. use `addPartitions(String, String, String, List)` instead.
`List<SQLPrimaryKey>`	`addPrimaryKeys(List<SQLPrimaryKey> pks)` Add a primary key to a table.
`void`	`addReplicationMetrics(ReplicationMetricList replicationMetricList)` Add the replication metrics and progress info.
`boolean`	`addRole(String rowName, String ownerName)`
`void`	`addRuntimeStat(RuntimeStat stat)` Adds a RuntimeStat for persistence.
`void`	`addSchemaVersion(SchemaVersion schemaVersion)` Create a new version of an existing schema.
`void`	`addSerde(SerDeInfo serde)` Add a serde.
`boolean`	`addToken(String tokenIdentifier, String delegationToken)`
`List<SQLUniqueConstraint>`	`addUniqueConstraints(List<SQLUniqueConstraint> uks)` Add unique constraints to a table.
`void`	`alterCatalog(String catName, Catalog cat)` Alter an existing catalog.
`boolean`	`alterDatabase(String catalogName, String dbname, Database db)` Alter a database.
`boolean`	`alterDataConnector(String dcName, DataConnector connector)` Alter a dataconnector.
`void`	`alterFunction(String catName, String dbName, String funcName, Function newFunction)` Alter function based on new function specs.
`void`	`alterISchema(ISchemaName schemaName, ISchema newSchema)` Alter an existing ISchema.
`Partition`	`alterPartition(String catName, String db_name, String tbl_name, List<String> part_vals, Partition new_part, String queryValidWriteIds)` Alter a partition.
`List<Partition>`	`alterPartitions(String catName, String db_name, String tbl_name, List<List<String>> part_vals_list, List<Partition> new_parts, long writeId, String queryValidWriteIds)` Alter a set of partitions.
`void`	`alterPool(WMNullablePool pool, String poolPath)`
`WMFullResourcePlan`	`alterResourcePlan(String name, String ns, WMNullableResourcePlan resourcePlan, boolean canActivateDisabled, boolean canDeactivate, boolean isReplace)`
`void`	`alterSchemaVersion(SchemaVersionDescriptor version, SchemaVersion newVersion)` Alter a schema version.
`Table`	`alterTable(String catName, String dbname, String name, Table newTable, String queryValidWriteIds)` Alter a table.
`void`	`alterWMTrigger(WMTrigger trigger)`
`void`	`cleanNotificationEvents(int olderThan)` Remove older notification events.
`long`	`cleanupEvents()`
`void`	`cleanWriteNotificationEvents(int olderThan)` Remove older notification events.
`boolean`	`commitTransaction()` if this is the commit of the first open call then an actual commit is called.
`void`	`createCatalog(Catalog cat)` Create a new catalog.
`void`	`createDatabase(Database db)` Create a database.
`void`	`createDataConnector(DataConnector dataConnector)` Create a dataconnector.
`void`	`createFunction(Function func)` Register a user-defined function based on the function specification passed in.
`void`	`createISchema(ISchema schema)` Create a new ISchema.
`void`	`createOrUpdateStoredProcedure(StoredProcedure proc)`
`void`	`createOrUpdateWMMapping(WMMapping mapping, boolean update)`
`void`	`createPool(WMPool pool)`
`void`	`createResourcePlan(WMResourcePlan resourcePlan, String copyFrom, int defaultPoolSize)`
`void`	`createTable(Table tbl)`
`SQLAllTableConstraints`	`createTableWithConstraints(Table tbl, SQLAllTableConstraints constraints)` Create a table with constraints
`boolean`	`createType(Type type)`
`void`	`createWMTrigger(WMTrigger trigger)`
`void`	`createWMTriggerToPoolMapping(String resourcePlanName, String triggerName, String poolPath, String ns)`
`void`	`deleteAllPartitionColumnStatistics(TableName tn, String writeIdList)`
`boolean`	`deletePartitionColumnStatistics(String catName, String dbName, String tableName, String partName, List<String> partVals, String colName, String engine)` Deletes column statistics if present associated with a given db, table, partition and col.
`int`	`deleteReplicationMetrics(int maxRetainSecs)`
`int`	`deleteRuntimeStats(int maxRetainSecs)` Removes outdated statistics.
`int`	`deleteScheduledExecutions(int maxRetainSecs)`
`boolean`	`deleteTableColumnStatistics(String catName, String dbName, String tableName, String colName, String engine)` Delete statistics for a single column or all columns in a table.
`boolean`	`doesPartitionExist(String catName, String dbName, String tableName, List<FieldSchema> partKeys, List<String> part_vals)` Check whether a partition exists.
`void`	`dropCatalog(String catalogName)` Drop a catalog.
`default void`	`dropConstraint(String catName, String dbName, String tableName, String constraintName)` Drop a constraint, any constraint.
`void`	`dropConstraint(String catName, String dbName, String tableName, String constraintName, boolean missingOk)` Drop a constraint, any constraint.
`boolean`	`dropDatabase(String catalogName, String dbname)` Drop a database.
`boolean`	`dropDataConnector(String dcName)` Drop a dataconnector.
`void`	`dropFunction(String catName, String dbName, String funcName)` Drop a function definition.
`void`	`dropISchema(ISchemaName schemaName)` Drop an ISchema.
`void`	`dropPackage(DropPackageRequest request)`
`boolean`	`dropPartition(String catName, String dbName, String tableName, List<String> part_vals)` Deprecated.
`boolean`	`dropPartition(String catName, String dbName, String tableName, String partName)` Drop a partition.
`void`	`dropPartitions(String catName, String dbName, String tblName, List<String> partNames)` Drop a list of partitions.
`void`	`dropResourcePlan(String name, String ns)`
`void`	`dropSchemaVersion(SchemaVersionDescriptor version)` Drop a version of the schema.
`void`	`dropStoredProcedure(String catName, String dbName, String funcName)`
`boolean`	`dropTable(String catalogName, String dbName, String tableName)` Drop a table.
`boolean`	`dropType(String typeName)`
`void`	`dropWMMapping(WMMapping mapping)`
`void`	`dropWMPool(String resourcePlanName, String poolPath, String ns)`
`void`	`dropWMTrigger(String resourcePlanName, String triggerName, String ns)`
`void`	`dropWMTriggerToPoolMapping(String resourcePlanName, String triggerName, String poolPath, String ns)`
`MTable`	`ensureGetMTable(String catName, String dbName, String tblName)`
`Package`	`findPackage(GetPackageRequest request)`
`void`	`flushCache()`
`AggrStats`	`get_aggr_stats_for(String catName, String dbName, String tblName, List<String> partNames, List<String> colNames, String engine)` Get aggregated stats for a table or partition(s).
`AggrStats`	`get_aggr_stats_for(String catName, String dbName, String tblName, List<String> partNames, List<String> colNames, String engine, String writeIdList)` Get aggregated stats for a table or partition(s).
`WMFullResourcePlan`	`getActiveResourcePlan(String ns)`
`List<String>`	`getAllDatabases(String catalogName)` Get names of all the databases in a catalog.
`List<String>`	`getAllDataConnectorNames()` Get names of all the databases in a catalog.
`List<Function>`	`getAllFunctions(String catName)` Retrieve all functions.
`List<Table>`	`getAllMaterializedViewObjectsForRewriting(String catName)` Retrieve all materialized views.
`List<WMResourcePlan>`	`getAllResourcePlans(String string)`
`List<SchemaVersion>`	`getAllSchemaVersion(ISchemaName schemaName)` Get all of the versions of a schema.
`List<String>`	`getAllStoredProcedures(ListStoredProcedureRequest request)`
`SQLAllTableConstraints`	`getAllTableConstraints(AllTableConstraintsRequest request)` Get table constraints
`SQLAllTableConstraints`	`getAllTableConstraints(String catName, String dbName, String tblName)` Deprecated.
`List<TableName>`	`getAllTableNamesForStats()`
`List<String>`	`getAllTables(String catName, String dbName)` Get all tables in a database.
`List<String>`	`getAllTokenIdentifiers()`
`List<WriteEventInfo>`	`getAllWriteEventInfo(long txnId, String dbName, String tableName)` Get all write events for a specific transaction .
`Catalog`	`getCatalog(String catalogName)` Get a catalog.
`List<String>`	`getCatalogs()` Get all the catalogs.
`List<SQLCheckConstraint>`	`getCheckConstraints(CheckConstraintsRequest request)` SQLCheckConstraint represents a single check constraint column.
`List<SQLCheckConstraint>`	`getCheckConstraints(String catName, String db_name, String tbl_name)` Deprecated.
`PrincipalPrivilegeSet`	`getColumnPrivilegeSet(String catName, String dbName, String tableName, String partitionName, String columnName, String userName, List<String> groupNames)` Get privileges for a column in a table or partition for a user.
`PrincipalPrivilegeSet`	`getConnectorPrivilegeSet(String catName, String connectorName, String userName, List<String> groupNames)` Get privileges for a connector for a user.
`CurrentNotificationEventId`	`getCurrentNotificationEventId()` Get the last issued notification event id.
`Database`	`getDatabase(String catalogName, String name)` Get a database.
`int`	`getDatabaseCount()` Gets total number of databases.
`List<String>`	`getDatabases(String catalogName, String pattern)` Get all database in a catalog having names that match a pattern.
`DataConnector`	`getDataConnector(String dcName)` Get the dataconnector with a given name, if exists.
`PrincipalPrivilegeSet`	`getDBPrivilegeSet(String catName, String dbName, String userName, List<String> groupNames)` Get privileges for a database for a user.
`List<SQLDefaultConstraint>`	`getDefaultConstraints(DefaultConstraintsRequest request)` SQLDefaultConstraint represents a single default constraint column.
`List<SQLDefaultConstraint>`	`getDefaultConstraints(String catName, String db_name, String tbl_name)` Deprecated.
`ByteBuffer[]`	`getFileMetadata(List<Long> fileIds)`
`void`	`getFileMetadataByExpr(List<Long> fileIds, FileMetadataExprType type, byte[] expr, ByteBuffer[] metadatas, ByteBuffer[] exprResults, boolean[] eliminated)` Gets file metadata from cache after applying a format-specific expression that can produce additional information based on file metadata and also filter the file list.
`FileMetadataHandler`	`getFileMetadataHandler(FileMetadataExprType type)` Gets file metadata handler for the corresponding type.
`List<SQLForeignKey>`	`getForeignKeys(ForeignKeysRequest request)` SQLForeignKey represents a single foreign key column.
`List<SQLForeignKey>`	`getForeignKeys(String catName, String parent_db_name, String parent_tbl_name, String foreign_db_name, String foreign_tbl_name)` Deprecated.
`Function`	`getFunction(String catName, String dbName, String funcName)` Retrieve function by name.
`List<String>`	`getFunctions(String catName, String dbName, String pattern)` Retrieve list of function names based on name pattern.
`ISchema`	`getISchema(ISchemaName schemaName)` Get an ISchema by name.
`SchemaVersion`	`getLatestSchemaVersion(ISchemaName schemaName)` Get the latest version of a schema.
`String[]`	`getMasterKeys()`
`List<String>`	`getMaterializedViewsForRewriting(String catName, String dbName)` Get list of materialized views in a database.
`String`	`getMetastoreDbUuid()` Gets the unique id of the backing datastore for the metadata.
`String`	`getMetaStoreSchemaVersion()`
`NotificationEventResponse`	`getNextNotification(NotificationEventRequest rqst)` Get the next notification event.
`NotificationEventsCountResponse`	`getNotificationEventsCount(NotificationEventsCountRequest rqst)` Get the number of events corresponding to given database with fromEventId.
`List<SQLNotNullConstraint>`	`getNotNullConstraints(NotNullConstraintsRequest request)` SQLNotNullConstraint represents a single not null constraint column.
`List<SQLNotNullConstraint>`	`getNotNullConstraints(String catName, String db_name, String tbl_name)` Deprecated.
`int`	`getNumPartitionsByExpr(String catName, String dbName, String tblName, byte[] expr)` Get the number of partitions that match an already parsed expression.
`int`	`getNumPartitionsByFilter(String catName, String dbName, String tblName, String filter)` Get the number of partitions that match a provided SQL filter.
`int`	`getNumPartitionsByPs(String catName, String dbName, String tblName, List<String> partVals)` Get the number of partitions that match a given partial specification.
`Partition`	`getPartition(String catName, String dbName, String tableName, List<String> part_vals)` Get a partition.
`Partition`	`getPartition(String catName, String dbName, String tableName, List<String> part_vals, String writeIdList)` Get a partition.
`List<MetaStoreServerUtils.ColStatsObjWithSourceInfo>`	`getPartitionColStatsForDatabase(String catName, String dbName)` Get column stats for all partitions of all tables in the database
`Map<String,List<String>>`	`getPartitionColsWithStats(String catName, String dbName, String tableName)`
`List<List<ColumnStatistics>>`	`getPartitionColumnStatistics(String catName, String dbName, String tblName, List<String> partNames, List<String> colNames)` Get statistics for a partition for a set of columns.
`List<ColumnStatistics>`	`getPartitionColumnStatistics(String catName, String dbName, String tblName, List<String> partNames, List<String> colNames, String engine)` Get statistics for a partition for a set of columns.
`List<ColumnStatistics>`	`getPartitionColumnStatistics(String catName, String dbName, String tblName, List<String> partNames, List<String> colNames, String engine, String writeIdList)` Get statistics for a partition for a set of columns.
`int`	`getPartitionCount()` Gets total number of partitions.
`Map<String,String>`	`getPartitionLocations(String catName, String dbName, String tblName, String baseLocationToNotShow, int max)` Get the location for every partition of a given table.
`PrincipalPrivilegeSet`	`getPartitionPrivilegeSet(String catName, String dbName, String tableName, String partition, String userName, List<String> groupNames)` Get privileges for a partition for a user.
`List<Partition>`	`getPartitions(String catName, String dbName, String tableName, GetPartitionsArgs args)` Get some or all partitions for a table.
`default List<Partition>`	`getPartitions(String catName, String dbName, String tableName, int max)` Deprecated.
`default boolean`	`getPartitionsByExpr(String catName, String dbName, String tblName, byte[] expr, String defaultPartitionName, short maxParts, List<Partition> result)` Deprecated.
`boolean`	`getPartitionsByExpr(String catName, String dbName, String tblName, List<Partition> result, GetPartitionsArgs args)` Get partitions using an already parsed expression.
`List<Partition>`	`getPartitionsByFilter(String catName, String dbName, String tblName, GetPartitionsArgs args)` Get partitions with a filter.
`default List<Partition>`	`getPartitionsByFilter(String catName, String dbName, String tblName, String filter, short maxParts)` Deprecated.
`List<Partition>`	`getPartitionsByNames(String catName, String dbName, String tblName, GetPartitionsArgs args)` Get partitions by name.
`default List<Partition>`	`getPartitionsByNames(String catName, String dbName, String tblName, List<String> partNames)` Get partitions by name.
`List<Partition>`	`getPartitionSpecsByFilterAndProjection(Table table, GetProjectionsSpec projectionSpec, GetPartitionsFilterSpec filterSpec)` Generic Partition request API, providing different kinds of filtering and controlling output.
`default List<Partition>`	`getPartitionsWithAuth(String catName, String dbName, String tblName, short maxParts, String userName, List<String> groupNames)` Deprecated.
`Partition`	`getPartitionWithAuth(String catName, String dbName, String tblName, List<String> partVals, String user_name, List<String> group_names)` Fetch a partition along with privilege information for a particular user.
`List<SQLPrimaryKey>`	`getPrimaryKeys(PrimaryKeysRequest request)` SQLPrimaryKey represents a single primary key column.
`List<SQLPrimaryKey>`	`getPrimaryKeys(String catName, String db_name, String tbl_name)` Deprecated.
`default PropertyStore`	`getPropertyStore()` Persistent Property Management.
`ReplicationMetricList`	`getReplicationMetrics(GetReplicationMetricsRequest replicationMetricsRequest)` Gets the replication metrics and progress info.
`WMFullResourcePlan`	`getResourcePlan(String name, String string)`
`Role`	`getRole(String roleName)`
`List<RuntimeStat>`	`getRuntimeStats(int maxEntries, int maxCreateTime)` Reads runtime statistic entries.
`ScheduledQuery`	`getScheduledQuery(ScheduledQueryKey scheduleKey)` Returns details about a scheduled query by name.
`SchemaVersion`	`getSchemaVersion(SchemaVersionDescriptor version)` Get a specific schema version.
`List<SchemaVersion>`	`getSchemaVersionsByColumns(String colName, String colNamespace, String type)` Find all SchemaVersion objects that match a query.
`SerDeInfo`	`getSerDeInfo(String serDeName)` Get serde information.
`StoredProcedure`	`getStoredProcedure(String catName, String db, String name)`
`Table`	`getTable(String catalogName, String dbName, String tableName)` Get a table object.
`Table`	`getTable(String catalogName, String dbName, String tableName, String writeIdList)` Get a table object.
`Table`	`getTable(String catalogName, String dbName, String tableName, String writeIdList, long tableId)` Get a table object.
`List<ColumnStatistics>`	`getTableColumnStatistics(String catName, String dbName, String tableName, List<String> colName)` Returns the relevant column statistics for a given column in a given table in a given database if such statistics exist.
`ColumnStatistics`	`getTableColumnStatistics(String catName, String dbName, String tableName, List<String> colName, String engine)` Returns the relevant column statistics for a given column in a given table in a given database if such statistics exist.
`ColumnStatistics`	`getTableColumnStatistics(String catName, String dbName, String tableName, List<String> colName, String engine, String writeIdList)` Returns the relevant column statistics for a given column in a given table in a given database if such statistics exist.
`int`	`getTableCount()` Gets total number of tables.
`List<TableMeta>`	`getTableMeta(String catName, String dbNames, String tableNames, List<String> tableTypes)`
`List<TableName>`	`getTableNamesWithStats()`
`List<Table>`	`getTableObjectsByName(String catName, String dbname, List<String> tableNames)`
`List<Table>`	`getTableObjectsByName(String catName, String dbname, List<String> tableNames, GetProjectionsSpec projectionSpec, String tablePattern)`
`PrincipalPrivilegeSet`	`getTablePrivilegeSet(String catName, String dbName, String tableName, String userName, List<String> groupNames)` Get privileges for a table for a user.
`List<String>`	`getTables(String catName, String dbName, String pattern)` Get table names that match a pattern.
`List<String>`	`getTables(String catName, String dbName, String pattern, TableType tableType, int limit)` Get table names that match a pattern.
`String`	`getToken(String tokenIdentifier)`
`List<WMTrigger>`	`getTriggersForResourcePlan(String resourcePlanName, String ns)`
`Type`	`getType(String typeName)`
`List<SQLUniqueConstraint>`	`getUniqueConstraints(String catName, String db_name, String tbl_name)` Deprecated.
`List<SQLUniqueConstraint>`	`getUniqueConstraints(UniqueConstraintsRequest request)` SQLUniqueConstraint represents a single unique constraint column.
`PrincipalPrivilegeSet`	`getUserPrivilegeSet(String userName, List<String> groupNames)`
`boolean`	`grantPrivileges(PrivilegeBag privileges)`
`boolean`	`grantRole(Role role, String userName, PrincipalType principalType, String grantor, PrincipalType grantorType, boolean grantOption)`
`boolean`	`isActiveTransaction()`
`boolean`	`isFileMetadataSupported()`
`boolean`	`isPartitionMarkedForEvent(String catName, String dbName, String tblName, Map<String,String> partName, PartitionEventType evtType)`
`List<String>`	`isPartOfMaterializedView(String catName, String dbName, String tblName)` Checking if table is part of a materialized view.
`List<HiveObjectPrivilege>`	`listAllTableGrants(String principalName, PrincipalType principalType, String catName, String dbName, String tableName)` For a given principal name and type, list the Table Grants
`List<HiveObjectPrivilege>`	`listDBGrantsAll(String catName, String dbName)` Find all the privileges for a given database.
`List<HiveObjectPrivilege>`	`listDCGrantsAll(String dcName)` Find all the privileges for a given data connector.
`List<HiveObjectPrivilege>`	`listGlobalGrantsAll()`
`List<String>`	`listPackages(ListPackageRequest request)`
`List<HiveObjectPrivilege>`	`listPartitionColumnGrantsAll(String catName, String dbName, String tableName, String partitionName, String columnName)` Find all of the privileges for a given column in a given partition.
`List<HiveObjectPrivilege>`	`listPartitionGrantsAll(String catName, String dbName, String tableName, String partitionName)` Find all of the privileges for a given partition.
`List<String>`	`listPartitionNames(String catName, String db_name, String tbl_name, short max_parts)` Get a partial or complete list of names for partitions of a table.
`List<String>`	`listPartitionNames(String catName, String dbName, String tblName, String defaultPartName, byte[] exprBytes, String order, short maxParts)` Get a partial or complete list of names for partitions of a table.
`List<String>`	`listPartitionNamesPs(String catName, String db_name, String tbl_name, List<String> part_vals, short max_parts)` Lists partition names that match a given partial specification
`List<Partition>`	`listPartitionsPsWithAuth(String catName, String db_name, String tbl_name, GetPartitionsArgs args)` Lists partitions that match a given partial specification and sets their auth privileges.
`default List<Partition>`	`listPartitionsPsWithAuth(String catName, String db_name, String tbl_name, List<String> part_vals, short max_parts, String userName, List<String> groupNames)` Deprecated.
`PartitionValuesResponse`	`listPartitionValues(String catName, String db_name, String tbl_name, List<FieldSchema> cols, boolean applyDistinct, String filter, boolean ascending, List<FieldSchema> order, long maxParts)` Get a list of partition values as one big struct.
`List<HiveObjectPrivilege>`	`listPrincipalDBGrants(String principalName, PrincipalType principalType, String catName, String dbName)` For a given principal name and type, list the DB Grants
`List<HiveObjectPrivilege>`	`listPrincipalDBGrantsAll(String principalName, PrincipalType principalType)` List all DB grants for a given principal.
`List<HiveObjectPrivilege>`	`listPrincipalDCGrants(String principalName, PrincipalType principalType, String dcName)` For a given principal name and type, list the DC Grants
`List<HiveObjectPrivilege>`	`listPrincipalDCGrantsAll(String principalName, PrincipalType principalType)` List all DC grants for a given principal.
`List<HiveObjectPrivilege>`	`listPrincipalGlobalGrants(String principalName, PrincipalType principalType)`
`List<HiveObjectPrivilege>`	`listPrincipalPartitionColumnGrants(String principalName, PrincipalType principalType, String catName, String dbName, String tableName, List<String> partValues, String partName, String columnName)` For a given principal name and type, list the Table Grants
`List<HiveObjectPrivilege>`	`listPrincipalPartitionColumnGrantsAll(String principalName, PrincipalType principalType)` List all Partition column grants for a given principal
`List<HiveObjectPrivilege>`	`listPrincipalPartitionGrants(String principalName, PrincipalType principalType, String catName, String dbName, String tableName, List<String> partValues, String partName)` For a given principal name and type, list the Table Grants
`List<HiveObjectPrivilege>`	`listPrincipalPartitionGrantsAll(String principalName, PrincipalType principalType)` List all Partition grants for a given principal
`List<HiveObjectPrivilege>`	`listPrincipalTableColumnGrants(String principalName, PrincipalType principalType, String catName, String dbName, String tableName, String columnName)` For a given principal name and type, list the Table Grants
`List<HiveObjectPrivilege>`	`listPrincipalTableColumnGrantsAll(String principalName, PrincipalType principalType)` List all Table column grants for a given principal
`List<HiveObjectPrivilege>`	`listPrincipalTableGrantsAll(String principalName, PrincipalType principalType)` List all Table grants for a given principal
`List<RolePrincipalGrant>`	`listRoleMembers(String roleName)` Get the role to principal grant mapping for given role
`List<String>`	`listRoleNames()`
`List<Role>`	`listRoles(String principalName, PrincipalType principalType)`
`List<RolePrincipalGrant>`	`listRolesWithGrants(String principalName, PrincipalType principalType)`
`List<HiveObjectPrivilege>`	`listTableColumnGrantsAll(String catName, String dbName, String tableName, String columnName)` Find all of the privileges for a given column in a given table.
`List<HiveObjectPrivilege>`	`listTableGrantsAll(String catName, String dbName, String tableName)` Find all of the privileges for a given table
`List<String>`	`listTableNamesByFilter(String catName, String dbName, String filter, short max_tables)` Gets a list of tables based on a filter string and filter type.
`Table`	`markPartitionForEvent(String catName, String dbName, String tblName, Map<String,String> partVals, PartitionEventType evtType)`
`int`	`markScheduledExecutionsTimedOut(int timeoutSecs)`
`boolean`	`openTransaction()` Opens a new one or the one already created.
`default boolean`	`openTransaction(String isolationLevel)` Opens a new one or the one already created.
`void`	`putFileMetadata(List<Long> fileIds, List<ByteBuffer> metadata, FileMetadataExprType type)`
`boolean`	`refreshPrivileges(HiveObjectRef objToRefresh, String authorizer, PrivilegeBag grantPrivileges)`
`boolean`	`removeMasterKey(Integer keySeq)`
`boolean`	`removeRole(String roleName)`
`boolean`	`removeToken(String tokenIdentifier)`
`boolean`	`revokePrivileges(PrivilegeBag privileges, boolean grantOption)`
`boolean`	`revokeRole(Role role, String userName, PrincipalType principalType, boolean grantOption)`
`void`	`rollbackTransaction()` Rolls back the current transaction if it is active
`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`	`setMetaStoreSchemaVersion(String version, String comment)`
`void`	`shutdown()`
`void`	`updateCreationMetadata(String catName, String dbname, String tablename, CreationMetadata cm)` Update creation metadata for a materialized view.
`void`	`updateMasterKey(Integer seqNo, String key)`
`Map<String,String>`	`updatePartitionColumnStatistics(ColumnStatistics statsObj, List<String> partVals, String validWriteIds, long writeId)` Persists the given column statistics object to the metastore
`Map<String,String>`	`updatePartitionColumnStatistics(Table table, MTable mTable, ColumnStatistics statsObj, List<String> partVals, String validWriteIds, long writeId)`
`Map<String,Map<String,String>>`	`updatePartitionColumnStatisticsInBatch(Map<String,ColumnStatistics> partColStatsMap, Table tbl, List<TransactionalMetaStoreEventListener> listeners, String validWriteIds, long writeId)`
`Map<String,String>`	`updateTableColumnStatistics(ColumnStatistics colStats, String validWriteIds, long writeId)` Persists the given column statistics object to the metastore
`WMValidateResourcePlanResponse`	`validateResourcePlan(String name, String ns)`
`void`	`verifySchema()`

Methods inherited from interface org.apache.hadoop.conf.Configurable
getConf, setConf

Method Detail

shutdown
```
void shutdown()
```

openTransaction
```
boolean openTransaction()
```
Opens a new one or the one already created. Every call of this function must have corresponding commit or rollback function call.

Returns:

an active transaction

openTransaction
```
default boolean openTransaction(String isolationLevel)
```
Opens a new one or the one already created. Every call of this function must have corresponding commit or rollback function call.

Parameters:

isolationLevel - The transaction isolation level. Only possible to set on the first call.

Returns:

an active transaction

commitTransaction
```
boolean commitTransaction()
```
if this is the commit of the first open call then an actual commit is called.

Returns:

true or false

isActiveTransaction
```
boolean isActiveTransaction()
```

rollbackTransaction
```
void rollbackTransaction()
```
Rolls back the current transaction if it is active

createCatalog
```
void createCatalog(Catalog cat)
            throws MetaException
```
Create a new catalog.

Parameters:

cat - Catalog to create.

Throws:

MetaException - if something goes wrong, usually in storing it to the database.

alterCatalog
```
void alterCatalog(String catName,
                  Catalog cat)
           throws MetaException,
                  InvalidOperationException
```
Alter an existing catalog. Only description and location can be changed, and the change of location is for internal use only.

Parameters:

catName - name of the catalog to alter.

cat - new version of the catalog.

Throws:

MetaException - something went wrong, usually in the database.

InvalidOperationException - attempt to change something about the catalog that is not changeable, like the name.

getCatalog
```
Catalog getCatalog(String catalogName)
            throws NoSuchObjectException,
                   MetaException
```
Get a catalog.

Parameters:

catalogName - name of the catalog.

Returns:

The catalog.

Throws:

NoSuchObjectException - no catalog of this name exists.

MetaException - if something goes wrong, usually in reading it from the database.

getCatalogs
```
List<String> getCatalogs()
```
Get all the catalogs.

Returns:

list of names of all catalogs in the system

dropCatalog
```
void dropCatalog(String catalogName)
          throws NoSuchObjectException,
                 MetaException
```
Drop a catalog. The catalog must be empty.

Parameters:

catalogName - name of the catalog to drop.

Throws:

NoSuchObjectException - no catalog of this name exists.

MetaException - could mean the catalog isn't empty, could mean general database error.

createDatabase
```
void createDatabase(Database db)
             throws InvalidObjectException,
                    MetaException
```
Create a database.

Parameters:

db - database to create.

Throws:

InvalidObjectException - not sure it actually ever throws this.

MetaException - if something goes wrong, usually in writing it to the database.

getDatabase
```
Database getDatabase(String catalogName,
                     String name)
              throws NoSuchObjectException
```
Get a database.

Parameters:

catalogName - catalog the database is in.

name - name of the database.

Returns:

the database.

Throws:

NoSuchObjectException - if no such database exists.

dropDatabase
```
boolean dropDatabase(String catalogName,
                     String dbname)
              throws NoSuchObjectException,
                     MetaException
```
Drop a database.

Parameters:

catalogName - catalog the database is in.

dbname - name of the database.

Returns:

true if the database was dropped, pretty much always returns this if it returns.

Throws:

NoSuchObjectException - no database in this catalog of this name to drop

MetaException - something went wrong, usually with the database.

alterDatabase
```
boolean alterDatabase(String catalogName,
                      String dbname,
                      Database db)
               throws NoSuchObjectException,
                      MetaException
```
Alter a database.

Parameters:

catalogName - name of the catalog the database is in.

dbname - name of the database to alter

db - new version of the database. This should be complete as it will fully replace the existing db object.

Returns:

true if the change succeeds, could fail due to db constraint violations.

Throws:

NoSuchObjectException - no database of this name exists to alter.

MetaException - something went wrong, usually with the database.

getDatabases
```
List<String> getDatabases(String catalogName,
                          String pattern)
                   throws MetaException
```
Get all database in a catalog having names that match a pattern.

Parameters:

catalogName - name of the catalog to search for databases in

pattern - pattern names should match

Returns:

list of matching database names.

Throws:

MetaException - something went wrong, usually with the database.

getAllDatabases
```
List<String> getAllDatabases(String catalogName)
                      throws MetaException
```
Get names of all the databases in a catalog.

Parameters:

catalogName - name of the catalog to search for databases in

Returns:

list of names of all databases in the catalog

Throws:

MetaException - something went wrong, usually with the database.

createDataConnector
```
void createDataConnector(DataConnector dataConnector)
                  throws InvalidObjectException,
                         MetaException
```
Create a dataconnector.

Parameters:

dataConnector - dataconnector to create.

Throws:

InvalidObjectException - not sure it actually ever throws this.

MetaException - if something goes wrong, usually in writing it to the dataconnector.

dropDataConnector
```
boolean dropDataConnector(String dcName)
                   throws NoSuchObjectException,
                          MetaException
```
Drop a dataconnector.

Parameters:

dcName - name of the dataconnector.

Returns:

true if the database was dropped, pretty much always returns this if it returns.

Throws:

NoSuchObjectException - no database in this catalog of this name to drop

MetaException - something went wrong, usually with the database.

alterDataConnector
```
boolean alterDataConnector(String dcName,
                           DataConnector connector)
                    throws NoSuchObjectException,
                           MetaException
```
Alter a dataconnector.

Parameters:

dcName - name of the dataconnector to alter

connector - new version of the dataconnector. This should be complete as it will fully replace the existing db object.

Returns:

true if the change succeeds, false otherwise.

Throws:

NoSuchObjectException - no dataconnector of this name exists to alter.

MetaException - something went wrong, usually with the backend HMSDB.

getDataConnector
```
DataConnector getDataConnector(String dcName)
                        throws NoSuchObjectException
```
Get the dataconnector with a given name, if exists.

Parameters:

dcName - pattern names should match

Returns:

DataConnector object.

Throws:

NoSuchObjectException - something went wrong, usually with the database.

getAllDataConnectorNames
```
List<String> getAllDataConnectorNames()
                               throws MetaException
```
Get names of all the databases in a catalog.

Returns:

list of names of all dataconnectors

Throws:

MetaException - something went wrong, usually with the database.

createType
```
boolean createType(Type type)
```

getType
```
Type getType(String typeName)
```

dropType
```
boolean dropType(String typeName)
```

createTable

void createTable(Table tbl)
          throws InvalidObjectException,
                 MetaException

Throws:: InvalidObjectException; MetaException

dropTable
```
boolean dropTable(String catalogName,
                  String dbName,
                  String tableName)
           throws MetaException,
                  NoSuchObjectException,
                  InvalidObjectException,
                  InvalidInputException
```
Drop a table.

Parameters:

catalogName - catalog the table is in

dbName - database the table is in

tableName - table name

Returns:

true if the table was dropped

Throws:

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

NoSuchObjectException - No table of this name

InvalidObjectException - Don't think this is ever actually thrown

InvalidInputException - Don't think this is ever actually thrown

getTable
```
Table getTable(String catalogName,
               String dbName,
               String tableName)
        throws MetaException
```
Get a table object.

Parameters:

catalogName - catalog the table is in.

dbName - database the table is in.

tableName - table name.

Returns:

table object, or null if no such table exists (wow it would be nice if we either consistently returned null or consistently threw NoSuchObjectException).

Throws:

MetaException - something went wrong in the RDBMS

getTable
```
Table getTable(String catalogName,
               String dbName,
               String tableName,
               String writeIdList)
        throws MetaException
```
Get a table object.

Parameters:

catalogName - catalog the table is in.

dbName - database the table is in.

tableName - table name.

writeIdList - string format of valid writeId transaction list

Returns:

table object, or null if no such table exists (wow it would be nice if we either consistently returned null or consistently threw NoSuchObjectException).

Throws:

MetaException - something went wrong in the RDBMS

getTable
```
Table getTable(String catalogName,
               String dbName,
               String tableName,
               String writeIdList,
               long tableId)
        throws MetaException
```
Get a table object.

Parameters:

catalogName - catalog the table is in.

dbName - database the table is in.

tableName - table name.

writeIdList - string format of valid writeId transaction list

Returns:

table object, or null if no such table exists (wow it would be nice if we either consistently returned null or consistently threw NoSuchObjectException).

Throws:

MetaException - something went wrong in the RDBMS

addPartition
```
boolean addPartition(Partition part)
              throws InvalidObjectException,
                     MetaException
```
Add a partition.

Parameters:

part - partition to add

Returns:

true if the partition was successfully added.

Throws:

InvalidObjectException - the provided partition object is not valid.

MetaException - error writing to the RDBMS.

addPartitions
```
boolean addPartitions(String catName,
                      String dbName,
                      String tblName,
                      List<Partition> parts)
               throws InvalidObjectException,
                      MetaException
```
Add a list of partitions to a table.

Parameters:

catName - catalog name.

dbName - database name.

tblName - table name.

parts - list of partitions to be added.

Returns:

true if the operation succeeded.

Throws:

InvalidObjectException - never throws this AFAICT

MetaException - the partitions don't belong to the indicated table or error writing to the RDBMS.

addPartitions
```
@Deprecated
boolean addPartitions(String catName,
                                  String dbName,
                                  String tblName,
                                  PartitionSpecProxy partitionSpec,
                                  boolean ifNotExists)
                           throws InvalidObjectException,
                                  MetaException
```
Deprecated. use addPartitions(String, String, String, List) instead.

Parameters:

catName - catalog name.

dbName - database name.

tblName - table name.

partitionSpec - specification for the partition

ifNotExists - whether it is in an error if the partition already exists. If true, then it is not an error if the partition exists, if false, it is.

Returns:

whether the partition was created.

Throws:

InvalidObjectException - The passed in partition spec or table specification is invalid.

MetaException - error writing to RDBMS.

getPartition

Partition getPartition(String catName,
                       String dbName,
                       String tableName,
                       List<String> part_vals)
                throws MetaException,
                       NoSuchObjectException

Get a partition.

Parameters:: catName - catalog name.; dbName - database name.; tableName - table name.; part_vals - partition values for this table.
Returns:: the partition.
Throws:: MetaException - error reading from RDBMS.; NoSuchObjectException - no partition matching this specification exists.

getPartition

Partition getPartition(String catName,
                       String dbName,
                       String tableName,
                       List<String> part_vals,
                       String writeIdList)
                throws MetaException,
                       NoSuchObjectException

Get a partition.

Parameters:: catName - catalog name.; dbName - database name.; tableName - table name.; part_vals - partition values for this table.; writeIdList - string format of valid writeId transaction list
Returns:: the partition.
Throws:: MetaException - error reading from RDBMS.; NoSuchObjectException - no partition matching this specification exists.

doesPartitionExist

boolean doesPartitionExist(String catName,
                           String dbName,
                           String tableName,
                           List<FieldSchema> partKeys,
                           List<String> part_vals)
                    throws MetaException,
                           NoSuchObjectException

Check whether a partition exists.

Parameters:: catName - catalog name.; dbName - database name.; tableName - table name.; partKeys - list of partition keys used to generate the partition name.; part_vals - list of partition values.
Returns:: true if the partition exists, false otherwise.
Throws:: MetaException - failure reading RDBMS; NoSuchObjectException - this is never thrown.

dropPartition

@Deprecated
boolean dropPartition(String catName,
                                  String dbName,
                                  String tableName,
                                  List<String> part_vals)
                           throws MetaException,
                                  NoSuchObjectException,
                                  InvalidObjectException,
                                  InvalidInputException

Deprecated.

Drop a partition.

Parameters:: catName - catalog name.; dbName - database name.; tableName - table name.; part_vals - list of partition values.
Returns:: true if the partition was dropped.
Throws:: MetaException - Error accessing the RDBMS.; NoSuchObjectException - no partition matching this description exists; InvalidObjectException - error dropping the statistics for the partition; InvalidInputException - error dropping the statistics for the partition

dropPartition

boolean dropPartition(String catName,
                      String dbName,
                      String tableName,
                      String partName)
               throws MetaException,
                      NoSuchObjectException,
                      InvalidObjectException,
                      InvalidInputException

Drop a partition.

Parameters:: catName - catalog name.; dbName - database name.; tableName - table name.; partName - partition name.
Returns:: true if the partition was dropped.
Throws:: MetaException - Error accessing the RDBMS.; NoSuchObjectException - no partition matching this description exists; InvalidObjectException - error dropping the statistics for the partition; InvalidInputException - error dropping the statistics for the partition

getPartitions

@Deprecated
default List<Partition> getPartitions(String catName,
                                                  String dbName,
                                                  String tableName,
                                                  int max)
                                           throws MetaException,
                                                  NoSuchObjectException

Deprecated.

Get some or all partitions for a table.

Parameters:: catName - catalog name.; dbName - database name.; tableName - table name; max - maximum number of partitions, or -1 to get all partitions.
Returns:: list of partitions
Throws:: MetaException - error access the RDBMS.; NoSuchObjectException - no such table exists

getPartitions

List<Partition> getPartitions(String catName,
                              String dbName,
                              String tableName,
                              GetPartitionsArgs args)
                       throws MetaException,
                              NoSuchObjectException

Get some or all partitions for a table.

Parameters:: catName - catalog name.; dbName - database name.; tableName - table name; args - additional arguments for getting partitions
Returns:: list of partitions
Throws:: MetaException - error access the RDBMS.; NoSuchObjectException - no such table exists

getPartitionLocations
```
Map<String,String> getPartitionLocations(String catName,
                                         String dbName,
                                         String tblName,
                                         String baseLocationToNotShow,
                                         int max)
```
Get the location for every partition of a given table. If a partition location is a child of baseLocationToNotShow then the partitionName is returned, but the only null location is returned.

Parameters:

catName - catalog name.

dbName - database name.

tblName - table name.

baseLocationToNotShow - Partition locations which are child of this path are omitted, and null value returned instead.

max - The maximum number of partition locations returned, or -1 for all

Returns:

The map of the partitionName, location pairs

alterTable
```
Table alterTable(String catName,
                 String dbname,
                 String name,
                 Table newTable,
                 String queryValidWriteIds)
          throws InvalidObjectException,
                 MetaException
```
Alter a table.

Parameters:

catName - catalog the table is in.

dbname - database the table is in.

name - name of the table.

newTable - New table object. Which parts of the table can be altered are implementation specific.

Returns:

Throws:

InvalidObjectException - The new table object is invalid.

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

updateCreationMetadata

void updateCreationMetadata(String catName,
                            String dbname,
                            String tablename,
                            CreationMetadata cm)
                     throws MetaException

Update creation metadata for a materialized view.

Parameters:: catName - catalog name.; dbname - database name.; tablename - table name.; cm - new creation metadata
Throws:: MetaException - error accessing the RDBMS.

getTables
```
List<String> getTables(String catName,
                       String dbName,
                       String pattern)
                throws MetaException
```
Get table names that match a pattern.

Parameters:

catName - catalog to search in

dbName - database to search in

pattern - pattern to match

Returns:

list of table names, if any

Throws:

MetaException - failure in querying the RDBMS

getTables
```
List<String> getTables(String catName,
                       String dbName,
                       String pattern,
                       TableType tableType,
                       int limit)
                throws MetaException
```
Get table names that match a pattern.

Parameters:

catName - catalog to search in

dbName - database to search in

pattern - pattern to match

tableType - type of table to look for

limit - Maximum number of tables to return (undeterministic set)

Returns:

list of table names, if any

Throws:

MetaException - failure in querying the RDBMS

getAllMaterializedViewObjectsForRewriting
```
List<Table> getAllMaterializedViewObjectsForRewriting(String catName)
                                               throws MetaException
```
Retrieve all materialized views.

Returns:

all materialized views in a catalog

Throws:

MetaException - error querying the RDBMS

getMaterializedViewsForRewriting

List<String> getMaterializedViewsForRewriting(String catName,
                                              String dbName)
                                       throws MetaException,
                                              NoSuchObjectException

Get list of materialized views in a database.

Parameters:: catName - catalog name; dbName - database name
Returns:: names of all materialized views in the database
Throws:: MetaException - error querying the RDBMS; NoSuchObjectException - no such database

getTableMeta

List<TableMeta> getTableMeta(String catName,
                             String dbNames,
                             String tableNames,
                             List<String> tableTypes)
                      throws MetaException

Parameters:: catName - catalog name to search in. Search must be confined to one catalog.; dbNames - databases to search in.; tableNames - names of tables to select.; tableTypes - types of tables to look for.
Returns:: list of matching table meta information.
Throws:: MetaException - failure in querying the RDBMS.

getTableObjectsByName
```
List<Table> getTableObjectsByName(String catName,
                                  String dbname,
                                  List<String> tableNames)
                           throws MetaException,
                                  UnknownDBException
```
Parameters:

catName - catalog name

dbname - The name of the database from which to retrieve the tables

tableNames - The names of the tables to retrieve.

Returns:

A list of the tables retrievable from the database whose names are in the list tableNames. If there are duplicate names, only one instance of the table will be returned

Throws:

MetaException - failure in querying the RDBMS.

UnknownDBException

getTableObjectsByName

List<Table> getTableObjectsByName(String catName,
                                  String dbname,
                                  List<String> tableNames,
                                  GetProjectionsSpec projectionSpec,
                                  String tablePattern)
                           throws MetaException,
                                  UnknownDBException

Parameters:: catName - catalog name; dbname - The name of the database from which to retrieve the tables; tableNames - The names of the tables to retrieve.; projectionSpec - Projection Specification containing the columns that need to be returned.
Returns:: A list of the tables retrievable from the database whose names are in the list tableNames. If there are duplicate names, only one instance of the table will be returned
Throws:: MetaException - failure in querying the RDBMS.; UnknownDBException

getAllTables
```
List<String> getAllTables(String catName,
                          String dbName)
                   throws MetaException
```
Get all tables in a database.

Parameters:

catName - catalog name.

dbName - database name.

Returns:

list of table names

Throws:

MetaException - failure in querying the RDBMS.

listTableNamesByFilter

List<String> listTableNamesByFilter(String catName,
                                    String dbName,
                                    String filter,
                                    short max_tables)
                             throws MetaException,
                                    UnknownDBException

Gets a list of tables based on a filter string and filter type.

Parameters:: catName - catalog name; dbName - The name of the database from which you will retrieve the table names; filter - The filter string; max_tables - The maximum number of tables returned
Returns:: A list of table names that match the desired filter
Throws:: MetaException; UnknownDBException

listPartitionNames

List<String> listPartitionNames(String catName,
                                String db_name,
                                String tbl_name,
                                short max_parts)
                         throws MetaException

Get a partial or complete list of names for partitions of a table.

Parameters:: catName - catalog name.; db_name - database name.; tbl_name - table name.; max_parts - maximum number of partitions to retrieve, -1 for all.
Returns:: list of partition names.
Throws:: MetaException - there was an error accessing the RDBMS

listPartitionNames

List<String> listPartitionNames(String catName,
                                String dbName,
                                String tblName,
                                String defaultPartName,
                                byte[] exprBytes,
                                String order,
                                short maxParts)
                         throws MetaException,
                                NoSuchObjectException

Get a partial or complete list of names for partitions of a table.

Parameters:: catName - catalog name.; dbName - database name.; tblName - table name.; defaultPartName - default partition name.; exprBytes - expression for filtering resulting list, serialized from ExprNodeDesc.; order - ordered the resulting list.; maxParts - maximum number of partitions to retrieve, -1 for all.
Returns:: list of partition names.
Throws:: MetaException - there was an error accessing the RDBMS; NoSuchObjectException

listPartitionValues

PartitionValuesResponse listPartitionValues(String catName,
                                            String db_name,
                                            String tbl_name,
                                            List<FieldSchema> cols,
                                            boolean applyDistinct,
                                            String filter,
                                            boolean ascending,
                                            List<FieldSchema> order,
                                            long maxParts)
                                     throws MetaException

Get a list of partition values as one big struct.

Parameters:: catName - catalog name.; db_name - database name.; tbl_name - table name.; cols - partition key columns; applyDistinct - whether to apply distinct to the list; filter - filter to apply to the partition names; ascending - whether to put in ascending order; order - whether to order; maxParts - maximum number of parts to return, or -1 for all
Returns:: struct with all of the partition value information
Throws:: MetaException - error access the RDBMS

alterPartition

Partition alterPartition(String catName,
                         String db_name,
                         String tbl_name,
                         List<String> part_vals,
                         Partition new_part,
                         String queryValidWriteIds)
                  throws InvalidObjectException,
                         MetaException

Alter a partition.

Parameters:: catName - catalog name.; db_name - database name.; tbl_name - table name.; part_vals - partition values that describe the partition.; new_part - new partition object. This should be a complete copy of the old with changes values, not just the parts to update.
Returns:
Throws:: InvalidObjectException - No such partition.; MetaException - error accessing the RDBMS.

alterPartitions
```
List<Partition> alterPartitions(String catName,
                                String db_name,
                                String tbl_name,
                                List<List<String>> part_vals_list,
                                List<Partition> new_parts,
                                long writeId,
                                String queryValidWriteIds)
                         throws InvalidObjectException,
                                MetaException
```
Alter a set of partitions.

Parameters:

catName - catalog name.

db_name - database name.

tbl_name - table name.

part_vals_list - list of list of partition values. Each outer list describes one partition (with its list of partition values).

new_parts - list of new partitions. The order must match the old partitions described in part_vals_list. Each of these should be a complete copy of the new partition, not just the pieces to update.

writeId - write id of the transaction for the table

queryValidWriteIds - valid write id list of the transaction on the current table

Returns:

Throws:

InvalidObjectException - One of the indicated partitions does not exist.

MetaException - error accessing the RDBMS.

getPartitionsByFilter

@Deprecated
default List<Partition> getPartitionsByFilter(String catName,
                                                          String dbName,
                                                          String tblName,
                                                          String filter,
                                                          short maxParts)
                                                   throws MetaException,
                                                          NoSuchObjectException

Deprecated.

Get partitions with a filter. This is a portion of the SQL where clause.

Parameters:: catName - catalog name; dbName - database name; tblName - table name; filter - SQL where clause filter; maxParts - maximum number of partitions to return, or -1 for all.
Returns:: list of partition objects matching the criteria
Throws:: MetaException - Error accessing the RDBMS or processing the filter.; NoSuchObjectException - no such table.

getPartitionsByFilter

List<Partition> getPartitionsByFilter(String catName,
                                      String dbName,
                                      String tblName,
                                      GetPartitionsArgs args)
                               throws MetaException,
                                      NoSuchObjectException

Get partitions with a filter. This is a portion of the SQL where clause.

Parameters:: catName - catalog name; dbName - database name; tblName - table name; args - additional arguments for getting partitions
Returns:: list of partition objects matching the criteria
Throws:: MetaException - Error accessing the RDBMS or processing the filter.; NoSuchObjectException - no such table.

getPartitionSpecsByFilterAndProjection
```
List<Partition> getPartitionSpecsByFilterAndProjection(Table table,
                                                       GetProjectionsSpec projectionSpec,
                                                       GetPartitionsFilterSpec filterSpec)
                                                throws MetaException,
                                                       NoSuchObjectException
```
Generic Partition request API, providing different kinds of filtering and controlling output.

Parameters:

table - table for which whose partitions are requested * @param table table for which partitions are requested

projectionSpec - the projection spec from the GetPartitionsRequest This projection spec includes a fieldList which represents the fields which must be returned. Any other field which is not in the fieldList may be unset in the returned partitions (it is up to the implementation to decide whether it chooses to include or exclude such fields). E.g. setting the field list to sd.location, serdeInfo.name, sd.cols.name, sd.cols.type will return partitions which will have location field set in the storage descriptor. Also the serdeInf in the returned storage descriptor will only have name field set. This applies to multi-valued fields as well like sd.cols, so in the example above only name and type fields will be set for sd.cols. If the fieldList is empty or not present, all the fields will be set. Additionally, it also includes a includeParamKeyPattern and excludeParamKeyPattern which is a SQL-92 compliant regex pattern to include or exclude parameters. The paramKeyPattern supports _ or % wildcards which represent one character and 0 or more characters respectively

filterSpec - The filter spec from GetPartitionsRequest which includes the filter mode and the list of filter strings. The filter mode could be BY_NAMES, BY_VALUES or BY_EXPR to filter by partition names, partition values or expression. The filter strings are provided in the list of filters within the filterSpec. When more than one filters are provided in the list they are logically AND together

Returns:

List of matching partitions which which may be partially filled according to fieldList.

Throws:

MetaException - in case of errors

NoSuchObjectException - when table isn't found

getPartitionsByExpr

@Deprecated
default boolean getPartitionsByExpr(String catName,
                                                String dbName,
                                                String tblName,
                                                byte[] expr,
                                                String defaultPartitionName,
                                                short maxParts,
                                                List<Partition> result)
                                         throws org.apache.thrift.TException

Deprecated.

Get partitions using an already parsed expression.

Parameters:: catName - catalog name.; dbName - database name; tblName - table name; expr - an already parsed Hive expression; defaultPartitionName - default name of a partition; maxParts - maximum number of partitions to return, or -1 for all; result - list to place resulting partitions in
Returns:: true if the result contains unknown partitions.
Throws:: org.apache.thrift.TException - error executing the expression

getPartitionsByExpr

boolean getPartitionsByExpr(String catName,
                            String dbName,
                            String tblName,
                            List<Partition> result,
                            GetPartitionsArgs args)
                     throws org.apache.thrift.TException

Get partitions using an already parsed expression.

Parameters:: catName - catalog name.; dbName - database name; tblName - table name; args - additional arguments for getting partitions
Returns:: true if the result contains unknown partitions.
Throws:: org.apache.thrift.TException - error executing the expression

getNumPartitionsByFilter

int getNumPartitionsByFilter(String catName,
                             String dbName,
                             String tblName,
                             String filter)
                      throws MetaException,
                             NoSuchObjectException

Get the number of partitions that match a provided SQL filter.

Parameters:: catName - catalog name.; dbName - database name.; tblName - table name.; filter - filter from Hive's SQL where clause
Returns:: number of matching partitions.
Throws:: MetaException - error accessing the RDBMS or executing the filter; NoSuchObjectException - no such table

getNumPartitionsByExpr
```
int getNumPartitionsByExpr(String catName,
                           String dbName,
                           String tblName,
                           byte[] expr)
                    throws MetaException,
                           NoSuchObjectException
```
Get the number of partitions that match an already parsed expression.

Parameters:

catName - catalog name.

dbName - database name.

tblName - table name.

expr - an already parsed Hive expression

Returns:

number of matching partitions.

Throws:

MetaException - error accessing the RDBMS or working with the expression.

NoSuchObjectException - no such table.

getNumPartitionsByPs
```
int getNumPartitionsByPs(String catName,
                         String dbName,
                         String tblName,
                         List<String> partVals)
                  throws MetaException,
                         NoSuchObjectException
```
Get the number of partitions that match a given partial specification.

Parameters:

catName - catalog name.

dbName - database name.

tblName - table name.

partVals - A partial list of values for partitions in order of the table's partition keys. Entries can be empty if you need to specify latter partitions.

Returns:

number of matching partitions.

Throws:

MetaException - error accessing the RDBMS or working with the specification.

NoSuchObjectException - no such table.

getPartitionsByNames

default List<Partition> getPartitionsByNames(String catName,
                                             String dbName,
                                             String tblName,
                                             List<String> partNames)
                                      throws MetaException,
                                             NoSuchObjectException

Get partitions by name.

Parameters:: catName - catalog name.; dbName - database name.; tblName - table name.; partNames - list of partition names. These are names not values, so they will include both the key and the value.
Returns:: list of matching partitions
Throws:: MetaException - error accessing the RDBMS.; NoSuchObjectException - No such table.

getPartitionsByNames

List<Partition> getPartitionsByNames(String catName,
                                     String dbName,
                                     String tblName,
                                     GetPartitionsArgs args)
                              throws MetaException,
                                     NoSuchObjectException

Get partitions by name.

Parameters:: catName - catalog name.; dbName - database name.; tblName - table name.; args - additional arguments for getting partitions
Returns:: list of matching partitions
Throws:: MetaException - error accessing the RDBMS.; NoSuchObjectException - No such table.

markPartitionForEvent

Table markPartitionForEvent(String catName,
                            String dbName,
                            String tblName,
                            Map<String,String> partVals,
                            PartitionEventType evtType)
                     throws MetaException,
                            UnknownTableException,
                            InvalidPartitionException,
                            UnknownPartitionException

Throws:: MetaException; UnknownTableException; InvalidPartitionException; UnknownPartitionException

isPartitionMarkedForEvent

boolean isPartitionMarkedForEvent(String catName,
                                  String dbName,
                                  String tblName,
                                  Map<String,String> partName,
                                  PartitionEventType evtType)
                           throws MetaException,
                                  UnknownTableException,
                                  InvalidPartitionException,
                                  UnknownPartitionException

Throws:: MetaException; UnknownTableException; InvalidPartitionException; UnknownPartitionException

addRole

boolean addRole(String rowName,
                String ownerName)
         throws InvalidObjectException,
                MetaException,
                NoSuchObjectException

Throws:: InvalidObjectException; MetaException; NoSuchObjectException

removeRole

boolean removeRole(String roleName)
            throws MetaException,
                   NoSuchObjectException

Throws:: MetaException; NoSuchObjectException

grantRole

boolean grantRole(Role role,
                  String userName,
                  PrincipalType principalType,
                  String grantor,
                  PrincipalType grantorType,
                  boolean grantOption)
           throws MetaException,
                  NoSuchObjectException,
                  InvalidObjectException

Throws:: MetaException; NoSuchObjectException; InvalidObjectException

revokeRole

boolean revokeRole(Role role,
                   String userName,
                   PrincipalType principalType,
                   boolean grantOption)
            throws MetaException,
                   NoSuchObjectException

Throws:: MetaException; NoSuchObjectException

getUserPrivilegeSet

PrincipalPrivilegeSet getUserPrivilegeSet(String userName,
                                          List<String> groupNames)
                                   throws InvalidObjectException,
                                          MetaException

Throws:: InvalidObjectException; MetaException

getDBPrivilegeSet

PrincipalPrivilegeSet getDBPrivilegeSet(String catName,
                                        String dbName,
                                        String userName,
                                        List<String> groupNames)
                                 throws InvalidObjectException,
                                        MetaException

Get privileges for a database for a user.

Parameters:: catName - catalog name; dbName - database name; userName - user name; groupNames - list of groups the user is in
Returns:: privileges for that user on indicated database
Throws:: InvalidObjectException - no such database; MetaException - error accessing the RDBMS

getConnectorPrivilegeSet

PrincipalPrivilegeSet getConnectorPrivilegeSet(String catName,
                                               String connectorName,
                                               String userName,
                                               List<String> groupNames)
                                        throws InvalidObjectException,
                                               MetaException

Get privileges for a connector for a user.

Parameters:: catName - catalog name; connectorName - connector name; userName - user name; groupNames - list of groups the user is in
Returns:: privileges for that user on indicated connector
Throws:: InvalidObjectException - no such database; MetaException - error accessing the RDBMS

getTablePrivilegeSet

PrincipalPrivilegeSet getTablePrivilegeSet(String catName,
                                           String dbName,
                                           String tableName,
                                           String userName,
                                           List<String> groupNames)
                                    throws InvalidObjectException,
                                           MetaException

Get privileges for a table for a user.

Parameters:: catName - catalog name; dbName - database name; tableName - table name; userName - user name; groupNames - list of groups the user is in
Returns:: privileges for that user on indicated table
Throws:: InvalidObjectException - no such table; MetaException - error accessing the RDBMS

getPartitionPrivilegeSet

PrincipalPrivilegeSet getPartitionPrivilegeSet(String catName,
                                               String dbName,
                                               String tableName,
                                               String partition,
                                               String userName,
                                               List<String> groupNames)
                                        throws InvalidObjectException,
                                               MetaException

Get privileges for a partition for a user.

Parameters:: catName - catalog name; dbName - database name; tableName - table name; partition - partition name; userName - user name; groupNames - list of groups the user is in
Returns:: privileges for that user on indicated partition
Throws:: InvalidObjectException - no such partition; MetaException - error accessing the RDBMS

getColumnPrivilegeSet

PrincipalPrivilegeSet getColumnPrivilegeSet(String catName,
                                            String dbName,
                                            String tableName,
                                            String partitionName,
                                            String columnName,
                                            String userName,
                                            List<String> groupNames)
                                     throws InvalidObjectException,
                                            MetaException

Get privileges for a column in a table or partition for a user.

Parameters:: catName - catalog name; dbName - database name; tableName - table name; partitionName - partition name, or null for table level column permissions; columnName - column name; userName - user name; groupNames - list of groups the user is in
Returns:: privileges for that user on indicated column in the table or partition
Throws:: InvalidObjectException - no such table, partition, or column; MetaException - error accessing the RDBMS

listPrincipalGlobalGrants

List<HiveObjectPrivilege> listPrincipalGlobalGrants(String principalName,
                                                    PrincipalType principalType)

listPrincipalDBGrants

List<HiveObjectPrivilege> listPrincipalDBGrants(String principalName,
                                                PrincipalType principalType,
                                                String catName,
                                                String dbName)

For a given principal name and type, list the DB Grants

Parameters:: principalName - principal name; principalType - type; catName - catalog name; dbName - database name
Returns:: list of privileges for that principal on the specified database.

listPrincipalDCGrants

List<HiveObjectPrivilege> listPrincipalDCGrants(String principalName,
                                                PrincipalType principalType,
                                                String dcName)

For a given principal name and type, list the DC Grants

Parameters:: principalName - principal name; principalType - type; dcName - data connector name
Returns:: list of privileges for that principal on the specified data connector.

listAllTableGrants

List<HiveObjectPrivilege> listAllTableGrants(String principalName,
                                             PrincipalType principalType,
                                             String catName,
                                             String dbName,
                                             String tableName)

For a given principal name and type, list the Table Grants

Parameters:: principalName - principal name; principalType - type; catName - catalog name; dbName - database name; tableName - table name
Returns:: list of privileges for that principal on the specified database.

listPrincipalPartitionGrants

List<HiveObjectPrivilege> listPrincipalPartitionGrants(String principalName,
                                                       PrincipalType principalType,
                                                       String catName,
                                                       String dbName,
                                                       String tableName,
                                                       List<String> partValues,
                                                       String partName)

For a given principal name and type, list the Table Grants

Parameters:: principalName - principal name; principalType - type; catName - catalog name; dbName - database name; tableName - table name; partName - partition name (not value)
Returns:: list of privileges for that principal on the specified database.

listPrincipalTableColumnGrants

List<HiveObjectPrivilege> listPrincipalTableColumnGrants(String principalName,
                                                         PrincipalType principalType,
                                                         String catName,
                                                         String dbName,
                                                         String tableName,
                                                         String columnName)

For a given principal name and type, list the Table Grants

Parameters:: principalName - principal name; principalType - type; catName - catalog name; dbName - database name; tableName - table name; columnName - column name
Returns:: list of privileges for that principal on the specified database.

listPrincipalPartitionColumnGrants

List<HiveObjectPrivilege> listPrincipalPartitionColumnGrants(String principalName,
                                                             PrincipalType principalType,
                                                             String catName,
                                                             String dbName,
                                                             String tableName,
                                                             List<String> partValues,
                                                             String partName,
                                                             String columnName)

For a given principal name and type, list the Table Grants

Parameters:: principalName - principal name; principalType - type; catName - catalog name; dbName - database name; tableName - table name; partName - partition name (not value); columnName - column name
Returns:: list of privileges for that principal on the specified database.

grantPrivileges

boolean grantPrivileges(PrivilegeBag privileges)
                 throws InvalidObjectException,
                        MetaException,
                        NoSuchObjectException

Throws:: InvalidObjectException; MetaException; NoSuchObjectException

revokePrivileges

boolean revokePrivileges(PrivilegeBag privileges,
                         boolean grantOption)
                  throws InvalidObjectException,
                         MetaException,
                         NoSuchObjectException

Throws:: InvalidObjectException; MetaException; NoSuchObjectException

refreshPrivileges

boolean refreshPrivileges(HiveObjectRef objToRefresh,
                          String authorizer,
                          PrivilegeBag grantPrivileges)
                   throws InvalidObjectException,
                          MetaException,
                          NoSuchObjectException

Throws:: InvalidObjectException; MetaException; NoSuchObjectException

getRole

Role getRole(String roleName)
      throws NoSuchObjectException

Throws:: NoSuchObjectException

listRoleNames
```
List<String> listRoleNames()
```

listRoles

List<Role> listRoles(String principalName,
                     PrincipalType principalType)

listRolesWithGrants

List<RolePrincipalGrant> listRolesWithGrants(String principalName,
                                             PrincipalType principalType)

listRoleMembers
```
List<RolePrincipalGrant> listRoleMembers(String roleName)
```
Get the role to principal grant mapping for given role

Parameters:

roleName -

Returns:

getPartitionWithAuth

Partition getPartitionWithAuth(String catName,
                               String dbName,
                               String tblName,
                               List<String> partVals,
                               String user_name,
                               List<String> group_names)
                        throws MetaException,
                               NoSuchObjectException,
                               InvalidObjectException

Fetch a partition along with privilege information for a particular user.

Parameters:: catName - catalog name.; dbName - database name.; tblName - table name.; partVals - partition values; user_name - user to get privilege information for.; group_names - groups to get privilege information for.
Returns:: a partition
Throws:: MetaException - error accessing the RDBMS.; NoSuchObjectException - no such partition exists; InvalidObjectException - error fetching privilege information

getPartitionsWithAuth

@Deprecated
default List<Partition> getPartitionsWithAuth(String catName,
                                                          String dbName,
                                                          String tblName,
                                                          short maxParts,
                                                          String userName,
                                                          List<String> groupNames)
                                                   throws MetaException,
                                                          NoSuchObjectException,
                                                          InvalidObjectException

Deprecated.

Fetch some or all partitions for a table, along with privilege information for a particular user.

Parameters:: catName - catalog name.; dbName - database name.; tblName - table name.; maxParts - maximum number of partitions to fetch, -1 for all partitions.; userName - user to get privilege information for.; groupNames - groups to get privilege information for.
Returns:: list of partitions.
Throws:: MetaException - error access the RDBMS.; NoSuchObjectException - no such table exists; InvalidObjectException - error fetching privilege information.

listPartitionNamesPs
```
List<String> listPartitionNamesPs(String catName,
                                  String db_name,
                                  String tbl_name,
                                  List<String> part_vals,
                                  short max_parts)
                           throws MetaException,
                                  NoSuchObjectException
```
Lists partition names that match a given partial specification

Parameters:

catName - catalog name.

db_name - The name of the database which has the partitions

tbl_name - The name of the table which has the partitions

part_vals - A partial list of values for partitions in order of the table's partition keys. Entries can be empty if you only want to specify latter partitions.

max_parts - The maximum number of partitions to return

Returns:

A list of partition names that match the partial spec.

Throws:

MetaException - error accessing RDBMS

NoSuchObjectException - No such table exists

listPartitionsPsWithAuth

@Deprecated
default List<Partition> listPartitionsPsWithAuth(String catName,
                                                             String db_name,
                                                             String tbl_name,
                                                             List<String> part_vals,
                                                             short max_parts,
                                                             String userName,
                                                             List<String> groupNames)
                                                      throws MetaException,
                                                             InvalidObjectException,
                                                             NoSuchObjectException

Deprecated.

Lists partitions that match a given partial specification and sets their auth privileges. If userName and groupNames null, then no auth privileges are set.

Parameters:: catName - catalog name.; db_name - The name of the database which has the partitions; tbl_name - The name of the table which has the partitions; part_vals - A partial list of values for partitions in order of the table's partition keys Entries can be empty if you need to specify latter partitions.; max_parts - The maximum number of partitions to return; userName - The user name for the partition for authentication privileges; groupNames - The groupNames for the partition for authentication privileges
Returns:: A list of partitions that match the partial spec.
Throws:: MetaException - error access RDBMS; NoSuchObjectException - No such table exists; InvalidObjectException - error access privilege information

listPartitionsPsWithAuth

List<Partition> listPartitionsPsWithAuth(String catName,
                                         String db_name,
                                         String tbl_name,
                                         GetPartitionsArgs args)
                                  throws MetaException,
                                         InvalidObjectException,
                                         NoSuchObjectException

Lists partitions that match a given partial specification and sets their auth privileges. If userName and groupNames null, then no auth privileges are set.

Parameters:: catName - catalog name.; db_name - The name of the database which has the partitions; tbl_name - The name of the table which has the partitions; args - additional arguments for getting partitions
Returns:: A list of partitions that match the partial spec.
Throws:: MetaException - error access RDBMS; NoSuchObjectException - No such table exists; InvalidObjectException - error access privilege information

updateTableColumnStatistics

Map<String,String> updateTableColumnStatistics(ColumnStatistics colStats,
                                               String validWriteIds,
                                               long writeId)
                                        throws NoSuchObjectException,
                                               MetaException,
                                               InvalidObjectException,
                                               InvalidInputException

Persists the given column statistics object to the metastore

Parameters:: colStats - object to persist
Returns:: Boolean indicating the outcome of the operation
Throws:: NoSuchObjectException - No such table.; MetaException - error accessing the RDBMS.; InvalidObjectException - the stats object is invalid; InvalidInputException - unable to record the stats for the table

updatePartitionColumnStatistics

Map<String,String> updatePartitionColumnStatistics(ColumnStatistics statsObj,
                                                   List<String> partVals,
                                                   String validWriteIds,
                                                   long writeId)
                                            throws NoSuchObjectException,
                                                   MetaException,
                                                   InvalidObjectException,
                                                   InvalidInputException

Persists the given column statistics object to the metastore

Parameters:: statsObj - object to persist; partVals - partition values to persist the stats for
Returns:: Boolean indicating the outcome of the operation
Throws:: NoSuchObjectException - No such table.; MetaException - error accessing the RDBMS.; InvalidObjectException - the stats object is invalid; InvalidInputException - unable to record the stats for the table

updatePartitionColumnStatistics

Map<String,String> updatePartitionColumnStatistics(Table table,
                                                   MTable mTable,
                                                   ColumnStatistics statsObj,
                                                   List<String> partVals,
                                                   String validWriteIds,
                                                   long writeId)
                                            throws NoSuchObjectException,
                                                   MetaException,
                                                   InvalidObjectException,
                                                   InvalidInputException

Throws:: NoSuchObjectException; MetaException; InvalidObjectException; InvalidInputException

getTableColumnStatistics

List<ColumnStatistics> getTableColumnStatistics(String catName,
                                                String dbName,
                                                String tableName,
                                                List<String> colName)
                                         throws MetaException,
                                                NoSuchObjectException

Returns the relevant column statistics for a given column in a given table in a given database if such statistics exist.

Parameters:: catName - catalog name.; dbName - name of the database, defaults to current database; tableName - name of the table; colName - names of the columns for which statistics is requested
Returns:: Relevant column statistics for the column for the given table
Throws:: NoSuchObjectException - No such table; MetaException - error accessing the RDBMS

getTableColumnStatistics

ColumnStatistics getTableColumnStatistics(String catName,
                                          String dbName,
                                          String tableName,
                                          List<String> colName,
                                          String engine)
                                   throws MetaException,
                                          NoSuchObjectException

Returns the relevant column statistics for a given column in a given table in a given database if such statistics exist.

Parameters:: catName - catalog name.; dbName - name of the database, defaults to current database; tableName - name of the table; colName - names of the columns for which statistics is requested; engine - engine requesting the statistics
Returns:: Relevant column statistics for the column for the given table
Throws:: NoSuchObjectException - No such table; MetaException - error accessing the RDBMS

getTableColumnStatistics

ColumnStatistics getTableColumnStatistics(String catName,
                                          String dbName,
                                          String tableName,
                                          List<String> colName,
                                          String engine,
                                          String writeIdList)
                                   throws MetaException,
                                          NoSuchObjectException

Returns the relevant column statistics for a given column in a given table in a given database if such statistics exist.

Parameters:: catName - catalog name.; dbName - name of the database, defaults to current database; tableName - name of the table; colName - names of the columns for which statistics is requested; engine - engine requesting the statistics; writeIdList - string format of valid writeId transaction list
Returns:: Relevant column statistics for the column for the given table
Throws:: NoSuchObjectException - No such table; MetaException - error accessing the RDBMS

getPartitionColumnStatistics

List<List<ColumnStatistics>> getPartitionColumnStatistics(String catName,
                                                          String dbName,
                                                          String tblName,
                                                          List<String> partNames,
                                                          List<String> colNames)
                                                   throws MetaException,
                                                          NoSuchObjectException

Get statistics for a partition for a set of columns.

Parameters:: catName - catalog name.; dbName - database name.; tblName - table name.; partNames - list of partition names. These are names so must be key1=val1[/key2=val2...]; colNames - list of columns to get stats for
Returns:: list of statistics objects
Throws:: MetaException - error accessing the RDBMS; NoSuchObjectException - no such partition.

getPartitionColumnStatistics

List<ColumnStatistics> getPartitionColumnStatistics(String catName,
                                                    String dbName,
                                                    String tblName,
                                                    List<String> partNames,
                                                    List<String> colNames,
                                                    String engine)
                                             throws MetaException,
                                                    NoSuchObjectException

Get statistics for a partition for a set of columns.

Parameters:: catName - catalog name.; dbName - database name.; tblName - table name.; partNames - list of partition names. These are names so must be key1=val1[/key2=val2...]; colNames - list of columns to get stats for; engine - engine requesting the statistics
Returns:: list of statistics objects
Throws:: MetaException - error accessing the RDBMS; NoSuchObjectException - no such partition.

getPartitionColumnStatistics

List<ColumnStatistics> getPartitionColumnStatistics(String catName,
                                                    String dbName,
                                                    String tblName,
                                                    List<String> partNames,
                                                    List<String> colNames,
                                                    String engine,
                                                    String writeIdList)
                                             throws MetaException,
                                                    NoSuchObjectException

Get statistics for a partition for a set of columns.

Parameters:: catName - catalog name.; dbName - database name.; tblName - table name.; partNames - list of partition names. These are names so must be key1=val1[/key2=val2...]; colNames - list of columns to get stats for; engine - engine requesting the statistics; writeIdList - string format of valid writeId transaction list
Returns:: list of statistics objects
Throws:: MetaException - error accessing the RDBMS; NoSuchObjectException - no such partition.

deletePartitionColumnStatistics

boolean deletePartitionColumnStatistics(String catName,
                                        String dbName,
                                        String tableName,
                                        String partName,
                                        List<String> partVals,
                                        String colName,
                                        String engine)
                                 throws NoSuchObjectException,
                                        MetaException,
                                        InvalidObjectException,
                                        InvalidInputException

Deletes column statistics if present associated with a given db, table, partition and col. If null is passed instead of a colName, stats when present for all columns associated with a given db, table and partition are deleted.

Parameters:: catName - catalog name.; dbName - database name.; tableName - table name.; partName - partition name.; partVals - partition values.; colName - column name.; engine - engine for which we want to delete statistics
Returns:: Boolean indicating the outcome of the operation
Throws:: NoSuchObjectException - no such partition; MetaException - error access the RDBMS; InvalidObjectException - error dropping the stats; InvalidInputException - bad input, such as null table or database name.

deleteTableColumnStatistics

boolean deleteTableColumnStatistics(String catName,
                                    String dbName,
                                    String tableName,
                                    String colName,
                                    String engine)
                             throws NoSuchObjectException,
                                    MetaException,
                                    InvalidObjectException,
                                    InvalidInputException

Delete statistics for a single column or all columns in a table.

Parameters:: catName - catalog name; dbName - database name; tableName - table name; colName - column name. Null to delete stats for all columns in the table.; engine - engine for which we want to delete statistics
Returns:: true if the statistics were deleted.
Throws:: NoSuchObjectException - no such table or column.; MetaException - error access the RDBMS.; InvalidObjectException - error dropping the stats; InvalidInputException - bad inputs, such as null table name.

cleanupEvents
```
long cleanupEvents()
```

addToken

boolean addToken(String tokenIdentifier,
                 String delegationToken)

removeToken

boolean removeToken(String tokenIdentifier)

getToken

String getToken(String tokenIdentifier)

getAllTokenIdentifiers
```
List<String> getAllTokenIdentifiers()
```

addMasterKey

int addMasterKey(String key)
          throws MetaException

Throws:: MetaException

updateMasterKey

void updateMasterKey(Integer seqNo,
                     String key)
              throws NoSuchObjectException,
                     MetaException

Throws:: NoSuchObjectException; MetaException

removeMasterKey

boolean removeMasterKey(Integer keySeq)

getMasterKeys
```
String[] getMasterKeys()
```

verifySchema

void verifySchema()
           throws MetaException

Throws:: MetaException

getMetaStoreSchemaVersion

String getMetaStoreSchemaVersion()
                          throws MetaException

Throws:: MetaException

setMetaStoreSchemaVersion

void setMetaStoreSchemaVersion(String version,
                               String comment)
                        throws MetaException

Throws:: MetaException

dropPartitions

void dropPartitions(String catName,
                    String dbName,
                    String tblName,
                    List<String> partNames)
             throws MetaException,
                    NoSuchObjectException

Drop a list of partitions.

Parameters:: catName - catalog name.; dbName - database name.; tblName - table name; partNames - list of partition names.
Throws:: MetaException - error access RDBMS or storage.; NoSuchObjectException - One or more of the partitions does not exist.

listPrincipalDBGrantsAll

List<HiveObjectPrivilege> listPrincipalDBGrantsAll(String principalName,
                                                   PrincipalType principalType)

List all DB grants for a given principal.

Parameters:: principalName - principal name; principalType - type
Returns:: all DB grants for this principal

listPrincipalDCGrantsAll

List<HiveObjectPrivilege> listPrincipalDCGrantsAll(String principalName,
                                                   PrincipalType principalType)

List all DC grants for a given principal.

Parameters:: principalName - principal name; principalType - type
Returns:: all DC grants for this principal

listPrincipalTableGrantsAll

List<HiveObjectPrivilege> listPrincipalTableGrantsAll(String principalName,
                                                      PrincipalType principalType)

List all Table grants for a given principal

Parameters:: principalName - principal name; principalType - type
Returns:: all Table grants for this principal

listPrincipalPartitionGrantsAll

List<HiveObjectPrivilege> listPrincipalPartitionGrantsAll(String principalName,
                                                          PrincipalType principalType)

List all Partition grants for a given principal

Parameters:: principalName - principal name; principalType - type
Returns:: all Partition grants for this principal

listPrincipalTableColumnGrantsAll

List<HiveObjectPrivilege> listPrincipalTableColumnGrantsAll(String principalName,
                                                            PrincipalType principalType)

List all Table column grants for a given principal

Parameters:: principalName - principal name; principalType - type
Returns:: all Table column grants for this principal

listPrincipalPartitionColumnGrantsAll

List<HiveObjectPrivilege> listPrincipalPartitionColumnGrantsAll(String principalName,
                                                                PrincipalType principalType)

List all Partition column grants for a given principal

Parameters:: principalName - principal name; principalType - type
Returns:: all Partition column grants for this principal

listGlobalGrantsAll

List<HiveObjectPrivilege> listGlobalGrantsAll()

listDBGrantsAll

List<HiveObjectPrivilege> listDBGrantsAll(String catName,
                                          String dbName)

Find all the privileges for a given database.

Parameters:: catName - catalog name; dbName - database name
Returns:: list of all privileges.

listDCGrantsAll
```
List<HiveObjectPrivilege> listDCGrantsAll(String dcName)
```
Find all the privileges for a given data connector.

Parameters:

dcName - data connector name

Returns:

list of all privileges.

listPartitionColumnGrantsAll

List<HiveObjectPrivilege> listPartitionColumnGrantsAll(String catName,
                                                       String dbName,
                                                       String tableName,
                                                       String partitionName,
                                                       String columnName)

Find all of the privileges for a given column in a given partition.

Parameters:: catName - catalog name; dbName - database name; tableName - table name; partitionName - partition name (not value); columnName - column name
Returns:: all privileges on this column in this partition

listTableGrantsAll

List<HiveObjectPrivilege> listTableGrantsAll(String catName,
                                             String dbName,
                                             String tableName)

Find all of the privileges for a given table

Parameters:: catName - catalog name; dbName - database name; tableName - table name
Returns:: all privileges on this table

listPartitionGrantsAll

List<HiveObjectPrivilege> listPartitionGrantsAll(String catName,
                                                 String dbName,
                                                 String tableName,
                                                 String partitionName)

Find all of the privileges for a given partition.

Parameters:: catName - catalog name; dbName - database name; tableName - table name; partitionName - partition name (not value)
Returns:: all privileges on this partition

listTableColumnGrantsAll

List<HiveObjectPrivilege> listTableColumnGrantsAll(String catName,
                                                   String dbName,
                                                   String tableName,
                                                   String columnName)

Find all of the privileges for a given column in a given table.

Parameters:: catName - catalog name; dbName - database name; tableName - table name; columnName - column name
Returns:: all privileges on this column in this table

createFunction
```
void createFunction(Function func)
             throws InvalidObjectException,
                    MetaException
```
Register a user-defined function based on the function specification passed in.

Parameters:

func - function to create

Throws:

InvalidObjectException - incorrectly specified function

MetaException - error accessing the RDBMS

alterFunction

void alterFunction(String catName,
                   String dbName,
                   String funcName,
                   Function newFunction)
            throws InvalidObjectException,
                   MetaException

Alter function based on new function specs.

Parameters:: dbName - database name; funcName - function name; newFunction - new function specification
Throws:: InvalidObjectException - no such function, or incorrectly specified new function; MetaException - incorrectly specified function

dropFunction

void dropFunction(String catName,
                  String dbName,
                  String funcName)
           throws MetaException,
                  NoSuchObjectException,
                  InvalidObjectException,
                  InvalidInputException

Drop a function definition.

Parameters:: dbName - database name; funcName - function name
Throws:: MetaException - incorrectly specified function; NoSuchObjectException - no such function; InvalidObjectException - not sure when this is thrown; InvalidInputException - not sure when this is thrown

getFunction

Function getFunction(String catName,
                     String dbName,
                     String funcName)
              throws MetaException

Retrieve function by name.

Parameters:: dbName - database name; funcName - function name
Returns:: the function
Throws:: MetaException - incorrectly specified function

getAllFunctions
```
List<Function> getAllFunctions(String catName)
                        throws MetaException
```
Retrieve all functions.

Returns:

all functions in a catalog

Throws:

MetaException - incorrectly specified function

getFunctions

List<String> getFunctions(String catName,
                          String dbName,
                          String pattern)
                   throws MetaException

Retrieve list of function names based on name pattern.

Parameters:: dbName - database name; pattern - pattern to match
Returns:: functions that match the pattern
Throws:: MetaException - incorrectly specified function

get_aggr_stats_for

AggrStats get_aggr_stats_for(String catName,
                             String dbName,
                             String tblName,
                             List<String> partNames,
                             List<String> colNames,
                             String engine)
                      throws MetaException,
                             NoSuchObjectException

Get aggregated stats for a table or partition(s).

Parameters:: catName - catalog name.; dbName - database name.; tblName - table name.; partNames - list of partition names. These are the names of the partitions, not values.; colNames - list of column names; engine - engine requesting the statistics
Returns:: aggregated stats
Throws:: MetaException - error accessing RDBMS; NoSuchObjectException - no such table or partition

get_aggr_stats_for

AggrStats get_aggr_stats_for(String catName,
                             String dbName,
                             String tblName,
                             List<String> partNames,
                             List<String> colNames,
                             String engine,
                             String writeIdList)
                      throws MetaException,
                             NoSuchObjectException

Get aggregated stats for a table or partition(s).

Parameters:: catName - catalog name.; dbName - database name.; tblName - table name.; partNames - list of partition names. These are the names of the partitions, not values.; colNames - list of column names; engine - engine requesting the statistics; writeIdList - string format of valid writeId transaction list
Returns:: aggregated stats
Throws:: MetaException - error accessing RDBMS; NoSuchObjectException - no such table or partition

getPartitionColStatsForDatabase

List<MetaStoreServerUtils.ColStatsObjWithSourceInfo> getPartitionColStatsForDatabase(String catName,
                                                                                     String dbName)
                                                                              throws MetaException,
                                                                                     NoSuchObjectException

Get column stats for all partitions of all tables in the database

Parameters:: catName - catalog name; dbName - database name
Returns:: List of column stats objects for all partitions of all tables in the database
Throws:: MetaException - error accessing RDBMS; NoSuchObjectException - no such database

getNextNotification
```
NotificationEventResponse getNextNotification(NotificationEventRequest rqst)
```
Get the next notification event.

Parameters:

rqst - Request containing information on the last processed notification.

Returns:

list of notifications, sorted by eventId

addNotificationEvent
```
void addNotificationEvent(NotificationEvent event)
                   throws MetaException
```
Add a notification entry. This should only be called from inside the metastore

Parameters:

event - the notification to add

Throws:

MetaException - error accessing RDBMS

cleanNotificationEvents
```
void cleanNotificationEvents(int olderThan)
```
Remove older notification events.

Parameters:

olderThan - Remove any events older or equal to a given number of seconds

getCurrentNotificationEventId
```
CurrentNotificationEventId getCurrentNotificationEventId()
```
Get the last issued notification event id. This is intended for use by the export command so that users can determine the state of the system at the point of the export, and determine which notification events happened before or after the export.

Returns:

getNotificationEventsCount
```
NotificationEventsCountResponse getNotificationEventsCount(NotificationEventsCountRequest rqst)
```
Get the number of events corresponding to given database with fromEventId. This is intended for use by the repl commands to track the progress of incremental dump.

Returns:

flushCache
```
void flushCache()
```

getFileMetadata
```
ByteBuffer[] getFileMetadata(List<Long> fileIds)
                      throws MetaException
```
Parameters:

fileIds - List of file IDs from the filesystem.

Returns:

File metadata buffers from file metadata cache. The array is fileIds-sized, and the entries (or nulls, if metadata is not in cache) correspond to fileIds in the list

Throws:

MetaException

putFileMetadata
```
void putFileMetadata(List<Long> fileIds,
                     List<ByteBuffer> metadata,
                     FileMetadataExprType type)
              throws MetaException
```
Parameters:

fileIds - List of file IDs from the filesystem.

metadata - Metadata buffers corresponding to fileIds in the list.

type - The type; determines the class that can do additional processing for metadata.

Throws:

MetaException

isFileMetadataSupported
```
boolean isFileMetadataSupported()
```
Returns:

Whether file metadata cache is supported by this implementation.

getFileMetadataByExpr
```
void getFileMetadataByExpr(List<Long> fileIds,
                           FileMetadataExprType type,
                           byte[] expr,
                           ByteBuffer[] metadatas,
                           ByteBuffer[] exprResults,
                           boolean[] eliminated)
                    throws MetaException
```
Gets file metadata from cache after applying a format-specific expression that can produce additional information based on file metadata and also filter the file list.

Parameters:

fileIds - List of file IDs from the filesystem.

expr - Format-specific serialized expression applicable to the files' metadatas.

type - Expression type; used to determine the class that handles the metadata.

metadatas - Output parameter; fileIds-sized array to receive the metadatas for corresponding files, if any.

exprResults - Output parameter; fileIds-sized array to receive the format-specific expression results for the corresponding files.

eliminated - Output parameter; fileIds-sized array to receive the indication of whether the corresponding files are entirely eliminated by the expression.

Throws:

MetaException

getFileMetadataHandler
```
FileMetadataHandler getFileMetadataHandler(FileMetadataExprType type)
```
Gets file metadata handler for the corresponding type.

getTableCount

@InterfaceStability.Evolving
int getTableCount()
                                        throws MetaException

Gets total number of tables.

Throws:: MetaException

getPartitionCount

@InterfaceStability.Evolving
int getPartitionCount()
                                            throws MetaException

Gets total number of partitions.

Throws:: MetaException

getDatabaseCount

@InterfaceStability.Evolving
int getDatabaseCount()
                                           throws MetaException

Gets total number of databases.

Throws:: MetaException

getPrimaryKeys
```
@Deprecated
List<SQLPrimaryKey> getPrimaryKeys(String catName,
                                               String db_name,
                                               String tbl_name)
                                        throws MetaException
```
Deprecated.

Get the primary associated with a table. Strangely enough each SQLPrimaryKey is actually a column in they key, not the key itself. Thus the list.

Parameters:

catName - catalog name

db_name - database name

tbl_name - table name

Returns:

list of primary key columns or an empty list if the table does not have a primary key

Throws:

MetaException - error accessing the RDBMS

getPrimaryKeys
```
List<SQLPrimaryKey> getPrimaryKeys(PrimaryKeysRequest request)
                            throws MetaException
```
SQLPrimaryKey represents a single primary key column. Since a table can have one or more primary keys ( in case of composite primary key ), this method returns List<SQLPrimaryKey>

Parameters:

request - primary key request

Returns:

list of primary key columns or an empty list if the table does not have a primary key

Throws:

MetaException - error accessing the RDBMS

getForeignKeys
```
@Deprecated
List<SQLForeignKey> getForeignKeys(String catName,
                                               String parent_db_name,
                                               String parent_tbl_name,
                                               String foreign_db_name,
                                               String foreign_tbl_name)
                                        throws MetaException
```
Deprecated.

Get the foreign keys for a table. All foreign keys for a particular table can be fetched by passing null for the last two arguments.

Parameters:

catName - catalog name.

parent_db_name - Database the table referred to is in. This can be null to match all databases.

parent_tbl_name - Table that is referred to. This can be null to match all tables.

foreign_db_name - Database the table with the foreign key is in.

foreign_tbl_name - Table with the foreign key.

Returns:

List of all matching foreign key columns. Note that if more than one foreign key matches the arguments the results here will be all mixed together into a single list.

Throws:

MetaException - error access the RDBMS.

getForeignKeys
```
List<SQLForeignKey> getForeignKeys(ForeignKeysRequest request)
                            throws MetaException
```
SQLForeignKey represents a single foreign key column. Since a table can have one or more foreign keys ( in case of composite foreign key ), this method returns List<SQLForeignKey>

Parameters:

request - ForeignKeysRequest object

Returns:

List of all matching foreign key columns. Note that if more than one foreign key matches the arguments the results here will be all mixed together into a single list.

Throws:

MetaException - error access the RDBMS.

getUniqueConstraints

@Deprecated
List<SQLUniqueConstraint> getUniqueConstraints(String catName,
                                                           String db_name,
                                                           String tbl_name)
                                                    throws MetaException

Deprecated.

Get unique constraints associated with a table.

Parameters:: catName - catalog name.; db_name - database name.; tbl_name - table name.
Returns:: list of unique constraints
Throws:: MetaException - error access the RDBMS.

getUniqueConstraints
```
List<SQLUniqueConstraint> getUniqueConstraints(UniqueConstraintsRequest request)
                                        throws MetaException
```
SQLUniqueConstraint represents a single unique constraint column. Since a table can have one or more unique constraint ( in case of composite unique constraint ), this method returns List<SQLUniqueConstraint>

Parameters:

request - UniqueConstraintsRequest object.

Returns:

list of unique constraints

Throws:

MetaException - error access the RDBMS.

getNotNullConstraints

@Deprecated
List<SQLNotNullConstraint> getNotNullConstraints(String catName,
                                                             String db_name,
                                                             String tbl_name)
                                                      throws MetaException

Deprecated.

Get not null constraints on a table.

Parameters:: catName - catalog name.; db_name - database name.; tbl_name - table name.
Returns:: list of not null constraints
Throws:: MetaException - error accessing the RDBMS.

getNotNullConstraints
```
List<SQLNotNullConstraint> getNotNullConstraints(NotNullConstraintsRequest request)
                                          throws MetaException
```
SQLNotNullConstraint represents a single not null constraint column. Since a table can have one or more not null constraint ( in case of composite not null constraint ), this method returns List<SQLNotNullConstraint>

Parameters:

request - NotNullConstraintsRequest object.

Returns:

list of not null constraints

Throws:

MetaException - error accessing the RDBMS.

getDefaultConstraints

@Deprecated
List<SQLDefaultConstraint> getDefaultConstraints(String catName,
                                                             String db_name,
                                                             String tbl_name)
                                                      throws MetaException

Deprecated.

Get default values for columns in a table.

Parameters:: catName - catalog name; db_name - database name; tbl_name - table name
Returns:: list of default values defined on the table.
Throws:: MetaException - error accessing the RDBMS

getDefaultConstraints
```
List<SQLDefaultConstraint> getDefaultConstraints(DefaultConstraintsRequest request)
                                          throws MetaException
```
SQLDefaultConstraint represents a single default constraint column. Since a table can have one or more default constraint ( in case of composite default constraint ), this method returns List<SQLDefaultConstraint>

Parameters:

request - DefaultConstraintsRequest object.

Returns:

list of default values defined on the table.

Throws:

MetaException - error accessing the RDBMS

getCheckConstraints

@Deprecated
List<SQLCheckConstraint> getCheckConstraints(String catName,
                                                         String db_name,
                                                         String tbl_name)
                                                  throws MetaException

Deprecated.

Get check constraints for columns in a table.

Parameters:: catName - catalog name.; db_name - database name; tbl_name - table name
Returns:: ccheck constraints for this table
Throws:: MetaException - error accessing the RDBMS

getCheckConstraints
```
List<SQLCheckConstraint> getCheckConstraints(CheckConstraintsRequest request)
                                      throws MetaException
```
SQLCheckConstraint represents a single check constraint column. Since a table can have one or more check constraint ( in case of composite check constraint ), this method returns List<SQLCheckConstraint>

Parameters:

request - CheckConstraintsRequest object.

Returns:

ccheck constraints for this table

Throws:

MetaException - error accessing the RDBMS

getAllTableConstraints

@Deprecated
SQLAllTableConstraints getAllTableConstraints(String catName,
                                                          String dbName,
                                                          String tblName)
                                                   throws MetaException,
                                                          NoSuchObjectException

Deprecated.

Get all constraints of the table

Parameters:: catName - catalog name; dbName - database name; tblName - table name
Returns:: all constraints for this table
Throws:: MetaException - error accessing the RDBMS; NoSuchObjectException

getAllTableConstraints

SQLAllTableConstraints getAllTableConstraints(AllTableConstraintsRequest request)
                                       throws MetaException,
                                              NoSuchObjectException

Get table constraints

Parameters:: request - AllTableConstraintsRequest object
Returns:: all constraints for this table
Throws:: MetaException; NoSuchObjectException

createTableWithConstraints

SQLAllTableConstraints createTableWithConstraints(Table tbl,
                                                  SQLAllTableConstraints constraints)
                                           throws InvalidObjectException,
                                                  MetaException

Create a table with constraints

Parameters:: tbl - table definition; constraints - wrapper of all table constraints
Returns:: list of constraint names
Throws:: InvalidObjectException - one of the provided objects is malformed.; MetaException - error accessing the RDBMS

dropConstraint

default void dropConstraint(String catName,
                            String dbName,
                            String tableName,
                            String constraintName)
                     throws NoSuchObjectException

Drop a constraint, any constraint. I have no idea why add and get each have separate methods for each constraint type but drop has only one.

Parameters:: catName - catalog name; dbName - database name; tableName - table name; constraintName - name of the constraint
Throws:: NoSuchObjectException - no constraint of this name exists

dropConstraint
```
void dropConstraint(String catName,
                    String dbName,
                    String tableName,
                    String constraintName,
                    boolean missingOk)
             throws NoSuchObjectException
```
Drop a constraint, any constraint. I have no idea why add and get each have separate methods for each constraint type but drop has only one.

Parameters:

catName - catalog name

dbName - database name

tableName - table name

constraintName - name of the constraint

missingOk - if true, it is not an error if there is no constraint of this name. If false and there is no constraint of this name an exception will be thrown.

Throws:

NoSuchObjectException - no constraint of this name exists and missingOk = false

addPrimaryKeys
```
List<SQLPrimaryKey> addPrimaryKeys(List<SQLPrimaryKey> pks)
                            throws InvalidObjectException,
                                   MetaException
```
Add a primary key to a table.

Parameters:

pks - Columns in the primary key.

Returns:

the name of the constraint, as a list of strings.

Throws:

InvalidObjectException - The SQLPrimaryKeys list is malformed

MetaException - error accessing the RDMBS

addForeignKeys
```
List<SQLForeignKey> addForeignKeys(List<SQLForeignKey> fks)
                            throws InvalidObjectException,
                                   MetaException
```
Add a foreign key to a table.

Parameters:

fks - foreign key specification

Returns:

foreign key name.

Throws:

InvalidObjectException - the specification is malformed.

MetaException - error accessing the RDBMS.

addUniqueConstraints

List<SQLUniqueConstraint> addUniqueConstraints(List<SQLUniqueConstraint> uks)
                                        throws InvalidObjectException,
                                               MetaException

Add unique constraints to a table.

Parameters:: uks - unique constraints specification
Returns:: unique constraint names.
Throws:: InvalidObjectException - the specification is malformed.; MetaException - error accessing the RDBMS.

addNotNullConstraints

List<SQLNotNullConstraint> addNotNullConstraints(List<SQLNotNullConstraint> nns)
                                          throws InvalidObjectException,
                                                 MetaException

Add not null constraints to a table.

Parameters:: nns - not null constraint specifications
Returns:: constraint names.
Throws:: InvalidObjectException - the specification is malformed.; MetaException - error accessing the RDBMS.

addDefaultConstraints

List<SQLDefaultConstraint> addDefaultConstraints(List<SQLDefaultConstraint> dv)
                                          throws InvalidObjectException,
                                                 MetaException

Add default values to a table definition.

Parameters:: dv - list of default values
Returns:: constraint names
Throws:: InvalidObjectException - the specification is malformed.; MetaException - error accessing the RDBMS.

addCheckConstraints

List<SQLCheckConstraint> addCheckConstraints(List<SQLCheckConstraint> cc)
                                      throws InvalidObjectException,
                                             MetaException

Add check constraints to a table.

Parameters:: cc - check constraints to add
Returns:: list of constraint names
Throws:: InvalidObjectException - the specification is malformed; MetaException - error accessing the RDBMS

getMetastoreDbUuid
```
String getMetastoreDbUuid()
                   throws MetaException
```
Gets the unique id of the backing datastore for the metadata.

Returns:

Throws:

MetaException

createResourcePlan

void createResourcePlan(WMResourcePlan resourcePlan,
                        String copyFrom,
                        int defaultPoolSize)
                 throws AlreadyExistsException,
                        MetaException,
                        InvalidObjectException,
                        NoSuchObjectException

Throws:: AlreadyExistsException; MetaException; InvalidObjectException; NoSuchObjectException

getResourcePlan

WMFullResourcePlan getResourcePlan(String name,
                                   String string)
                            throws NoSuchObjectException,
                                   MetaException

Throws:: NoSuchObjectException; MetaException

getAllResourcePlans

List<WMResourcePlan> getAllResourcePlans(String string)
                                  throws MetaException

Throws:: MetaException

alterResourcePlan

WMFullResourcePlan alterResourcePlan(String name,
                                     String ns,
                                     WMNullableResourcePlan resourcePlan,
                                     boolean canActivateDisabled,
                                     boolean canDeactivate,
                                     boolean isReplace)
                              throws AlreadyExistsException,
                                     NoSuchObjectException,
                                     InvalidOperationException,
                                     MetaException

Throws:: AlreadyExistsException; NoSuchObjectException; InvalidOperationException; MetaException

getActiveResourcePlan

WMFullResourcePlan getActiveResourcePlan(String ns)
                                  throws MetaException

Throws:: MetaException

validateResourcePlan

WMValidateResourcePlanResponse validateResourcePlan(String name,
                                                    String ns)
                                             throws NoSuchObjectException,
                                                    InvalidObjectException,
                                                    MetaException

Throws:: NoSuchObjectException; InvalidObjectException; MetaException

dropResourcePlan

void dropResourcePlan(String name,
                      String ns)
               throws NoSuchObjectException,
                      MetaException

Throws:: NoSuchObjectException; MetaException

createWMTrigger

void createWMTrigger(WMTrigger trigger)
              throws AlreadyExistsException,
                     NoSuchObjectException,
                     InvalidOperationException,
                     MetaException

Throws:: AlreadyExistsException; NoSuchObjectException; InvalidOperationException; MetaException

alterWMTrigger

void alterWMTrigger(WMTrigger trigger)
             throws NoSuchObjectException,
                    InvalidOperationException,
                    MetaException

Throws:: NoSuchObjectException; InvalidOperationException; MetaException

dropWMTrigger

void dropWMTrigger(String resourcePlanName,
                   String triggerName,
                   String ns)
            throws NoSuchObjectException,
                   InvalidOperationException,
                   MetaException

Throws:: NoSuchObjectException; InvalidOperationException; MetaException

getTriggersForResourcePlan

List<WMTrigger> getTriggersForResourcePlan(String resourcePlanName,
                                           String ns)
                                    throws NoSuchObjectException,
                                           MetaException

Throws:: NoSuchObjectException; MetaException

createPool

void createPool(WMPool pool)
         throws AlreadyExistsException,
                NoSuchObjectException,
                InvalidOperationException,
                MetaException

Throws:: AlreadyExistsException; NoSuchObjectException; InvalidOperationException; MetaException

alterPool

void alterPool(WMNullablePool pool,
               String poolPath)
        throws AlreadyExistsException,
               NoSuchObjectException,
               InvalidOperationException,
               MetaException

Throws:: AlreadyExistsException; NoSuchObjectException; InvalidOperationException; MetaException

dropWMPool

void dropWMPool(String resourcePlanName,
                String poolPath,
                String ns)
         throws NoSuchObjectException,
                InvalidOperationException,
                MetaException

Throws:: NoSuchObjectException; InvalidOperationException; MetaException

createOrUpdateWMMapping

void createOrUpdateWMMapping(WMMapping mapping,
                             boolean update)
                      throws AlreadyExistsException,
                             NoSuchObjectException,
                             InvalidOperationException,
                             MetaException

Throws:: AlreadyExistsException; NoSuchObjectException; InvalidOperationException; MetaException

dropWMMapping

void dropWMMapping(WMMapping mapping)
            throws NoSuchObjectException,
                   InvalidOperationException,
                   MetaException

Throws:: NoSuchObjectException; InvalidOperationException; MetaException

createWMTriggerToPoolMapping

void createWMTriggerToPoolMapping(String resourcePlanName,
                                  String triggerName,
                                  String poolPath,
                                  String ns)
                           throws AlreadyExistsException,
                                  NoSuchObjectException,
                                  InvalidOperationException,
                                  MetaException

Throws:: AlreadyExistsException; NoSuchObjectException; InvalidOperationException; MetaException

dropWMTriggerToPoolMapping

void dropWMTriggerToPoolMapping(String resourcePlanName,
                                String triggerName,
                                String poolPath,
                                String ns)
                         throws NoSuchObjectException,
                                InvalidOperationException,
                                MetaException

Throws:: NoSuchObjectException; InvalidOperationException; MetaException

createISchema
```
void createISchema(ISchema schema)
            throws AlreadyExistsException,
                   MetaException,
                   NoSuchObjectException
```
Create a new ISchema.

Parameters:

schema - schema to create

Throws:

AlreadyExistsException - there's already a schema with this name

MetaException - general database exception

NoSuchObjectException

alterISchema
```
void alterISchema(ISchemaName schemaName,
                  ISchema newSchema)
           throws NoSuchObjectException,
                  MetaException
```
Alter an existing ISchema. This assumes the caller has already checked that such a schema. exists.

Parameters:

schemaName - name of the schema

newSchema - new schema object

Throws:

NoSuchObjectException - no function with this name exists

MetaException - general database exception

getISchema
```
ISchema getISchema(ISchemaName schemaName)
            throws MetaException
```
Get an ISchema by name.

Parameters:

schemaName - schema descriptor

Returns:

ISchema

Throws:

MetaException - general database exception

dropISchema
```
void dropISchema(ISchemaName schemaName)
          throws NoSuchObjectException,
                 MetaException
```
Drop an ISchema. This does not check whether there are valid versions of the schema in existence, it assumes the caller has already done that.

Parameters:

schemaName - schema descriptor

Throws:

NoSuchObjectException - no schema of this name exists

MetaException - general database exception

addSchemaVersion
```
void addSchemaVersion(SchemaVersion schemaVersion)
               throws AlreadyExistsException,
                      InvalidObjectException,
                      NoSuchObjectException,
                      MetaException
```
Create a new version of an existing schema.

Parameters:

schemaVersion - version number

Throws:

AlreadyExistsException - a version of the schema with the same version number already exists.

InvalidObjectException - the passed in SchemaVersion object has problems.

NoSuchObjectException - no schema with the passed in name exists.

MetaException - general database exception

alterSchemaVersion
```
void alterSchemaVersion(SchemaVersionDescriptor version,
                        SchemaVersion newVersion)
                 throws NoSuchObjectException,
                        MetaException
```
Alter a schema version. Note that the Thrift interface only supports changing the serde mapping and states. This method does not guarantee it will check anymore than that. This method does not understand the state transitions and just assumes that the new state it is passed is reasonable.

Parameters:

version - version descriptor for the schema

newVersion - altered SchemaVersion

Throws:

NoSuchObjectException - no such version of the named schema exists

MetaException - general database exception

getSchemaVersion
```
SchemaVersion getSchemaVersion(SchemaVersionDescriptor version)
                        throws MetaException
```
Get a specific schema version.

Parameters:

version - version descriptor for the schema

Returns:

the SchemaVersion

Throws:

MetaException - general database exception

getLatestSchemaVersion
```
SchemaVersion getLatestSchemaVersion(ISchemaName schemaName)
                              throws MetaException
```
Get the latest version of a schema.

Parameters:

schemaName - name of the schema

Returns:

latest version of the schema

Throws:

MetaException - general database exception

getAllSchemaVersion
```
List<SchemaVersion> getAllSchemaVersion(ISchemaName schemaName)
                                 throws MetaException
```
Get all of the versions of a schema.

Parameters:

schemaName - name of the schema

Returns:

all versions of the schema

Throws:

MetaException - general database exception

getSchemaVersionsByColumns
```
List<SchemaVersion> getSchemaVersionsByColumns(String colName,
                                               String colNamespace,
                                               String type)
                                        throws MetaException
```
Find all SchemaVersion objects that match a query. The query will select all SchemaVersions that are equal to all of the non-null passed in arguments. That is, if arguments colName='name', colNamespace=null, type='string' are passed in, then all schemas that have a column with colName 'name' and type 'string' will be returned.

Parameters:

colName - column name. Null is ok, which will cause this field to not be used in the query.

colNamespace - column namespace. Null is ok, which will cause this field to not be used in the query.

type - column type. Null is ok, which will cause this field to not be used in the query.

Returns:

List of all SchemaVersions that match. Note that there is no expectation that these SchemaVersions derive from the same ISchema. The list will be empty if there are no matching SchemaVersions.

Throws:

MetaException - general database exception

dropSchemaVersion
```
void dropSchemaVersion(SchemaVersionDescriptor version)
                throws NoSuchObjectException,
                       MetaException
```
Drop a version of the schema.

Parameters:

version - version descriptor for the schema

Throws:

NoSuchObjectException - no such version of the named schema exists

MetaException - general database exception

getSerDeInfo
```
SerDeInfo getSerDeInfo(String serDeName)
                throws NoSuchObjectException,
                       MetaException
```
Get serde information.

Parameters:

serDeName - name of the SerDe

Returns:

the SerDe, or null if there is no such serde

Throws:

NoSuchObjectException - no serde with this name exists

MetaException - general database exception

addSerde
```
void addSerde(SerDeInfo serde)
       throws AlreadyExistsException,
              MetaException
```
Add a serde.

Parameters:

serde - serde to add

Throws:

AlreadyExistsException - a serde of this name already exists

MetaException - general database exception

addRuntimeStat

void addRuntimeStat(RuntimeStat stat)
             throws MetaException

Adds a RuntimeStat for persistence.

Throws:: MetaException

getRuntimeStats

List<RuntimeStat> getRuntimeStats(int maxEntries,
                                  int maxCreateTime)
                           throws MetaException

Reads runtime statistic entries.

Throws:: MetaException

deleteRuntimeStats

int deleteRuntimeStats(int maxRetainSecs)
                throws MetaException

Removes outdated statistics.

Throws:: MetaException

getTableNamesWithStats

List<TableName> getTableNamesWithStats()
                                throws MetaException,
                                       NoSuchObjectException

Throws:: MetaException; NoSuchObjectException

getAllTableNamesForStats

List<TableName> getAllTableNamesForStats()
                                  throws MetaException,
                                         NoSuchObjectException

Throws:: MetaException; NoSuchObjectException

getPartitionColsWithStats

Map<String,List<String>> getPartitionColsWithStats(String catName,
                                                   String dbName,
                                                   String tableName)
                                            throws MetaException,
                                                   NoSuchObjectException

Throws:: MetaException; NoSuchObjectException

cleanWriteNotificationEvents
```
void cleanWriteNotificationEvents(int olderThan)
```
Remove older notification events.

Parameters:

olderThan - Remove any events older or equal to a given number of seconds

getAllWriteEventInfo

List<WriteEventInfo> getAllWriteEventInfo(long txnId,
                                          String dbName,
                                          String tableName)
                                   throws MetaException

Get all write events for a specific transaction .

Parameters:: txnId - get all the events done by this transaction; dbName - the name of db for which dump is being taken; tableName - the name of the table for which the dump is being taken
Throws:: MetaException

isPartOfMaterializedView

List<String> isPartOfMaterializedView(String catName,
                                      String dbName,
                                      String tblName)

Checking if table is part of a materialized view.

Parameters:: catName - catalog the table is in; dbName - database the table is in; tblName - table name
Returns:: list of materialized views that uses the table

getScheduledQuery

ScheduledQuery getScheduledQuery(ScheduledQueryKey scheduleKey)
                          throws MetaException,
                                 NoSuchObjectException

Returns details about a scheduled query by name.

Throws:: NoSuchObjectException - if an object by the given name dosen't exists.; MetaException

scheduledQueryMaintenance

void scheduledQueryMaintenance(ScheduledQueryMaintenanceRequest request)
                        throws MetaException,
                               NoSuchObjectException,
                               AlreadyExistsException,
                               InvalidInputException

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

Throws:: MetaException; NoSuchObjectException; AlreadyExistsException; InvalidInputException

scheduledQueryPoll

ScheduledQueryPollResponse scheduledQueryPoll(ScheduledQueryPollRequest request)
                                       throws MetaException

Checks whenever a query is available for execution.

Returns:: optionally a scheduled query to be processed.
Throws:: MetaException

scheduledQueryProgress

void scheduledQueryProgress(ScheduledQueryProgressInfo info)
                     throws MetaException,
                            NoSuchObjectException,
                            InvalidOperationException

Registers the progress a scheduled query being executed.

Throws:: MetaException; NoSuchObjectException; InvalidOperationException

addReplicationMetrics
```
void addReplicationMetrics(ReplicationMetricList replicationMetricList)
```
Add the replication metrics and progress info.

Parameters:

replicationMetricList -

getReplicationMetrics

ReplicationMetricList getReplicationMetrics(GetReplicationMetricsRequest replicationMetricsRequest)

Gets the replication metrics and progress info.

Parameters:: replicationMetricsRequest -

updatePartitionColumnStatisticsInBatch

Map<String,Map<String,String>> updatePartitionColumnStatisticsInBatch(Map<String,ColumnStatistics> partColStatsMap,
                                                                      Table tbl,
                                                                      List<TransactionalMetaStoreEventListener> listeners,
                                                                      String validWriteIds,
                                                                      long writeId)
                                                               throws NoSuchObjectException,
                                                                      MetaException,
                                                                      InvalidObjectException,
                                                                      InvalidInputException

Throws:: NoSuchObjectException; MetaException; InvalidObjectException; InvalidInputException

deleteReplicationMetrics

int deleteReplicationMetrics(int maxRetainSecs)

deleteScheduledExecutions

int deleteScheduledExecutions(int maxRetainSecs)

markScheduledExecutionsTimedOut

int markScheduledExecutionsTimedOut(int timeoutSecs)
                             throws InvalidOperationException,
                                    MetaException

Throws:: InvalidOperationException; MetaException

deleteAllPartitionColumnStatistics

void deleteAllPartitionColumnStatistics(TableName tn,
                                        String writeIdList)

createOrUpdateStoredProcedure

void createOrUpdateStoredProcedure(StoredProcedure proc)
                            throws NoSuchObjectException,
                                   MetaException

Throws:: NoSuchObjectException; MetaException

getStoredProcedure

StoredProcedure getStoredProcedure(String catName,
                                   String db,
                                   String name)
                            throws MetaException

Throws:: MetaException

dropStoredProcedure

void dropStoredProcedure(String catName,
                         String dbName,
                         String funcName)
                  throws MetaException

Throws:: MetaException

getAllStoredProcedures

List<String> getAllStoredProcedures(ListStoredProcedureRequest request)

addPackage

void addPackage(AddPackageRequest request)
         throws MetaException,
                NoSuchObjectException

Throws:: MetaException; NoSuchObjectException

findPackage

Package findPackage(GetPackageRequest request)

listPackages

List<String> listPackages(ListPackageRequest request)

dropPackage

void dropPackage(DropPackageRequest request)

ensureGetMTable

MTable ensureGetMTable(String catName,
                       String dbName,
                       String tblName)
                throws NoSuchObjectException

Throws:: NoSuchObjectException

getPropertyStore
```
default PropertyStore getPropertyStore()
```
Persistent Property Management.

Interface RawStore

Nested Class Summary

Method Summary

Methods inherited from interface org.apache.hadoop.conf.Configurable

Method Detail

shutdown

openTransaction

openTransaction

commitTransaction

isActiveTransaction

rollbackTransaction

createCatalog

alterCatalog

getCatalog

getCatalogs

dropCatalog

createDatabase

getDatabase

dropDatabase

alterDatabase

getDatabases

getAllDatabases

createDataConnector

dropDataConnector

alterDataConnector

getDataConnector

getAllDataConnectorNames

createType

getType

dropType

createTable

dropTable

getTable

getTable

getTable

addPartition

addPartitions

addPartitions

getPartition

getPartition

doesPartitionExist

dropPartition

dropPartition

getPartitions

getPartitions

getPartitionLocations

alterTable

updateCreationMetadata

getTables

getTables

getAllMaterializedViewObjectsForRewriting

getMaterializedViewsForRewriting

getTableMeta

getTableObjectsByName

getTableObjectsByName

getAllTables

listTableNamesByFilter

listPartitionNames

listPartitionNames

listPartitionValues

alterPartition

alterPartitions

getPartitionsByFilter

getPartitionsByFilter

getPartitionSpecsByFilterAndProjection

getPartitionsByExpr

getPartitionsByExpr

getNumPartitionsByFilter

getNumPartitionsByExpr

getNumPartitionsByPs

getPartitionsByNames

getPartitionsByNames

markPartitionForEvent

isPartitionMarkedForEvent

addRole

removeRole

grantRole

revokeRole

getUserPrivilegeSet

getDBPrivilegeSet