Page History

/**
 * The abstract class HCatClient containing APIs for HCatalog DDL commands.
 */
public abstract class HCatClient {

    /**
     * Creates an instance of HCatClient.
     *
     * @param conf An instance of configuration.
     * @return An instance of HCatClient.
     */
    public HCatClient create(Configuration conf){
        // Obtain details of implementation class and return an instance.     
    }

    /**
     * Gets the database like.
     *
     * @param regex The regular expression. Providing "*" would retrieve all the names
     *              of the databases.
     * @return The list of all the database names.
     * @throws HCatException
     */
    public abstract List<String> getDatabaseLike(String regex) throws HCatException;

    /**
     * Gets the database.
     *
     * @param dbName The name of the database.
     * @return An instance of HCatDatabaseInfo.
     * @throws HCatException
     */
    public abstract HCatDatabase getDatabase(String dbName) throws HCatException;

    /**
     * Creates the databasean instance of HCatClient.
     *
     * @param dbInfoconf An instance of HCatCreateDBDescconfiguration.
     * @return true, if successfulAn instance of HCatClient.
     * @throws HCatExceptionIOException
     */
    public abstractstatic booleanHCatClient createDatabasecreate(HCatCreateDBDescConfiguration dbInfoconf) throws IOException{
      HCatClient client = HCatUtil.getHCatClient(conf);
        if(client throws HCatException;

!= null){
    /**
     * Deletes a databaseclient.initialize(conf);
     *
   }
  * @param dbName The name of the database to delete.return client;
    }

 * @param ifExists Hiveabstract returnsvoid an error if the database specified does not exist,initialize(Configuration conf) throws HCatException;

    /**
     * Get all existing databases that match the given
     * pattern. The matching unlessoccurs ifExistsas isper setJava toregular true.expressions
     *
 @param mode This is set* to either "restrict" or "cascade". Restrict will@param databasePattern
     *          java re  removepattern
 the schema if all the* tables@return arelist empty.of Cascadedatabase removesnames
     * @throws HCatException
     */
    public abstract everythingList<String> including data and definitions.listDatabaseNamesByPattern(String pattern) throws HCatException;

    /**
 * @param userGroup The user* groupGets tothe usedatabase.
     *
 @param permissions The permissions string* to@param use.dbName The formatname of is "rwxrw-r-x"the database.
     * @return true, if successfulAn instance of HCatDatabaseInfo.
     * @throws HCatException
     */
    public abstract booleanHCatDatabase deleteDatabasegetDatabase(String dbName,) boolean ifExists, String mode,throws HCatException;

    /**
     * Creates  String userGroup, String permissions) throws HCatException;

the database.
     /**
     * Gets@param thedbInfo tablesAn likeinstance aof pattern specifiedHCatCreateDBDesc.
     * @throws HCatException
     */
  @param dbName Thepublic nameabstract ofvoid the database.createDatabase(HCatCreateDBDesc dbInfo)
     * @param regex The regular expression. Providing "*" would retrieve all the namesthrows HCatException;

    /**
     * Drops a database.
     *
     * @param dbName The name of the thedatabase to tabledelete.
     * @return@param AifExists listHive ofreturns allan tableerror namesif matchingthe thedatabase specified pattern.does not exist,
     * @throws HCatException
           */
    public abstractunless List<String>ifExists getTablesLike(String dbName, String regex)is set to true.
     * @param mode This is set to throws HCatException;

    /**either "restrict" or "cascade". Restrict will
     * Gets    the table.
     *
  remove the schema *if @paramall dbNamethe Thetables nameare ofempty. theCascade database.removes
     * @param tableName The name of the table.
     * @returneverything Anincluding instancedata ofand HCatTableInfodefinitions.
     * @throws HCatException
     */
    public abstract HCatTablevoid getTabledropDatabase(String dbName, boolean ifExists, String tableNamemode) throws HCatException;

    /**
     * Returns all existing  throws HCatException;
tables from the specified database which match the given
    / **
 pattern. The matching occurs as *per CreatesJava theregular tableexpressions.
     * @param dbName
     * @param createTableDesc An instance of HCatCreateTableDesc class.tablePattern
     * @return true, if successful.list of table names
     * @throws HCatException the h cat exception
     */
    public abstract booleanList<String> createTable(HCatCreateTableDesc createTableDesclistTableNamesByPattern(String dbName, String tablePattern)
            throws HCatException;

    /**
     * CreatesGets the table like an existing table.
     *
     * @param dbName The name of the database.
     * @param existingTblNametableName The name of the existing table.
     * @param@return newTableNameAn Theinstance name of the new table.
     * @param ifExists the if exists
     * @param isExternal Set to "true", if table has be created at a differentHCatTableInfo.
     * @throws HCatException
     */
    public abstract HCatTable getTable(String dbName, String tableName)
          location other than default.throws HCatException;

    /**
 * @param location The location* forCreates the table.
     * @return true, if successful
     * @param createTableDesc An instance of HCatCreateTableDesc class.
     * @throws HCatException the h cat exception
     */
    public abstract booleanvoid createTableLikecreateTable(String dbName, String existingTblName,HCatCreateTableDesc createTableDesc)
            String newTableName, boolean ifExists, boolean isExternal,
            String location) throws HCatException;

    /**
     * Delete a Creates the table like an existing table.
     *
     * @param dbName The name of the database.
     * @param tableNameexistingTblName The name of the existing table.
     * @param ifExists Hive returns an error if the database specified does not exist,
     *     newTableName The name of the new table.
     * @param ifNotExists If true, then error related to already table existing is skipped.
     * @param isExternal Set to "true", if table unlesshas ifExistsbe iscreated setat toa true.different
     * @param userGroup The user group to use.
     * @param permissions The permissions string to use. Thelocation formatother is "rwxrw-r-x"than default.
     * @return true, if successful@param location The location for the table.
     * @throws HCatException
     */
    public abstract booleanvoid deleteTablecreateTableLike(String dbName, String tableNameexistingTblName,
            String newTableName, boolean ifExistsifNotExists, Stringboolean userGroupisExternal,
 String permissions)
          String location) throws HCatException;

    /**
     * Renames aDrop table.
     *
     * @param dbName The name of the database.
     * @param oldNametableName The name of the table to be renamed.
     * @param newNameifExists Hive Thereturns newan nameerror ofif the table.
database specified does not exist,
 * @param userGroup The user group to use.
    *  * @param permissions The permissions string to use. The format is "rwxrw-r-x".
    unless *ifExists @returnis true,set ifto successfultrue.
     * @throws HCatException
     */
    public abstract booleanvoid renameTabledropTable(String dbName, String oldNametableName, String newName,
            String userGroup, String permissionsboolean ifExists) throws HCatException;

    /**
     * GetsRenames alla the partitionstable.
     *
     * @param dbName The name of the database.
     * @param tblNameoldName The name of the table the table to be renamed.
     * @return A list@param newName The new name of partitionthe namestable.
     * @throws HCatException the h cat exception
     */
    public abstract List<HCatPartition>void getPartitionsrenameTable(String dbName, String tblName)
 oldName, String newName) throws HCatException;

