org.apache.hadoop.hbase.wal

Class WALSplitter

java.lang.Object

org.apache.hadoop.hbase.wal.WALSplitter

@InterfaceAudience.Private
public class WALSplitter
extends Object

Split RegionServer WAL files. Splits the WAL into new files, one per region, to be picked up on Region reopen. Deletes the split WAL when finished. See split(Path, Path, Path, FileSystem, Configuration, WALFactory) or splitLogFile(Path, FileStatus, FileSystem, Configuration, CancelableProgressable, LastSequenceId, SplitLogWorkerCoordination, WALFactory, RegionServerServices) for entry-point.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	WALSplitter.CorruptedLogFileException
static class	WALSplitter.PipelineController Contains some methods to control WAL-entries producer / consumer interactions

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.hadoop.conf.Configuration	conf
static boolean	DEFAULT_WAL_SPLIT_TO_HFILE
private EntryBuffers	entryBuffers
private org.apache.hadoop.fs.FileStatus	fileBeingSplit
protected Map<String,Long>	lastFlushedSequenceIds
private static org.slf4j.Logger	LOG
(package private) OutputSink	outputSink
protected Map<String,Map<byte[],Long>>	regionMaxSeqIdInStores
(package private) org.apache.hadoop.fs.Path	rootDir
(package private) org.apache.hadoop.fs.FileSystem	rootFS
(package private) RegionServerServices	rsServices
protected LastSequenceId	sequenceIdChecker
static boolean	SPLIT_SKIP_ERRORS_DEFAULT By default we retry errors in splitting, rather than skipping.
static String	SPLIT_WAL_BUFFER_SIZE
static String	SPLIT_WAL_WRITER_THREADS
static String	SPLIT_WRITER_CREATION_BOUNDED True if we are to run with bounded amount of writers rather than let the count blossom.
private SplitLogWorkerCoordination	splitLogWorkerCoordination Coordinator for split log.
private MonitoredTask	status
private String	tmpDirName
static String	WAL_SPLIT_TO_HFILE Split WAL directly to hfiles instead of into intermediary 'recovered.edits' files.
protected org.apache.hadoop.fs.Path	walDir
private WALFactory	walFactory
protected org.apache.hadoop.fs.FileSystem	walFS

Constructor Summary

Constructors

Constructor and Description
WALSplitter(WALFactory factory, org.apache.hadoop.conf.Configuration conf, org.apache.hadoop.fs.Path walDir, org.apache.hadoop.fs.FileSystem walFS, org.apache.hadoop.fs.Path rootDir, org.apache.hadoop.fs.FileSystem rootFS, LastSequenceId idChecker, SplitLogWorkerCoordination splitLogWorkerCoordination, RegionServerServices rsServices)

Method Summary

Modifier and Type	Method and Description
protected WALProvider.Writer	createWriter(org.apache.hadoop.fs.Path logfile) Create a new WALProvider.Writer for writing log splits.
(package private) org.apache.hadoop.fs.FileStatus	getFileBeingSplit()
private WAL.Entry	getNextLogLine(WAL.Reader in, org.apache.hadoop.fs.Path path, boolean skipErrors)
private int	getNumOpenWriters() Get current open writers
private WAL.Reader	getReader(org.apache.hadoop.fs.FileStatus file, boolean skipErrors, CancelableProgressable reporter) Create a new WAL.Reader for reading logs to split.
protected WAL.Reader	getReader(org.apache.hadoop.fs.Path curLogFile, CancelableProgressable reporter) Create a new WAL.Reader for reading logs to split.
(package private) Map<String,Map<byte[],Long>>	getRegionMaxSeqIdInStores()
(package private) String	getTmpDirName()
(package private) WALFactory	getWalFactory()
private boolean	isRegionDirPresentUnderRoot(TableName tableName, String regionName)
static List<org.apache.hadoop.fs.Path>	split(org.apache.hadoop.fs.Path walDir, org.apache.hadoop.fs.Path logDir, org.apache.hadoop.fs.Path oldLogDir, org.apache.hadoop.fs.FileSystem walFS, org.apache.hadoop.conf.Configuration conf, WALFactory factory) Split a folder of WAL files.
(package private) boolean	splitLogFile(org.apache.hadoop.fs.FileStatus logfile, CancelableProgressable reporter) WAL splitting implementation, splits one log file.
static boolean	splitLogFile(org.apache.hadoop.fs.Path walDir, org.apache.hadoop.fs.FileStatus logfile, org.apache.hadoop.fs.FileSystem walFS, org.apache.hadoop.conf.Configuration conf, CancelableProgressable reporter, LastSequenceId idChecker, SplitLogWorkerCoordination splitLogWorkerCoordination, WALFactory factory, RegionServerServices rsServices) Splits a WAL file.

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final org.slf4j.Logger LOG

SPLIT_SKIP_ERRORS_DEFAULT

public static final boolean SPLIT_SKIP_ERRORS_DEFAULT

By default we retry errors in splitting, rather than skipping.

See Also:

Constant Field Values

walDir

protected final org.apache.hadoop.fs.Path walDir

walFS

protected final org.apache.hadoop.fs.FileSystem walFS

conf

protected final org.apache.hadoop.conf.Configuration conf

rootDir

final org.apache.hadoop.fs.Path rootDir

rootFS

final org.apache.hadoop.fs.FileSystem rootFS

rsServices

final RegionServerServices rsServices

outputSink

OutputSink outputSink

entryBuffers

private EntryBuffers entryBuffers

splitLogWorkerCoordination

private SplitLogWorkerCoordination splitLogWorkerCoordination

