org.apache.hadoop.hbase.regionserver.wal

Class WALUtil

java.lang.Object

org.apache.hadoop.hbase.regionserver.wal.WALUtil

@InterfaceAudience.Private
public class WALUtil
extends Object

Helper methods to ease Region Server integration with the write ahead log. Note that methods in this class specifically should not require access to anything other than the API found in WAL.

Method Summary

Methods

Modifier and Type	Method and Description
static long	writeBulkLoadMarkerAndSync(WAL wal, HTableDescriptor htd, HRegionInfo hri, WALProtos.BulkLoadDescriptor desc, MultiVersionConcurrencyControl mvcc) Write a log marker that a bulk load has succeeded and is about to be committed.
static long	writeCompactionMarker(WAL wal, HTableDescriptor htd, HRegionInfo hri, WALProtos.CompactionDescriptor c, MultiVersionConcurrencyControl mvcc) Write the marker that a compaction has succeeded and is about to be committed.
static long	writeFlushMarker(WAL wal, HTableDescriptor htd, HRegionInfo hri, WALProtos.FlushDescriptor f, boolean sync, MultiVersionConcurrencyControl mvcc) Write a flush marker indicating a start / abort or a complete of a region flush
static long	writeRegionEventMarker(WAL wal, HTableDescriptor htd, HRegionInfo hri, WALProtos.RegionEventDescriptor r, MultiVersionConcurrencyControl mvcc) Write a region open marker indicating that the region is opened

Methods inherited from class java.lang.Object

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

Method Detail

writeCompactionMarker

public static long writeCompactionMarker(WAL wal,
                         HTableDescriptor htd,
                         HRegionInfo hri,
                         WALProtos.CompactionDescriptor c,
                         MultiVersionConcurrencyControl mvcc)
                                  throws IOException

Write the marker that a compaction has succeeded and is about to be committed. This provides info to the HMaster to allow it to recover the compaction if this regionserver dies in the middle (This part is not yet implemented). It also prevents the compaction from finishing if this regionserver has already lost its lease on the log.

Parameters:

mvcc - Used by WAL to get sequence Id for the waledit.

Throws:

IOException

writeFlushMarker

public static long writeFlushMarker(WAL wal,
                    HTableDescriptor htd,
                    HRegionInfo hri,
                    WALProtos.FlushDescriptor f,
                    boolean sync,
                    MultiVersionConcurrencyControl mvcc)
                             throws IOException

Write a flush marker indicating a start / abort or a complete of a region flush

Throws:

IOException

writeRegionEventMarker

public static long writeRegionEventMarker(WAL wal,
                          HTableDescriptor htd,
                          HRegionInfo hri,
                          WALProtos.RegionEventDescriptor r,
                          MultiVersionConcurrencyControl mvcc)
                                   throws IOException

Write a region open marker indicating that the region is opened

Throws:

IOException

writeBulkLoadMarkerAndSync

public static long writeBulkLoadMarkerAndSync(WAL wal,
                              HTableDescriptor htd,
                              HRegionInfo hri,
                              WALProtos.BulkLoadDescriptor desc,
                              MultiVersionConcurrencyControl mvcc)
                                       throws IOException

Write a log marker that a bulk load has succeeded and is about to be committed.

Parameters:

wal - The log to write into.

htd - A description of the table that we are bulk loading into.

hri - A description of the region in the table that we are bulk loading into.

desc - A protocol buffers based description of the client's bulk loading request

Returns:

txid of this transaction or if nothing to do, the last txid

Throws:

IOException - We will throw an IOException if we can not append to the HLog.