    /**
     * Gets all throwsthe HCatException;partitions.

     /**
     * Gets the partition.
     *@param dbName The name of the database.
     * @param dbNametblName The name of databasethe nametable.
     * @param@return A tableNamelist Theof tablepartition namenames.
     * @throws @paramHCatException partitionNamethe Theh partitioncat name,exception
 Comma separated list of col_name='value'.
     * @return An instance of HCatPartitionInfo.
 */
    public abstract List<HCatPartition> getPartitions(String dbName, String tblName)
           * @throwsthrows HCatException;

     /**/
    public abstract HCatPartition getPartition(String dbName, String tableName, * Gets the partition.
     *
     * @param dbName The database name.
   String partitionName) throws HCatException;

    /*** @param tableName The table name.
     * @param AddspartitionName theThe partition.
 name, Comma separated list  *of col_name='value'.
     * @param@return partInfo An instance of HCatAddPartitionDescHCatPartitionInfo.
     * @return true, if successful@throws HCatException
     */
    public *abstract @throwsHCatPartition HCatException the h cat exceptiongetPartition(String dbName, String tableName,
     */
    public abstract boolean addPartition(HCatAddPartitionDescString partInfopartitionName) throws HCatException;

    /**
     * Adds Deletesthe partition.
     *
     * @param dbNamepartInfo An Theinstance databaseof nameHCatAddPartitionDesc.
     * @throws HCatException the h cat exception
     */
    public abstract void addPartition(HCatAddPartitionDesc partInfo) throws HCatException;

 * @param tableName The table name. /**
     * @paramDrops partitionName The partition.
 name, Comma separated list of col_name='value'. *
     * @param ifExistsdbName HiveThe returnsdatabase anname.
 error if the partition specified does not exist, unless ifExists is set to true * @param tableName The table name.
     * @param userGrouppartitionName The user group to use partition name, Comma separated list of col_name='value'.
     * @param permissionsifExists Hive Thereturns permissionsan stringerror toif use.the Thepartition formatspecified is "rwxrw-r-x".
     * @return true, if successfuldoes not exist, unless ifExists is set to true.
     * @throws HCatException
     */
    public abstract booleanvoid deletePartitiondropPartition(String dbName, String tableName,
            String partitionName, boolean ifExists, String userGroup,
            String permissions) throws HCatException;

    /**
     * List partitions by filter.
     *
     * @param dbName The database name.
     * @param tblName The table name.
     * @param filter The filter string,
     *    for example "part1 = \"p1_abc\" and part2 <= "\p2_test\"". Filtering can
     *    be done only on string partition keys.
     * @return list of partitions
     * @throws HCatException the h cat exception
     */
    public abstract List<HCatPartition> listPartitionsByFilter(String dbName, String tblName,
            String filter) throws HCatException;

    /**
     * Mark partition for event.
     *
     * @param dbName The database name.
     * @param tblName The table name.
     * @param partKVs the part k vs
     * @param eventType the event type
     * @throws HCatException the h cat exception
     */
    public abstract void markPartitionForEvent(String dbName, String tblName,
            Map<String, String> partKVs, PartitionEventType eventType)
            throws HCatException;

    /**
     * Checks if is partition marked for event.
     *
     * @param dbName the db name
     * @param tblName the tbl name
     * @param partKVs the part k vs
     * @param eventType the event type
     * @return true, if is partition marked for event
     * @throws HCatException the h cat exception
     */
    public abstract boolean isPartitionMarkedForEvent(String dbName, String tblName,
            Map<String, String> partKVs, PartitionEventType eventType)
            throws HCatException;

    /**
     * Gets the delegation token.
     *
     * @param owner the owner
     * @param renewerKerberosPrincipalName the renewer kerberos principal name
     * @return the delegation token
     * @throws HCatException the h cat exception
     */
    public abstract String getDelegationToken(String owner, String renewerKerberosPrincipalName) throws
        HCatException;

    /**
     * Renew delegation token.
     *
     * @param tokenStrForm the token str form
     * @return the long
     * @throws HCatException the h cat exception
     */
    public abstract long renewDelegationToken(String tokenStrForm) throws HCatException;

    /**
     * Cancel delegation token.
     *
     * @param tokenStrForm the token str form
     * @throws HCatException the h cat exception
     */
    public abstract void cancelDelegationToken(String tokenStrForm) throws HCatException;

}

HCatException;

    /**
      * TheClose Classthe HCatCommandDeschcatalog containsclient.
 methods which help in validating,
 * building command descriptors and queries.
 */
public abstract class HCatCommandDesc{

    public abstract void validateCommandDesc() throws HCatException;
    abstract String buildQuery*
     * @throws HCatException the h cat exception
     */
    public abstract void close() throws HCatException;
    abstract boolean isValidationComplete();

}