org.apache.hadoop.hbase.regionserver.compactions

Class Compactor<T extends CellSink>

java.lang.Object

org.apache.hadoop.hbase.regionserver.compactions.Compactor<T>

Direct Known Subclasses:

AbstractMultiOutputCompactor, DefaultCompactor

@InterfaceAudience.Private
public abstract class Compactor<T extends CellSink>
extends Object

A compactor is a compaction algorithm associated a given policy. Base class also contains reusable parts for implementing compactors (what is common and what isn't is evolving).

Compactions might be concurrent against a given store and the Compactor is shared among them. Do not put mutable state into class fields. All Compactor class fields should be final or effectively final. 'keepSeqIdPeriod' is an exception to this rule because unit tests may set it.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static interface	Compactor.CellSinkFactory<S>
protected static class	Compactor.FileDetails The sole reason this class exists is that java has no ref/out/pointer parameters.
protected static interface	Compactor.InternalScannerFactory

Field Summary

Fields

Modifier and Type	Field and Description
protected static long	COMPACTION_PROGRESS_LOG_INTERVAL
protected int	compactionKVMax
protected org.apache.hadoop.conf.Configuration	conf
protected Compactor.InternalScannerFactory	defaultScannerFactory
protected boolean	dropCacheMajor
protected boolean	dropCacheMinor
protected int	keepSeqIdPeriod specify how many days to keep MVCC values during major compaction
protected static String	MAJOR_COMPACTION_DROP_CACHE
protected Compression.Algorithm	majorCompactionCompression
protected static String	MINOR_COMPACTION_DROP_CACHE
protected Compression.Algorithm	minorCompactionCompression
protected HStore	store

Method Summary

Modifier and Type	Method and Description
protected abstract void	abortWriter(T writer)
protected abstract List<org.apache.hadoop.fs.Path>	commitWriter(T writer, Compactor.FileDetails fd, CompactionRequestImpl request)
protected List<org.apache.hadoop.fs.Path>	compact(CompactionRequestImpl request, Compactor.InternalScannerFactory scannerFactory, Compactor.CellSinkFactory<T> sinkFactory, ThroughputController throughputController, User user)
protected CreateStoreFileWriterParams	createParams(Compactor.FileDetails fd, boolean shouldDropBehind, boolean major, Consumer<org.apache.hadoop.fs.Path> writerCreationTracker)
protected InternalScanner	createScanner(HStore store, ScanInfo scanInfo, List<StoreFileScanner> scanners, long smallestReadPoint, long earliestPutTs, byte[] dropDeletesFromRow, byte[] dropDeletesToRow)
protected InternalScanner	createScanner(HStore store, ScanInfo scanInfo, List<StoreFileScanner> scanners, ScanType scanType, long smallestReadPoint, long earliestPutTs)
protected StoreFileWriter	createWriter(Compactor.FileDetails fd, boolean shouldDropBehind, boolean major, Consumer<org.apache.hadoop.fs.Path> writerCreationTracker) Creates a writer for a new file.
protected StoreFileWriter	createWriter(Compactor.FileDetails fd, boolean shouldDropBehind, String fileStoragePolicy, boolean major, Consumer<org.apache.hadoop.fs.Path> writerCreationTracker)
CompactionProgress	getProgress() Return the aggregate progress for all currently active compactions.
boolean	isCompacting()
protected boolean	performCompaction(Compactor.FileDetails fd, InternalScanner scanner, CellSink writer, long smallestReadPoint, boolean cleanSeqId, ThroughputController throughputController, CompactionRequestImpl request, CompactionProgress progress) Performs the compaction.

Methods inherited from class java.lang.Object

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

Field Detail

COMPACTION_PROGRESS_LOG_INTERVAL

protected static final long COMPACTION_PROGRESS_LOG_INTERVAL

See Also:

Constant Field Values

conf

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

store

protected final HStore store

compactionKVMax

protected final int compactionKVMax

majorCompactionCompression

protected final Compression.Algorithm majorCompactionCompression

minorCompactionCompression

protected final Compression.Algorithm minorCompactionCompression

keepSeqIdPeriod

protected int keepSeqIdPeriod

specify how many days to keep MVCC values during major compaction

MAJOR_COMPACTION_DROP_CACHE

protected static final String MAJOR_COMPACTION_DROP_CACHE

See Also:

Constant Field Values

MINOR_COMPACTION_DROP_CACHE

protected static final String MINOR_COMPACTION_DROP_CACHE

See Also:

Constant Field Values

dropCacheMajor

protected final boolean dropCacheMajor

dropCacheMinor

protected final boolean dropCacheMinor

defaultScannerFactory

protected final Compactor.InternalScannerFactory defaultScannerFactory

Method Detail

createParams

protected final CreateStoreFileWriterParams createParams(Compactor.FileDetails fd,
                                                         boolean shouldDropBehind,
                                                         boolean major,
                                                         Consumer<org.apache.hadoop.fs.Path> writerCreationTracker)

createWriter

protected final StoreFileWriter createWriter(Compactor.FileDetails fd,
                                             boolean shouldDropBehind,
                                             boolean major,
                                             Consumer<org.apache.hadoop.fs.Path> writerCreationTracker)
                                      throws IOException

Creates a writer for a new file.

Parameters:

fd - The file details.

Returns:

Writer for a new StoreFile

Throws:

IOException - if creation failed

createWriter

protected final StoreFileWriter createWriter(Compactor.FileDetails fd,
                                             boolean shouldDropBehind,
                                             String fileStoragePolicy,
                                             boolean major,
                                             Consumer<org.apache.hadoop.fs.Path> writerCreationTracker)
                                      throws IOException

Throws:

IOException

compact

protected final List<org.apache.hadoop.fs.Path> compact(CompactionRequestImpl request,
                                                        Compactor.InternalScannerFactory scannerFactory,
                                                        Compactor.CellSinkFactory<T> sinkFactory,
                                                        ThroughputController throughputController,
                                                        User user)
                                                 throws IOException

Throws:

IOException

commitWriter

protected abstract List<org.apache.hadoop.fs.Path> commitWriter(T writer,
                                                                Compactor.FileDetails fd,
                                                                CompactionRequestImpl request)
                                                         throws IOException

Throws:

IOException

abortWriter

protected abstract void abortWriter(T writer)
                             throws IOException

Throws:

IOException

performCompaction

protected boolean performCompaction(Compactor.FileDetails fd,
                                    InternalScanner scanner,
                                    CellSink writer,
                                    long smallestReadPoint,
                                    boolean cleanSeqId,
                                    ThroughputController throughputController,
                                    CompactionRequestImpl request,
                                    CompactionProgress progress)
                             throws IOException

Performs the compaction.

Parameters:

fd - FileDetails of cell sink writer

scanner - Where to read from.

writer - Where to write to.

smallestReadPoint - Smallest read point.

cleanSeqId - When true, remove seqId(used to be mvcc) value which is <= smallestReadPoint

request - compaction request.

progress - Progress reporter.

Returns:

Whether compaction ended; false if it was interrupted for some reason.

Throws:

IOException

createScanner

protected InternalScanner createScanner(HStore store,
                                        ScanInfo scanInfo,
                                        List<StoreFileScanner> scanners,
                                        ScanType scanType,
                                        long smallestReadPoint,
                                        long earliestPutTs)
                                 throws IOException

Parameters:

store - store

scanners - Store file scanners.

scanType - Scan type.

smallestReadPoint - Smallest MVCC read point.

earliestPutTs - Earliest put across all files.

Returns:

A compaction scanner.

Throws:

IOException

createScanner

protected InternalScanner createScanner(HStore store,
                                        ScanInfo scanInfo,
                                        List<StoreFileScanner> scanners,
                                        long smallestReadPoint,
                                        long earliestPutTs,
                                        byte[] dropDeletesFromRow,
                                        byte[] dropDeletesToRow)
                                 throws IOException

Parameters:

store - The store.

scanners - Store file scanners.

smallestReadPoint - Smallest MVCC read point.

earliestPutTs - Earliest put across all files.

dropDeletesFromRow - Drop deletes starting with this row, inclusive. Can be null.

dropDeletesToRow - Drop deletes ending with this row, exclusive. Can be null.

Returns:

A compaction scanner.

Throws:

IOException

getProgress

public CompactionProgress getProgress()

Return the aggregate progress for all currently active compactions.

isCompacting

public boolean isCompacting()