org.apache.hadoop.hbase.mapreduce

Class TableSnapshotInputFormatImpl

java.lang.Object

org.apache.hadoop.hbase.mapreduce.TableSnapshotInputFormatImpl

@InterfaceAudience.Private
 @InterfaceStability.Evolving
public class TableSnapshotInputFormatImpl
extends java.lang.Object

Hadoop MR API-agnostic implementation for mapreduce over table snapshots.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TableSnapshotInputFormatImpl.InputSplit Implementation class for InputSplit logic common between mapred and mapreduce.
static class	TableSnapshotInputFormatImpl.RecordReader Implementation class for RecordReader logic common between mapred and mapreduce.

Constructor Summary

Constructors

Constructor and Description
TableSnapshotInputFormatImpl()

Method Summary

Modifier and Type	Method and Description
static java.util.List<java.lang.String>	getBestLocations(Configuration conf, HDFSBlocksDistribution blockDistribution) This computes the locations to be passed from the InputSplit.
static java.util.List<TableSnapshotInputFormatImpl.InputSplit>	getSplits(Configuration conf)
static void	setInput(Configuration conf, java.lang.String snapshotName, Path restoreDir) Configures the job to use TableSnapshotInputFormat to read from a snapshot.

Methods inherited from class java.lang.Object

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

Constructor Detail

TableSnapshotInputFormatImpl

public TableSnapshotInputFormatImpl()

Method Detail

getSplits

public static java.util.List<TableSnapshotInputFormatImpl.InputSplit> getSplits(Configuration conf)
                                                                         throws java.io.IOException

Throws:

java.io.IOException

getBestLocations

public static java.util.List<java.lang.String> getBestLocations(Configuration conf,
                                                                HDFSBlocksDistribution blockDistribution)

This computes the locations to be passed from the InputSplit. MR/Yarn schedulers does not take weights into account, thus will treat every location passed from the input split as equal. We do not want to blindly pass all the locations, since we are creating one split per region, and the region's blocks are all distributed throughout the cluster unless favorite node assignment is used. On the expected stable case, only one location will contain most of the blocks as local. On the other hand, in favored node assignment, 3 nodes will contain highly local blocks. Here we are doing a simple heuristic, where we will pass all hosts which have at least 80% (hbase.tablesnapshotinputformat.locality.cutoff.multiplier) as much block locality as the top host with the best locality.

setInput

public static void setInput(Configuration conf,
                            java.lang.String snapshotName,
                            Path restoreDir)
                     throws java.io.IOException

Configures the job to use TableSnapshotInputFormat to read from a snapshot.

Parameters:

conf - the job to configuration

snapshotName - the name of the snapshot to read from

restoreDir - a temporary directory to restore the snapshot into. Current user should have write permissions to this directory, and this should not be a subdirectory of rootdir. After the job is finished, restoreDir can be deleted.

Throws:

java.io.IOException - if an error occurs