org.apache.hadoop.hbase.regionserver

Class HRegionFileSystem

java.lang.Object

org.apache.hadoop.hbase.regionserver.HRegionFileSystem

@InterfaceAudience.Private
public class HRegionFileSystem
extends java.lang.Object

View to an on-disk Region. Provides the set of methods necessary to interact with the on-disk region data.

Field Summary

Fields

Modifier and Type	Field and Description
static Log	LOG
static java.lang.String	REGION_INFO_FILE Name of the region info file that resides just under the region directory.
static java.lang.String	REGION_MERGES_DIR Temporary subdirectory of the region directory used for merges.
static java.lang.String	REGION_SPLITS_DIR Temporary subdirectory of the region directory used for splits.

Method Summary

Modifier and Type	Method and Description
Path	commitStoreFile(java.lang.String familyName, Path buildPath) Move the file from a build/temp location to the main family store directory.
static HRegionFileSystem	createRegionOnFileSystem(Configuration conf, FileSystem fs, Path tableDir, HRegionInfo regionInfo) Create a new Region on file-system.
Path	createTempName() Generate a unique temporary Path.
Path	createTempName(java.lang.String suffix) Generate a unique temporary Path.
void	deleteFamily(java.lang.String familyName) Remove the region family from disk, archiving the store files.
static void	deleteRegionFromFileSystem(Configuration conf, FileSystem fs, Path tableDir, HRegionInfo regionInfo) Remove the region from the table directory, archiving the region's hfiles.
java.util.Collection<java.lang.String>	getFamilies()
FileSystem	getFileSystem()
Path	getRegionDir()
HRegionInfo	getRegionInfo()
HRegionInfo	getRegionInfoForFS()
Path	getStoreDir(java.lang.String familyName) Returns the directory path of the specified family
java.util.Collection<StoreFileInfo>	getStoreFiles(byte[] familyName) Returns the store files available for the family.
java.util.Collection<StoreFileInfo>	getStoreFiles(java.lang.String familyName)
java.util.Collection<StoreFileInfo>	getStoreFiles(java.lang.String familyName, boolean validate) Returns the store files available for the family.
Path	getTableDir()
boolean	hasReferences(HTableDescriptor htd) Check whether region has Reference file
boolean	hasReferences(java.lang.String familyName) Returns true if the specified family has reference files
static HRegionInfo	loadRegionInfoFileContent(FileSystem fs, Path regionDir) Create a HRegionInfo from the serialized version on-disk.
static HRegionFileSystem	openRegionFromFileSystem(Configuration conf, FileSystem fs, Path tableDir, HRegionInfo regionInfo, boolean readOnly) Open Region from file-system.
void	removeStoreFile(java.lang.String familyName, Path filePath) Archives the specified store file from the specified family.
void	removeStoreFiles(java.lang.String familyName, java.util.Collection<StoreFile> storeFiles) Closes and archives the specified store files from the specified family.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LOG

public static final Log LOG

REGION_INFO_FILE

public static final java.lang.String REGION_INFO_FILE

Name of the region info file that resides just under the region directory.

See Also:

Constant Field Values

REGION_MERGES_DIR

public static final java.lang.String REGION_MERGES_DIR

Temporary subdirectory of the region directory used for merges.

See Also:

Constant Field Values

REGION_SPLITS_DIR

public static final java.lang.String REGION_SPLITS_DIR

Temporary subdirectory of the region directory used for splits.

See Also:

Constant Field Values

Method Detail

getFileSystem

public FileSystem getFileSystem()

Returns:

the underlying FileSystem

getRegionInfo

public HRegionInfo getRegionInfo()

Returns:

the HRegionInfo that describe this on-disk region view

getRegionInfoForFS

public HRegionInfo getRegionInfoForFS()

getTableDir

public Path getTableDir()

Returns:

Path to the region's root directory.

getRegionDir

public Path getRegionDir()

Returns:

Path to the region directory.

getStoreDir

public Path getStoreDir(java.lang.String familyName)

Returns the directory path of the specified family

Parameters:

familyName - Column Family Name

Returns:

Path to the directory of the specified family

getStoreFiles

public java.util.Collection<StoreFileInfo> getStoreFiles(byte[] familyName)
                                                  throws java.io.IOException

Returns the store files available for the family. This methods performs the filtering based on the valid store files.

Parameters:

familyName - Column Family Name

Returns:

a set of StoreFileInfo for the specified family.

Throws:

java.io.IOException

getStoreFiles

public java.util.Collection<StoreFileInfo> getStoreFiles(java.lang.String familyName)
                                                  throws java.io.IOException

Throws:

java.io.IOException

getStoreFiles

public java.util.Collection<StoreFileInfo> getStoreFiles(java.lang.String familyName,
                                                         boolean validate)
                                                  throws java.io.IOException

