org.apache.nutch.segment

Class SegmentMerger

java.lang.Object

org.apache.hadoop.conf.Configured

org.apache.nutch.segment.SegmentMerger

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, Configurable, JobConfigurable, Mapper<Text,MetaWrapper,Text,MetaWrapper>, Reducer<Text,MetaWrapper,Text,MetaWrapper>, Tool

public class SegmentMerger
extends Configured
implements Tool, Mapper<Text,MetaWrapper,Text,MetaWrapper>, Reducer<Text,MetaWrapper,Text,MetaWrapper>

This tool takes several segments and merges their data together. Only the latest versions of data is retained. Optionally, you can apply current URLFilters to remove prohibited URL-s.

Also, it's possible to slice the resulting segment into chunks of fixed size.

Important Notes

Which parts are merged?

It doesn't make sense to merge data from segments, which are at different stages of processing (e.g. one unfetched segment, one fetched but not parsed, and one fetched and parsed). Therefore, prior to merging, the tool will determine the lowest common set of input data, and only this data will be merged. This may have some unintended consequences: e.g. if majority of input segments are fetched and parsed, but one of them is unfetched, the tool will fall back to just merging fetchlists, and it will skip all other data from all segments.

Merging fetchlists

Merging segments, which contain just fetchlists (i.e. prior to fetching) is not recommended, because this tool (unlike the Generator doesn't ensure that fetchlist parts for each map task are disjoint.

Duplicate content

Merging segments removes older content whenever possible (see below). However, this is NOT the same as de-duplication, which in addition removes identical content found at different URL-s. In other words, running DeleteDuplicates is still necessary.

For some types of data (especially ParseText) it's not possible to determine which version is really older. Therefore the tool always uses segment names as timestamps, for all types of input data. Segment names are compared in forward lexicographic order (0-9a-zA-Z), and data from segments with "higher" names will prevail. It follows then that it is extremely important that segments be named in an increasing lexicographic order as their creation time increases.

Merging and indexes

Merged segment gets a different name. Since Indexer embeds segment names in indexes, any indexes originally created for the input segments will NOT work with the merged segment. Newly created merged segment(s) need to be indexed afresh. This tool doesn't use existing indexes in any way, so if you plan to merge segments you don't have to index them prior to merging.

Author:

Andrzej Bialecki

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SegmentMerger.ObjectInputFormat Wraps inputs in an MetaWrapper, to permit merging different types in reduce and use additional metadata.
static class	SegmentMerger.SegmentOutputFormat

Constructor Summary

Constructors

Constructor and Description
SegmentMerger()
SegmentMerger(Configuration conf)

Method Summary

Modifier and Type	Method and Description
void	close()
void	configure(JobConf conf)
static void	main(java.lang.String[] args)
void	map(Text key, MetaWrapper value, OutputCollector<Text,MetaWrapper> output, Reporter reporter)
void	merge(Path out, Path[] segs, boolean filter, boolean normalize, long slice)
void	reduce(Text key, java.util.Iterator<MetaWrapper> values, OutputCollector<Text,MetaWrapper> output, Reporter reporter) NOTE: in selecting the latest version we rely exclusively on the segment name (not all segment data contain time information).
int	run(java.lang.String[] args)
void	setConf(Configuration conf)

Methods inherited from class org.apache.hadoop.conf.Configured

getConf

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.hadoop.conf.Configurable

getConf

Constructor Detail

SegmentMerger

public SegmentMerger()

SegmentMerger

public SegmentMerger(Configuration conf)

Method Detail

setConf

public void setConf(Configuration conf)

Specified by:

setConf in interface Configurable

Overrides:

setConf in class Configured

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException

configure

public void configure(JobConf conf)

Specified by:

configure in interface JobConfigurable

map

public void map(Text key,
                MetaWrapper value,
                OutputCollector<Text,MetaWrapper> output,
                Reporter reporter)
         throws java.io.IOException

Specified by:

map in interface Mapper<Text,MetaWrapper,Text,MetaWrapper>

Throws:

java.io.IOException

reduce

public void reduce(Text key,
                   java.util.Iterator<MetaWrapper> values,
                   OutputCollector<Text,MetaWrapper> output,
                   Reporter reporter)
            throws java.io.IOException

NOTE: in selecting the latest version we rely exclusively on the segment name (not all segment data contain time information). Therefore it is extremely important that segments be named in an increasing lexicographic order as their creation time increases.

Specified by:

reduce in interface Reducer<Text,MetaWrapper,Text,MetaWrapper>

Throws:

java.io.IOException

merge

public void merge(Path out,
                  Path[] segs,
                  boolean filter,
                  boolean normalize,
                  long slice)
           throws java.lang.Exception

Throws:

java.lang.Exception

run

public int run(java.lang.String[] args)
        throws java.lang.Exception

Specified by:

run in interface Tool

Parameters:

args -

Throws:

java.lang.Exception

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

Throws:

java.lang.Exception