Coordinator for split log. Used by the zk-based log splitter. Not used by the procedure v2-based log splitter.

walFactory

private final WALFactory walFactory

status

private MonitoredTask status

sequenceIdChecker

protected final LastSequenceId sequenceIdChecker

lastFlushedSequenceIds

protected Map<String,Long> lastFlushedSequenceIds

regionMaxSeqIdInStores

protected Map<String,Map<byte[],Long>> regionMaxSeqIdInStores

fileBeingSplit

private org.apache.hadoop.fs.FileStatus fileBeingSplit

tmpDirName

private final String tmpDirName

WAL_SPLIT_TO_HFILE

public static final String WAL_SPLIT_TO_HFILE

Split WAL directly to hfiles instead of into intermediary 'recovered.edits' files.

See Also:

Constant Field Values

DEFAULT_WAL_SPLIT_TO_HFILE

public static final boolean DEFAULT_WAL_SPLIT_TO_HFILE

See Also:

Constant Field Values

SPLIT_WRITER_CREATION_BOUNDED

public static final String SPLIT_WRITER_CREATION_BOUNDED

True if we are to run with bounded amount of writers rather than let the count blossom. Default is 'false'. Does not apply if you have set 'hbase.wal.split.to.hfile' as that is always bounded. Only applies when you are doing recovery to 'recovered.edits' files (the old default). Bounded writing tends to have higher throughput.

See Also:

Constant Field Values

SPLIT_WAL_BUFFER_SIZE

public static final String SPLIT_WAL_BUFFER_SIZE

See Also:

Constant Field Values

SPLIT_WAL_WRITER_THREADS

public static final String SPLIT_WAL_WRITER_THREADS

See Also:

Constant Field Values

Constructor Detail

WALSplitter

WALSplitter(WALFactory factory,
            org.apache.hadoop.conf.Configuration conf,
            org.apache.hadoop.fs.Path walDir,
            org.apache.hadoop.fs.FileSystem walFS,
            org.apache.hadoop.fs.Path rootDir,
            org.apache.hadoop.fs.FileSystem rootFS,
            LastSequenceId idChecker,
            SplitLogWorkerCoordination splitLogWorkerCoordination,
            RegionServerServices rsServices)

Method Detail

getWalFactory

WALFactory getWalFactory()

getFileBeingSplit

org.apache.hadoop.fs.FileStatus getFileBeingSplit()

getTmpDirName

String getTmpDirName()

getRegionMaxSeqIdInStores

Map<String,Map<byte[],Long>> getRegionMaxSeqIdInStores()

splitLogFile

public static boolean splitLogFile(org.apache.hadoop.fs.Path walDir,
                                   org.apache.hadoop.fs.FileStatus logfile,
                                   org.apache.hadoop.fs.FileSystem walFS,
                                   org.apache.hadoop.conf.Configuration conf,
                                   CancelableProgressable reporter,
                                   LastSequenceId idChecker,
                                   SplitLogWorkerCoordination splitLogWorkerCoordination,
                                   WALFactory factory,
                                   RegionServerServices rsServices)
                            throws IOException

Splits a WAL file.

Returns:

false if it is interrupted by the progress-able.

Throws:

IOException

split

public static List<org.apache.hadoop.fs.Path> split(org.apache.hadoop.fs.Path walDir,
                                                    org.apache.hadoop.fs.Path logDir,
                                                    org.apache.hadoop.fs.Path oldLogDir,
                                                    org.apache.hadoop.fs.FileSystem walFS,
                                                    org.apache.hadoop.conf.Configuration conf,
                                                    WALFactory factory)
                                             throws IOException

Split a folder of WAL files. Delete the directory when done. Used by tools and unit tests. It should be package private. It is public only because TestWALObserver is in a different package, which uses this method to do log splitting.

Returns:

List of output files created by the split.

Throws:

IOException

splitLogFile

boolean splitLogFile(org.apache.hadoop.fs.FileStatus logfile,
                     CancelableProgressable reporter)
              throws IOException

WAL splitting implementation, splits one log file.

Parameters:

logfile - should be an actual log file.

Throws:

IOException

isRegionDirPresentUnderRoot

private boolean isRegionDirPresentUnderRoot(TableName tableName,
                                            String regionName)
                                     throws IOException

Throws:

IOException

getReader

private WAL.Reader getReader(org.apache.hadoop.fs.FileStatus file,
                             boolean skipErrors,
                             CancelableProgressable reporter)
                      throws IOException,
                             WALSplitter.CorruptedLogFileException

Create a new WAL.Reader for reading logs to split.

Throws:

IOException

WALSplitter.CorruptedLogFileException

getNextLogLine

private WAL.Entry getNextLogLine(WAL.Reader in,
                                 org.apache.hadoop.fs.Path path,
                                 boolean skipErrors)
                          throws WALSplitter.CorruptedLogFileException,
                                 IOException

Throws:

WALSplitter.CorruptedLogFileException

IOException

createWriter

protected WALProvider.Writer createWriter(org.apache.hadoop.fs.Path logfile)
                                   throws IOException

Create a new WALProvider.Writer for writing log splits.

Returns:

a new Writer instance, caller should close

Throws:

IOException

getReader

protected WAL.Reader getReader(org.apache.hadoop.fs.Path curLogFile,
                               CancelableProgressable reporter)
                        throws IOException

Create a new WAL.Reader for reading logs to split.

Returns:

new Reader instance, caller should close

Throws:

IOException

getNumOpenWriters

private int getNumOpenWriters()

Get current open writers