Returns the store files available for the family. This methods performs the filtering based on the valid store files.

Parameters:

familyName - Column Family Name

Returns:

a set of StoreFileInfo for the specified family.

Throws:

java.io.IOException

hasReferences

public boolean hasReferences(java.lang.String familyName)
                      throws java.io.IOException

Returns true if the specified family has reference files

Parameters:

familyName - Column Family Name

Returns:

true if family contains reference files

Throws:

java.io.IOException

hasReferences

public boolean hasReferences(HTableDescriptor htd)
                      throws java.io.IOException

Check whether region has Reference file

Parameters:

htd - table desciptor of the region

Returns:

true if region has reference file

Throws:

java.io.IOException

getFamilies

public java.util.Collection<java.lang.String> getFamilies()
                                                   throws java.io.IOException

Returns:

the set of families present on disk

Throws:

java.io.IOException

deleteFamily

public void deleteFamily(java.lang.String familyName)
                  throws java.io.IOException

Remove the region family from disk, archiving the store files.

Parameters:

familyName - Column Family Name

Throws:

java.io.IOException - if an error occours during the archiving

createTempName

public Path createTempName()

Generate a unique temporary Path. Used in conjuction with commitStoreFile() to get a safer file creation. Path file = fs.createTempName(); ...StoreFile.Writer(file)... fs.commitStoreFile("family", file);

Returns:

Unique Path of the temporary file

createTempName

public Path createTempName(java.lang.String suffix)

Generate a unique temporary Path. Used in conjuction with commitStoreFile() to get a safer file creation. Path file = fs.createTempName(); ...StoreFile.Writer(file)... fs.commitStoreFile("family", file);

Parameters:

suffix - extra information to append to the generated name

Returns:

Unique Path of the temporary file

commitStoreFile

public Path commitStoreFile(java.lang.String familyName,
                            Path buildPath)
                     throws java.io.IOException

Move the file from a build/temp location to the main family store directory.

Parameters:

familyName - Family that will gain the file

buildPath - Path to the file to commit.

Returns:

The new Path of the committed file

Throws:

java.io.IOException

removeStoreFile

public void removeStoreFile(java.lang.String familyName,
                            Path filePath)
                     throws java.io.IOException

Archives the specified store file from the specified family.

Parameters:

familyName - Family that contains the store files

filePath - Path to the store file to remove

Throws:

java.io.IOException - if the archiving fails

removeStoreFiles

public void removeStoreFiles(java.lang.String familyName,
                             java.util.Collection<StoreFile> storeFiles)
                      throws java.io.IOException

Closes and archives the specified store files from the specified family.

Parameters:

familyName - Family that contains the store files

storeFiles - set of store files to remove

Throws:

java.io.IOException - if the archiving fails

loadRegionInfoFileContent

public static HRegionInfo loadRegionInfoFileContent(FileSystem fs,
                                                    Path regionDir)
                                             throws java.io.IOException

Create a HRegionInfo from the serialized version on-disk.

Parameters:

fs - FileSystem that contains the Region Info file

regionDir - Path to the Region Directory that contains the Info file

Returns:

An HRegionInfo instance gotten from the Region Info file.

Throws:

java.io.IOException - if an error occurred during file open/read operation.

createRegionOnFileSystem

public static HRegionFileSystem createRegionOnFileSystem(Configuration conf,
                                                         FileSystem fs,
                                                         Path tableDir,
                                                         HRegionInfo regionInfo)
                                                  throws java.io.IOException

Create a new Region on file-system.

Parameters:

conf - the Configuration to use

fs - FileSystem from which to add the region

tableDir - Path to where the table is being stored

regionInfo - HRegionInfo for region to be added

Throws:

java.io.IOException - if the region creation fails due to a FileSystem exception.

openRegionFromFileSystem

public static HRegionFileSystem openRegionFromFileSystem(Configuration conf,
                                                         FileSystem fs,
                                                         Path tableDir,
                                                         HRegionInfo regionInfo,
                                                         boolean readOnly)
                                                  throws java.io.IOException

Open Region from file-system.

Parameters:

conf - the Configuration to use

fs - FileSystem from which to add the region

tableDir - Path to where the table is being stored

regionInfo - HRegionInfo for region to be added

readOnly - True if you don't want to edit the region data

Throws:

java.io.IOException - if the region creation fails due to a FileSystem exception.

deleteRegionFromFileSystem

public static void deleteRegionFromFileSystem(Configuration conf,
                                              FileSystem fs,
                                              Path tableDir,
                                              HRegionInfo regionInfo)
                                       throws java.io.IOException

Remove the region from the table directory, archiving the region's hfiles.

Parameters:

conf - the Configuration to use

fs - FileSystem from which to remove the region

tableDir - Path to where the table is being stored

regionInfo - HRegionInfo for region to be deleted

Throws:

java.io.IOException - if the request cannot be completed