Hadoop 简明教程

hadoop中mapreduce的常用类(1)

写这个文章的时候才意识到新旧API是同时存在于1.1.2的hadoop中的。以前还一直纳闷儿为什么有时候是jobClient提交任务,有时是Job…不管API是否更新,下面这些类也还是存在于API中的,经过自己跟踪源码,发现原理还是这些。只不过进行了重新组织,进行了一些封装,使得扩展性更好。所以还是把这些东西从记事本贴进来吧。

关于这些类的介绍以及使用,有的是在自己debug中看到的,多数为纯翻译API的注释,但是翻译的过程受益良多。

GenericOptionsParser

parseGeneralOptions(Options opts, Configuration conf, String[]
args)解析命令行参数

GenericOptionsParser是为hadoop框架解析命令行参数的工具类。它能够辨认标准的命令行参数,使app能够轻松指定namenode,jobtracker,以及额外的配置资源或信息等。它支持的功能有:

-conf 指定配置文件;

-D 指定配置信息;

-fs 指定namenode

-jt 指定jobtracker

-files 指定需要copy到MR集群的文件,以逗号分隔

-libjars指定需要copy到MR集群的classpath的jar包,以逗号分隔

-archives指定需要copy到MR集群的压缩文件,以逗号分隔,会自动解压缩

  1. String[] otherArgs = new GenericOptionsParser(job, args)

  2. .getRemainingArgs();

  3. if (otherArgs.length != 2) {

  4. System.err.println(“Usage: wordcount “);

  5. System.exit(2);

  6. }

ToolRunner

用来跑实现Tool接口的工具。它与GenericOptionsParser合作来解析命令行参数,只在此次运行中更改configuration的参数。

Tool

处理命令行参数的接口。Tool是MR的任何tool/app的标准。这些实现应该代理对标准命令行参数的处理。下面是典型实现:

public class MyApp extends Configured implements Tool {              public int run(String[] args) throws Exception {   // 即将被ToolRunner执行的Configuration   Configuration conf = getConf();               // 使用conf建立JobConf   JobConf job = new JobConf(conf, MyApp.class);           // 执行客户端参数   Path in = new Path(args[1]);   Path out = new Path(args[2]);               // 指定job相关的参数        job.setJobName("my-app");   job.setInputPath(in);   job.setOutputPath(out);   job.setMapperClass(MyApp.MyMapper.class);   job.setReducerClass(MyApp.MyReducer.class);   *   // 提交job,然后监视进度直到job完成   JobClient.runJob(job);   }              public static void main(String[] args) throws Exception {   // 让ToolRunner 处理命令行参数    int res = ToolRunner.run(new Configuration(), new Sort(), //这里封装了GenericOptionsParser解析args               System.exit(res);   }   }   

MultipleOutputFormat

自定义输出文件名称或者说名称格式。在jobconf中setOutputFormat(MultipleOutputFormat的子类)就行了。而不是那种part-r-00000啥的了。。。并且可以分配结果到多个文件中。

MultipleOutputFormat继承了FileOutputFormat,
允许将输出数据写进不同的输出文件中。有三种应用场景:

a.
最少有一个reducer的mapreduce任务。这个reducer想要根据实际的key将输出写进不同的文件中。假设一个key编码了实际的key和为实际的key指定的位置

b.
只有map的任务。这个任务想要把输入文件或者输入内容的部分名称设为输出文件名。

c. 只有map的任务。这个任务为输出命名时,需要依赖keys和输入文件名。 

//这里是根据key生成多个文件的地方,可以看到还有value,name等参数   @Override   protected String generateFileNameForKeyValue(Text key,   IntWritable value, String name) {   char c = key.toString().toLowerCase().charAt(0);   if (c >= 'a' && c <= 'z') {   return c + ".txt";   }   return "result.txt";   }   

DistributedCache

在集群中快速分发大的只读文件。DistributedCache是MR用来缓存app需要的诸如text,archive,jar等的文件的。app通过jobconf中的url来指定需要缓存的文件。它会假定指定的这个文件已经在url指定的对应位置上了。在job在node上执行之前,DistributedCache会copy必要的文件到这个slave
node。它的功效就是为每个job只copy一次,而且copy到指定位置,能够自动解压缩。

DistributedCache可以用来分发简单的只读文件,或者一些复杂的例如archive,jar文件等。archive文件会自动解压缩,而jar文件会被自动放置到任务的classpath中(lib)。分发压缩archive时,可以指定解压名称如:dict.zip#dict。这样就会解压到dict中,否则默认是dict.zip中。

文件是有执行权限的。用户可以选择在任务的工作目录下建立指向DistributedCache的软链接。

DistributedCache.createSymlink(conf);     DistributedCache.addCacheFile(new Path("hdfs://host:port/absolute-path#link-name").toUri(), conf);      

DistributedCache.createSymlink(Configuration)方法让DistributedCache
在当前工作目录下创建到缓存文件的符号链接。则在task的当前工作目录会有link-name的链接,相当于快捷方法,链接到expr.txt文件,在setup方法使用的情况则要简单许多。或者通过设置配置文件属性mapred.create.symlink为yes。
分布式缓存会截取URI的片段作为链接的名字。 例如,URI是
hdfs://namenode:port/lib.so.1#lib.so,
则在task当前工作目录会有名为lib.so的链接,
它会链接分布式缓存中的lib.so.1


图片 1


)
写这个文章的时候才意识到新旧API是同时存在于1.1.2的hadoop中的。以前还一直纳闷儿为什么有时候是jobClient提交任…

版权声明:本文为博主原创文章,未经博主同意不得转载。

目的
这篇教程从用户的角度出发,全面地介绍了Hadoop
Map/Reduce框架的各个方面。
先决条件
请先确认Hadoop被正确安装、配置和正常运行中。更多信息见:
• Hadoop快速入门对初次使用者。
• Hadoop集群搭建对大规模分布式集群。
概述
Hadoop
Map/Reduce是一个使用简易的软件框架,基于它写出来的应用程序能够运行在由上千个商用机器组成的大型集群上,并以一种可靠容错的方式并行处理上T级别的数据集。
一个Map/Reduce 作业(job)
通常会把输入的数据集切分为若干独立的数据块,由
map任务(task)以完全并行的方式处理它们。框架会对map的输出先进行排序,
然后把结果输入给reduce任务。通常作业的输入和输出都会被存储在文件系统中。
整个框架负责任务的调度和监控,以及重新执行已经失败的任务。
通常,Map/Reduce框架和分布式文件系统是运行在一组相同的节点上的,也就是说,计算节点和存储节点通常在一起。这种配置允许框架在那些已经存好数据的节点上高效地调度任务,这可以使整个集群的网络带宽被非常高效地利用。
Map/Reduce框架由一个单独的master JobTracker 和每个集群节点一个slave
TaskTracker共同组成。master负责调度构成一个作业的所有任务,这些任务分布在不同的slave上,master监控它们的执行,重新执行已经失败的任务。而slave仅负责执行由master指派的任务。
应用程序至少应该指明输入/输出的位置(路径),并通过实现合适的接口或抽象类提供map和reduce函数。再加上其他作业的参数,就构成了作业配置(job
configuration)。然后,Hadoop的 job
client提交作业(jar包/可执行程序等)和配置信息给JobTracker,后者负责分发这些软件和配置信息给slave、调度任务并监控它们的执行,同时提供状态和诊断信息给job-client。
虽然Hadoop框架是用JavaTM实现的,但Map/Reduce应用程序则不一定要用
Java来写 。
• Hadoop
Streaming是一种运行作业的实用工具,它允许用户创建和运行任何可执行程序
(例如:Shell工具)来做为mapper和reducer。
• Hadoop Pipes是一个与SWIG兼容的C++ API
(没有基于JNITM技术),它也可用于实现Map/Reduce应用程序。
输入与输出
Map/Reduce框架运转在<key, value> 键值对上,也就是说,
框架把作业的输入看为是一组<key, value> 键值对,同样也产出一组
<key, value> 键值对做为作业的输出,这两组键值对的类型可能不同。
框架需要对key和value的类(classes)进行序列化操作, 因此,这些类需要实现
Writable接口。 另外,为了方便框架执行排序操作,key类必须实现
WritableComparable接口。
一个Map/Reduce 作业的输入和输出类型如下所示:
(input) <k1, v1> -> map -> <k2, v2> -> combine
-> <k2, Iterator<v2>> -> reduce -> <k3, v3>
(output)
例子:WordCount v1.0
在深入细节之前,让我们先看一个Map/Reduce的应用示例,以便对它们的工作方式有一个初步的认识。
WordCount是一个简单的应用,它可以计算出指定数据集中每一个单词出现的次数。
这个应用适用于 单机模式, 伪分布式模式 或 完全分布式模式
三种Hadoop安装方式。

package org.myorg; 

import java.io.IOException; 
import java.util.*; 

import org.apache.hadoop.fs.Path; 
import org.apache.hadoop.conf.*; 
import org.apache.hadoop.io.*; 
import org.apache.hadoop.mapred.*; 
import org.apache.hadoop.util.*; 

public class WordCount { 

   public static class Map extends MapReduceBase implements Mapper<LongWritable, Text, Text, IntWritable> { 
     private final static IntWritable one = new IntWritable(1); 
     private Text word = new Text(); 

     public void map(LongWritable key, Text value, OutputCollector<Text, IntWritable> output, Reporter reporter) throws IOException { 
       String line = value.toString(); 
       StringTokenizer tokenizer = new StringTokenizer(line); 
       while (tokenizer.hasMoreTokens()) { 
         word.set(tokenizer.nextToken()); 
         output.collect(word, one); 
       } 
     } 
   } 

   public static class Reduce extends MapReduceBase implements Reducer<Text, IntWritable, Text, IntWritable> { 
     public void reduce(Text key, Iterator<IntWritable> values, OutputCollector<Text, IntWritable> output, Reporter reporter) throws IOException { 
       int sum = 0; 
       while (values.hasNext()) { 
         sum += values.next().get(); 
       } 
       output.collect(key, new IntWritable(sum)); 
     } 
   } 

   public static void main(String[] args) throws Exception { 
     JobConf conf = new JobConf(WordCount.class); 
     conf.setJobName("wordcount"); 

     conf.setOutputKeyClass(Text.class); 
     conf.setOutputValueClass(IntWritable.class); 

     conf.setMapperClass(Map.class); 
     conf.setCombinerClass(Reduce.class); 
     conf.setReducerClass(Reduce.class); 

     conf.setInputFormat(TextInputFormat.class); 
     conf.setOutputFormat(TextOutputFormat.class); 

     FileInputFormat.setInputPaths(conf, new Path(args[0])); 
     FileOutputFormat.setOutputPath(conf, new Path(args[1])); 

     JobClient.runJob(conf); 
   } 
} 

近期在做数据分析的时候。须要在mapreduce中调用c语言写的接口,此时就须要把动态链接库so文件分发到hadoop的各个节点上,原来想自己来做这个分发,大概过程就是把so文件放在hdfs上面,然后做mapreduce的时候把so文件从hdfs下载到本地。但查询资料后发现hadoop有相应的组件来帮助我们完毕这个操作,这个组件就是DistributedCache,分布式缓存。运用这个东西能够做到第三方文件的分发和缓存功能,下面具体解释:

用法
假设环境变量HADOOP_HOME对应安装时的根目录,HADOOP_VERSION对应Hadoop的当前安装版本,编译WordCount.java来创建jar包,可如下操作:
$ mkdir wordcount_classes
$ javac -classpath ${HADOOP_HOME}/hadoop-${HADOOP_VERSION}-core.jar -d
wordcount_classes WordCount.java
$ jar -cvf /usr/joe/wordcount.jar -C wordcount_classes/ .
假设:
• /usr/joe/wordcount/input – 是HDFS中的输入路径
• /usr/joe/wordcount/output – 是HDFS中的输出路径
用示例文本文件做为输入:
$ bin/hadoop dfs -ls /usr/joe/wordcount/input/
/usr/joe/wordcount/input/file01
/usr/joe/wordcount/input/file02

假设我们须要在map之间共享一些数据,假设信息量不大,我们能够保持在conf中。可是假设我们须要共享一些配置文件,jar包之类的。此时DistributedCache能够满足我们的需求,使用DistributedCache的过程例如以下:

$ bin/hadoop dfs -cat /usr/joe/wordcount/input/file01
Hello World Bye World

1.正确配置被分发的文件的路径

$ bin/hadoop dfs -cat /usr/joe/wordcount/input/file02
Hello Hadoop Goodbye Hadoop
运行应用程序:
$ bin/hadoop jar /usr/joe/wordcount.jar org.myorg.WordCount
/usr/joe/wordcount/input /usr/joe/wordcount/output
输出是:
$ bin/hadoop dfs -cat /usr/joe/wordcount/output/part-00000
Bye 1
Goodbye 1
Hadoop 2
Hello 2
World 2
应用程序能够使用-files选项来指定一个由逗号分隔的路径列表,这些路径是task的当前工作目录。使用选项-libjars可以向map和reduce的classpath中添加jar包。使用-archives选项程序可以传递档案文件做为参数,这些档案文件会被解压并且在task的当前工作目录下会创建一个指向解压生成的目录的符号链接(以压缩包的名字命名)。
有关命令行选项的更多细节请参考 Commands manual。
使用-libjars和-files运行wordcount例子:
hadoop jar hadoop-examples.jar wordcount -files cachefile.txt -libjars
mylib.jar input output
解释
WordCount应用程序非常直截了当。
Mapper(14-26行)中的map方法(18-25行)通过指定的
TextInputFormat(49行)一次处理一行。然后,它通过StringTokenizer
以空格为分隔符将一行切分为若干tokens,之后,输出< <word>, 1>
形式的键值对。
对于示例中的第一个输入,map输出是:
< Hello, 1>
< World, 1>
< Bye, 1>
< World, 1>
第二个输入,map输出是:
< Hello, 1>
< Hadoop, 1>
< Goodbye, 1>
< Hadoop, 1>
关于组成一个指定作业的map数目的确定,以及如何以更精细的方式去控制这些map,我们将在教程的后续部分学习到更多的内容。
WordCount还指定了一个combiner
(46行)。因此,每次map运行之后,会对输出按照key进行排序,然后把输出传递给本地的combiner(按照作业的配置与Reducer一样),进行本地聚合。
第一个map的输出是:
< Bye, 1>
< Hello, 1>
< World, 2>
第二个map的输出是:
< Goodbye, 1>
< Hadoop, 2>
< Hello, 1>
代码中的run方法中指定了作业的几个方面,
例如:通过命令行传递过来的输入/输出路径、key/value的类型、输入/输出的格式等等JobConf中的配置信息。随后程序调用了JobClient.runJob(55行)来提交作业并且监控它的执行。
我们将在本教程的后续部分学习更多的关于JobConf, JobClient,
Tool和其他接口及类(class)。

2.在自己定义的mapper或reducer中获取文件下载到本地后的路径(linux文件系统路径);通常是重写configure或者重写setup

Map/Reduce 用户界面
这部分文档为用户将会面临的Map/Reduce框架中的各个环节提供了适当的细节。这应该会帮助用户更细粒度地去实现、配置和调优作业。然而,请注意每个类/接口的javadoc文档提供最全面的文档;本文只是想起到指南的作用。
我们会先看看Mapper和Reducer接口。应用程序通常会通过提供map和reduce方法来实现它们。
然后,我们会讨论其他的核心接口,其中包括:
JobConf,JobClient,Partitioner, OutputCollector,Reporter,
InputFormat,OutputFormat等等。
最后,我们将通过讨论框架中一些有用的功能点(例如:DistributedCache,
IsolationRunner等等)来收尾。
核心功能描述
应用程序通常会通过提供map和reduce来实现
Mapper和Reducer接口,它们组成作业的核心。
Mapper
Mapper将输入键值对(key/value pair)映射到一组中间格式的键值对集合。
Map是一类将输入记录集转换为中间格式记录集的独立任务。
这种转换的中间格式记录集不需要与输入记录集的类型一致。一个给定的输入键值对可以映射成0个或多个输出键值对。
Hadoop
Map/Reduce框架为每一个InputSplit产生一个map任务,而每个InputSplit是由该作业的InputFormat产生的。
概括地说,对Mapper的实现者需要重写
JobConfigurable.configure(JobConf)方法,这个方法需要传递一个JobConf参数,目的是完成Mapper的初始化工作。然后,框架为这个任务的InputSplit中每个键值对调用一次
map(WritableComparable, Writable, OutputCollector,
Reporter)操作。应用程序可以通过重写Closeable.close()方法来执行相应的清理工作。
输出键值对不需要与输入键值对的类型一致。一个给定的输入键值对可以映射成0个或多个输出键值对。通过调用
OutputCollector.collect(WritableComparable,Writable)可以收集输出的键值对。
应用程序可以使用Reporter报告进度,设定应用级别的状态消息,更新Counters(计数器),或者仅是表明自己运行正常。
框架随后会把与一个特定key关联的所有中间过程的值(value)分成组,然后把它们传给Reducer以产出最终的结果。用户可以通过
JobConf.setOutputKeyComparatorClass(Class)来指定具体负责分组的
Comparator。
Mapper的输出被排序后,就被划分给每个Reducer。分块的总数目和一个作业的reduce任务的数目是一样的。用户可以通过实现自定义的
Partitioner来控制哪个key被分配给哪个 Reducer。
用户可选择通过
JobConf.setCombinerClass(Class)指定一个combiner,它负责对中间过程的输出进行本地的聚集,这会有助于降低从Mapper到
Reducer数据传输量。
这些被排好序的中间过程的输出结果保存的格式是(key-len, key, value-len,
value),应用程序可以通过JobConf控制对这些中间结果是否进行压缩以及怎么压缩,使用哪种
CompressionCodec。
需要多少个Map?
Map的数目通常是由输入数据的大小决定的,一般就是所有输入文件的总块(block)数。
Map正常的并行规模大致是每个节点(node)大约10到100个map,对于CPU
消耗较小的map任务可以设到300个左右。由于每个任务初始化需要一定的时间,因此,比较合理的情况是map执行的时间至少超过1分钟。
这样,如果你输入10TB的数据,每个块(block)的大小是128MB,你将需要大约82,000个map来完成任务,除非使用
setNumMapTasks(int)(注意:这里仅仅是对框架进行了一个提示(hint),实际决定因素见这里)将这个数值设置得更高。
Reducer
Reducer将与一个key关联的一组中间数值集归约(reduce)为一个更小的数值集。
用户可以通过
JobConf.setNumReduceTasks(int)设定一个作业中reduce任务的数目。
概括地说,对Reducer的实现者需要重写
JobConfigurable.configure(JobConf)方法,这个方法需要传递一个JobConf参数,目的是完成Reducer的初始化工作。然后,框架为成组的输入数据中的每个<key,
(list of values)>对调用一次 reduce(WritableComparable, Iterator,
OutputCollector,
Reporter)方法。之后,应用程序可以通过重写Closeable.close()来执行相应的清理工作。
Reducer有3个主要阶段:shuffle、sort和reduce。
Shuffle
Reducer的输入就是Mapper已经排好序的输出。在这个阶段,框架通过HTTP为每个Reducer获得所有Mapper输出中与之相关的分块。
Sort
这个阶段,框架将按照key的值对Reducer的输入进行分组
(因为不同mapper的输出中可能会有相同的key)。
Shuffle和Sort两个阶段是同时进行的;map的输出也是一边被取回一边被合并的。
Secondary Sort
如果需要中间过程对key的分组规则和reduce前对key的分组规则不同,那么可以通过
JobConf.setOutputValueGroupingComparator(Class)来指定一个Comparator。再加上
JobConf.setOutputKeyComparatorClass(Class)可用于控制中间过程的key如何被分组,所以结合两者可以实现按值的二次排序。
Reduce
在这个阶段,框架为已分组的输入数据中的每个 <key, (list of
values)>对调用一次 reduce(WritableComparable, Iterator,
OutputCollector, Reporter)方法。
Reduce任务的输出通常是通过调用
OutputCollector.collect(WritableComparable, Writable)写入 文件系统的。
应用程序可以使用Reporter报告进度,设定应用程序级别的状态消息,更新Counters(计数器),或者仅是表明自己运行正常。
Reducer的输出是没有排序的。
需要多少个Reduce?
Reduce的数目建议是0.95或1.75乘以 (<no. of nodes> *
mapred.tasktracker.reduce.tasks.maximum)。
用0.95,所有reduce可以在maps一完成时就立刻启动,开始传输map的输出结果。用1.75,速度快的节点可以在完成第一轮reduce任务后,可以开始第二轮,这样可以得到比较好的负载均衡的效果。
增加reduce的数目会增加整个框架的开销,但可以改善负载均衡,降低由于执行失败带来的负面影响。
上述比例因子比整体数目稍小一些是为了给框架中的推测性任务(speculative-tasks)
或失败的任务预留一些reduce的资源。
无Reducer
如果没有归约要进行,那么设置reduce任务的数目为零是合法的。
这种情况下,map任务的输出会直接被写入由
setOutputPath(Path)指定的输出路径。框架在把它们写入FileSystem之前没有对它们进行排序。
Partitioner
Partitioner用于划分键值空间(key space)。
Partitioner负责控制map输出结果key的分割。Key(或者一个key子集)被用于产生分区,通常使用的是Hash函数。分区的数目与一个作业的reduce任务的数目是一样的。因此,它控制将中间过程的key(也就是这条记录)应该发送给m个reduce任务中的哪一个来进行reduce操作。
HashPartitioner是默认的 Partitioner。
Reporter
Reporter是用于Map/Reduce应用程序报告进度,设定应用级别的状态消息,
更新Counters(计数器)的机制。
Mapper和Reducer的实现可以利用Reporter
来报告进度,或者仅是表明自己运行正常。在那种应用程序需要花很长时间处理个别键值对的场景中,这种机制是很关键的,因为框架可能会以为这个任务超时了,从而将它强行杀死。另一个避免这种情况发生的方式是,将配置参数mapred.task.timeout设置为一个足够高的值(或者干脆设置为零,则没有超时限制了)。
应用程序可以用Reporter来更新Counter(计数器)。
OutputCollector (outputcollector 使用旧API,需要区分新旧API)
OutputCollector是一个Map/Reduce框架提供的用于收集
Mapper或Reducer输出数据的通用机制
(包括中间输出结果和作业的输出结果)。
Hadoop
Map/Reduce框架附带了一个包含许多实用型的mapper、reducer和partitioner
的类库。
作业配置
JobConf代表一个Map/Reduce作业的配置。
JobConf是用户向Hadoop框架描述一个Map/Reduce作业如何执行的主要接口。框架会按照JobConf描述的信息忠实地去尝试完成这个作业,然而:
• 一些参数可能会被管理者标记为 final,这意味它们不能被更改。
• 一些作业的参数可以被直截了当地进行设置(例如:
setNumReduceTasks(int)),而另一些参数则与框架或者作业的其他参数之间微妙地相互影响,并且设置起来比较复杂(例如:
setNumMapTasks(int))。
通常,JobConf会指明Mapper、Combiner(如果有的话)、
Partitioner、Reducer、InputFormat和
OutputFormat的具体实现。JobConf还能指定一组输入文件
(setInputPaths(JobConf, Path…) /addInputPath(JobConf, Path))
和(setInputPaths(JobConf, String) /addInputPaths(JobConf, String))
以及输出文件应该写在哪儿 (setOutputPath(Path))。
JobConf可选择地对作业设置一些高级选项,例如:设置Comparator;
放到DistributedCache上的文件;中间结果或者作业输出结果是否需要压缩以及怎么压缩;
利用用户提供的脚本(setMapDebugScript(String)/setReduceDebugScript(String))
进行调试;作业是否允许预防性(speculative)任务的执行
(setMapSpeculativeExecution(boolean))/(setReduceSpeculativeExecution(boolean))
;每个任务最大的尝试次数
(setMaxMapAttempts(int)/setMaxReduceAttempts(int))
;一个作业能容忍的任务失败的百分比
(setMaxMapTaskFailuresPercent(int)/setMaxReduceTaskFailuresPercent(int))
;等等。
当然,用户能使用 set(String, String)/get(String, String)
来设置或者取得应用程序需要的任意参数。然而,DistributedCache的使用是面向大规模只读数据的。
任务的执行和环境
TaskTracker是在一个单独的jvm上以子进程的形式执行
Mapper/Reducer任务(Task)的。
子任务会继承父TaskTracker的环境。用户可以通过JobConf中的
mapred.child.java.opts配置参数来设定子jvm上的附加选项,例如:
通过-Djava.library.path=<>
将一个非标准路径设为运行时的链接用以搜索共享库,等等。如果mapred.child.java.opts包含一个符号@taskid@,
它会被替换成map/reduce的taskid的值。
下面是一个包含多个参数和替换的例子,其中包括:记录jvm GC日志; JVM
JMX代理程序以无密码的方式启动,这样它就能连接到jconsole上,从而可以查看子进程的内存和线程,得到线程的dump;还把子jvm的最大堆尺寸设置为512MB,
并为子jvm的java.library.path添加了一个附加路径。

3.在自己定义的mapper或reducer类中读取这些文件的内容

<property> 
  <name>mapred.child.java.opts</name> 
  <value> 
     -Xmx512M -Djava.library.path=/home/mycompany/lib -verbose:gc -Xloggc:/tmp/@taskid@.gc 
     -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false 
  </value> 
</property> 

下面以代码说明三个步骤:

用户或管理员也可以使用mapred.child.ulimit设定运行的子任务的最大虚拟内存。mapred.child.ulimit的值以(KB)为单位,并且必须大于或等于-Xmx参数传给JavaVM的值,否则VM会无法启动。
注意:mapred.child.java.opts只用于设置task
tracker启动的子任务。为守护进程设置内存选项请查看 cluster_setup.html
${mapred.local.dir}/taskTracker/是task tracker的本地目录,
用于创建本地缓存和job。它可以指定多个目录(跨越多个磁盘),文件会半随机的保存到本地路径下的某个目录。当job启动时,task
tracker根据配置文档创建本地job目录,目录结构如以下所示:
• ${mapred.local.dir}/taskTracker/archive/
:分布式缓存。这个目录保存本地的分布式缓存。因此本地分布式缓存是在所有task和job间共享的。
• ${mapred.local.dir}/taskTracker/jobcache/$jobid/ : 本地job目录。
o ${mapred.local.dir}/taskTracker/jobcache/$jobid/work/:
job指定的共享目录。各个任务可以使用这个空间做为暂存空间,用于它们之间共享文件。这个目录通过job.local.dir
参数暴露给用户。这个路径可以通过API
JobConf.getJobLocalDir()来访问。它也可以被做为系统属性获得。因此,用户(比如运行streaming)可以调用System.getProperty(“job.local.dir”)获得该目录。
o ${mapred.local.dir}/taskTracker/jobcache/$jobid/jars/:
存放jar包的路径,用于存放作业的jar文件和展开的jar。job.jar是应用程序的jar文件,它会被自动分发到各台机器,在task启动前会被自动展开。使用api
JobConf.getJar()
函数可以得到job.jar的位置。使用JobConf.getJar().getParent()可以访问存放展开的jar包的目录。
o ${mapred.local.dir}/taskTracker/jobcache/$jobid/job.xml:
一个job.xml文件,本地的通用的作业配置文件。
o ${mapred.local.dir}/taskTracker/jobcache/$jobid/$taskid:
每个任务有一个目录task-id,它里面有如下的目录结构:
 ${mapred.local.dir}/taskTracker/jobcache/$jobid/$taskid/job.xml:
一个job.xml文件,本地化的任务作业配置文件。任务本地化是指为该task设定特定的属性值。这些值会在下面具体说明。
 ${mapred.local.dir}/taskTracker/jobcache/$jobid/$taskid/output
一个存放中间过程的输出文件的目录。它保存了由framwork产生的临时map
reduce数据,比如map的输出文件等。
 ${mapred.local.dir}/taskTracker/jobcache/$jobid/$taskid/work:
task的当前工作目录。
 ${mapred.local.dir}/taskTracker/jobcache/$jobid/$taskid/work/tmp:
task的临时目录。(用户可以设定属性mapred.child.tmp 来为map和reduce
task设定临时目录。缺省值是./tmp。如果这个值不是绝对路径,
它会把task的工作路径加到该路径前面作为task的临时文件路径。如果这个值是绝对路径则直接使用这个值。
如果指定的目录不存在,会自动创建该目录。之后,按照选项
-Djava.io.tmpdir=’临时文件的绝对路径’执行java子任务。
pipes和streaming的临时文件路径是通过环境变量TMPDIR=’the absolute path of
the tmp dir’设定的)。
如果mapred.child.tmp有./tmp值,这个目录会被创建。
下面的属性是为每个task执行时使用的本地参数,它们保存在本地化的任务作业配置文件里:
• ${mapred.local.dir}/taskTracker/archive/
:分布式缓存。这个目录保存本地的分布式缓存。因此本地分布式缓存是在所有task和job间共享的。
• ${mapred.local.dir}/taskTracker/jobcache/$jobid/ : 本地job目录。
o ${mapred.local.dir}/taskTracker/jobcache/$jobid/work/:
job指定的共享目录。各个任务可以使用这个空间做为暂存空间,用于它们之间共享文件。这个目录通过job.local.dir
参数暴露给用户。这个路径可以通过API
JobConf.getJobLocalDir()来访问。它也可以被做为系统属性获得。因此,用户(比如运行streaming)可以调用System.getProperty(“job.local.dir”)获得该目录。
o ${mapred.local.dir}/taskTracker/jobcache/$jobid/jars/:
存放jar包的路径,用于存放作业的jar文件和展开的jar。job.jar是应用程序的jar文件,它会被自动分发到各台机器,在task启动前会被自动展开。使用api
JobConf.getJar()
函数可以得到job.jar的位置。使用JobConf.getJar().getParent()可以访问存放展开的jar包的目录。
o ${mapred.local.dir}/taskTracker/jobcache/$jobid/job.xml:
一个job.xml文件,本地的通用的作业配置文件。
o ${mapred.local.dir}/taskTracker/jobcache/$jobid/$taskid:
每个任务有一个目录task-id,它里面有如下的目录结构:
 ${mapred.local.dir}/taskTracker/jobcache/$jobid/$taskid/job.xml:
一个job.xml文件,本地化的任务作业配置文件。任务本地化是指为该task设定特定的属性值。这些值会在下面具体说明。
 ${mapred.local.dir}/taskTracker/jobcache/$jobid/$taskid/output
一个存放中间过程的输出文件的目录。它保存了由framwork产生的临时map
reduce数据,比如map的输出文件等。
 ${mapred.local.dir}/taskTracker/jobcache/$jobid/$taskid/work:
task的当前工作目录。
 ${mapred.local.dir}/taskTracker/jobcache/$jobid/$taskid/work/tmp:
task的临时目录。(用户可以设定属性mapred.child.tmp 来为map和reduce
task设定临时目录。缺省值是./tmp。如果这个值不是绝对路径,
它会把task的工作路径加到该路径前面作为task的临时文件路径。如果这个值是绝对路径则直接使用这个值。
如果指定的目录不存在,会自动创建该目录。之后,按照选项
-Djava.io.tmpdir=’临时文件的绝对路径’执行java子任务。
pipes和streaming的临时文件路径是通过环境变量TMPDIR=’the absolute path of
the tmp dir’设定的)。
如果mapred.child.tmp有./tmp值,这个目录会被创建。
下面的属性是为每个task执行时使用的本地参数,它们保存在本地化的任务作业配置文件里:
• ${mapred.local.dir}/taskTracker/archive/
:分布式缓存。这个目录保存本地的分布式缓存。因此本地分布式缓存是在所有task和job间共享的。
• ${mapred.local.dir}/taskTracker/jobcache/$jobid/ : 本地job目录。
o ${mapred.local.dir}/taskTracker/jobcache/$jobid/work/:
job指定的共享目录。各个任务可以使用这个空间做为暂存空间,用于它们之间共享文件。这个目录通过job.local.dir
参数暴露给用户。这个路径可以通过API
JobConf.getJobLocalDir()来访问。它也可以被做为系统属性获得。因此,用户(比如运行streaming)可以调用System.getProperty(“job.local.dir”)获得该目录。
o ${mapred.local.dir}/taskTracker/jobcache/$jobid/jars/:
存放jar包的路径,用于存放作业的jar文件和展开的jar。job.jar是应用程序的jar文件,它会被自动分发到各台机器,在task启动前会被自动展开。使用api
JobConf.getJar()
函数可以得到job.jar的位置。使用JobConf.getJar().getParent()可以访问存放展开的jar包的目录。
o ${mapred.local.dir}/taskTracker/jobcache/$jobid/job.xml:
一个job.xml文件,本地的通用的作业配置文件。
o ${mapred.local.dir}/taskTracker/jobcache/$jobid/$taskid:
每个任务有一个目录task-id,它里面有如下的目录结构:
 ${mapred.local.dir}/taskTracker/jobcache/$jobid/$taskid/job.xml:
一个job.xml文件,本地化的任务作业配置文件。任务本地化是指为该task设定特定的属性值。这些值会在下面具体说明。
 ${mapred.local.dir}/taskTracker/jobcache/$jobid/$taskid/output
一个存放中间过程的输出文件的目录。它保存了由framwork产生的临时map
reduce数据,比如map的输出文件等。
 ${mapred.local.dir}/taskTracker/jobcache/$jobid/$taskid/work:
task的当前工作目录。
 ${mapred.local.dir}/taskTracker/jobcache/$jobid/$taskid/work/tmp:
task的临时目录。(用户可以设定属性mapred.child.tmp 来为map和reduce
task设定临时目录。缺省值是./tmp。如果这个值不是绝对路径,
它会把task的工作路径加到该路径前面作为task的临时文件路径。如果这个值是绝对路径则直接使用这个值。
如果指定的目录不存在,会自动创建该目录。之后,按照选项
-Djava.io.tmpdir=’临时文件的绝对路径’执行java子任务。
pipes和streaming的临时文件路径是通过环境变量TMPDIR=’the absolute path of
the tmp dir’设定的)。
如果mapred.child.tmp有./tmp值,这个目录会被创建。
下面的属性是为每个task执行时使用的本地参数,它们保存在本地化的任务作业配置文件里:
名称 类型 描述
mapred.job.id String job id
mapred.jar String job目录下job.jar的位置
job.local.dir String job指定的共享存储空间
mapred.tip.id String task id
mapred.task.id String task尝试id
mapred.task.is.map boolean 是否是map task
mapred.task.partition int task在job中的id
map.input.file String map读取的文件名
map.input.start long map输入的数据块的起始位置偏移
map.input.length long map输入的数据块的字节数
mapred.work.output.dir String task临时输出目录
task的标准输出和错误输出流会被读到TaskTracker中,并且记录到
${HADOOP_LOG_DIR}/userlogs
DistributedCache 可用于map或reduce task中分发jar包和本地库。子jvm总是把
当前工作目录 加到 java.library.path 和 LD_LIBRARY_PATH。
因此,可以通过 System.loadLibrary或
System.load装载缓存的库。有关使用分布式缓存加载共享库的细节请参考
native_libraries.html
作业的提交与监控
JobClient是用户提交的作业与JobTracker交互的主要接口。
JobClient
提供提交作业,追踪进程,访问子任务的日志记录,获得Map/Reduce集群状态信息等功能。
作业提交过程包括:

1.Configuration conf = new
Configuration();

  1. 检查作业输入输出样式细节
  2. 为作业计算InputSplit值。
  3. 如果需要的话,为作业的DistributedCache建立必须的统计信息。
  4. 拷贝作业的jar包和配置文件到FileSystem上的Map/Reduce系统目录下。
  5. 提交作业到JobTracker并且监控它的状态。
    作业的历史文件记录到指定目录的”_logs/history/”子目录下。这个指定目录由hadoop.job.history.user.location设定,默认是作业输出的目录。因此默认情况下,文件会存放在mapred.output.dir/_logs/history目录下。用户可以设置hadoop.job.history.user.location为none来停止日志记录。
    用户使用下面的命令可以看到在指定目录下的历史日志记录的摘要。
    $ bin/hadoop job -history output-dir
    这个命令会打印出作业的细节,以及失败的和被杀死的任务细节。
    要查看有关作业的更多细节例如成功的任务、每个任务尝试的次数(task
    attempt)等,可以使用下面的命令
    $ bin/hadoop job -history all output-dir
    用户可以使用 OutputLogFilter 从输出目录列表中筛选日志文件。
    一般情况,用户利用JobConf创建应用程序并配置作业属性, 然后用
    JobClient 提交作业并监视它的进程。
    作业的控制
    有时候,用一个单独的Map/Reduce作业并不能完成一个复杂的任务,用户也许要链接多个Map/Reduce作业才行。这是容易实现的,因为作业通常输出到分布式文件系统上的,所以可以把这个作业的输出作为下一个作业的输入实现串联。
    然而,这也意味着,确保每一作业完成(成功或失败)的责任就直接落在了客户身上。在这种情况下,可以用的控制作业的选项有:
    • runJob(JobConf):提交作业,仅当作业完成时返回。
    • submitJob(JobConf):只提交作业,之后需要你轮询它返回的
    RunningJob句柄的状态,并根据情况调度。

    JobConf.setJobEndNotificationURI(String):设置一个作业完成通知,可避免轮询。
    作业的输入
    InputFormat 为Map/Reduce作业描述输入的细节规范。
    Map/Reduce框架根据作业的InputFormat来:
  6. 检查作业输入的有效性。
  7. 把输入文件切分成多个逻辑InputSplit实例, 并把每一实例分别分发给一个
    Mapper。
  8. 提供RecordReader的实现,这个RecordReader从逻辑InputSplit中获得输入记录,
    这些记录将由Mapper处理。
    基于文件的InputFormat实现(通常是 FileInputFormat的子类)
    默认行为是按照输入文件的字节大小,把输入数据切分成逻辑分块(logical
    InputSplit )。
    其中输入文件所在的FileSystem的数据块尺寸是分块大小的上限。下限可以设置mapred.min.split.size
    的值。
    考虑到边界情况,对于很多应用程序来说,很明显按照文件大小进行逻辑分割是不能满足需求的。
    在这种情况下,应用程序需要实现一个RecordReader来处理记录的边界并为每个任务提供一个逻辑分块的面向记录的视图。
    TextInputFormat 是默认的InputFormat。
    如果一个作业的Inputformat是TextInputFormat,
    并且框架检测到输入文件的后缀是.gz和.lzo,就会使用对应的CompressionCodec自动解压缩这些文件。
    但是需要注意,上述带后缀的压缩文件不会被切分,并且整个压缩文件会分给一个mapper来处理。
    InputSplit
    InputSplit 是一个单独的Mapper要处理的数据块。
    一般的InputSplit
    是字节样式输入,然后由RecordReader处理并转化成记录样式。
    FileSplit 是默认的InputSplit。 它把 map.input.file
    设定为输入文件的路径,输入文件是逻辑分块文件。
    RecordReader
    RecordReader 从InputSlit读入<key, value>对。
    一般的,RecordReader 把由InputSplit
    提供的字节样式的输入文件,转化成由Mapper处理的记录样式的文件。
    因此RecordReader负责处理记录的边界情况和把数据表示成keys/values对形式。
    作业的输出
    OutputFormat 描述Map/Reduce作业的输出样式。
    Map/Reduce框架根据作业的OutputFormat来:
  9. 检验作业的输出,例如检查输出路径是否已经存在。
  10. 提供一个RecordWriter的实现,用来输出作业结果。
    输出文件保存在FileSystem上。
    TextOutputFormat是默认的 OutputFormat。
    任务的Side-Effect File
    在一些应用程序中,子任务需要产生一些side-file,这些文件与作业实际输出结果的文件不同。
    在这种情况下,同一个Mapper或者Reducer的两个实例(比如预防性任务)同时打开或者写
    FileSystem上的同一文件就会产生冲突。因此应用程序在写文件的时候需要为每次任务尝试(不仅仅是每次任务,每个任务可以尝试执行很多次)选取一个独一无二的文件名(使用attemptid,例如task_200709221812_0001_m_000000_0)。
    为了避免冲突,Map/Reduce框架为每次尝试执行任务都建立和维护一个特殊的
    ${mapred.output.dir}/temporary/${taskid}子目录,这个目录位于本次尝试执行任务输出结果所在的FileSystem上,可以通过
    ${mapred.work.output.dir}来访问这个子目录。
    对于成功完成的任务尝试,只有${mapred.output.dir}/temporary/${taskid}下的文件会移动到${mapred.output.dir}。当然,框架会丢弃那些失败的任务尝试的子目录。这种处理过程对于应用程序来说是完全透明的。
    在任务执行期间,应用程序在写文件时可以利用这个特性,比如 通过
    FileOutputFormat.getWorkOutputPath()获得${mapred.work.output.dir}目录,
    并在其下创建任意任务执行时所需的side-file,框架在任务尝试成功时会马上移动这些文件,因此不需要在程序内为每次任务尝试选取一个独一无二的名字。
    注意:在每次任务尝试执行期间,${mapred.work.output.dir} 的值实际上是
    ${mapred.output.dir}/temporary/{$taskid},这个值是Map/Reduce框架创建的。
    所以使用这个特性的方法是,在 FileOutputFormat.getWorkOutputPath()
    路径下创建side-file即可。
    对于只使用map不使用reduce的作业,这个结论也成立。这种情况下,map的输出结果直接生成到HDFS上。
    RecordWriter
    RecordWriter 生成<key, value> 对到输出文件。
    RecordWriter的实现把作业的输出结果写到 FileSystem。
    其他有用的特性
    Counters
    Counters 是多个由Map/Reduce框架或者应用程序定义的全局计数器。
    每一个Counter可以是任何一种
    Enum类型。同一特定Enum类型的Counter可以汇集到一个组,其类型为Counters.Group。
    应用程序可以定义任意(Enum类型)的Counters并且可以通过 map 或者
    reduce方法中的 Reporter.incrCounter(Enum, long)或者
    Reporter.incrCounter(String, String, long)
    更新。之后框架会汇总这些全局counters。
    DistributedCache
    DistributedCache
    可将具体应用相关的、大尺寸的、只读的文件有效地分布放置。
    DistributedCache
    是Map/Reduce框架提供的功能,能够缓存应用程序所需的文件
    (包括文本,档案文件,jar文件等)。
    应用程序在JobConf中通过url(hdfs://)指定需要被缓存的文件。
    DistributedCache假定由hdfs://格式url指定的文件已经在
    FileSystem上了。
    Map-Redcue框架在作业所有任务执行之前会把必要的文件拷贝到slave节点上。
    它运行高效是因为每个作业的文件只拷贝一次并且为那些没有文档的slave节点缓存文档。
    DistributedCache 根据缓存文档修改的时间戳进行追踪。
    在作业执行期间,当前应用程序或者外部程序不能修改缓存文件。
    distributedCache可以分发简单的只读数据或文本文件,也可以分发复杂类型的文件例如归档文件和jar文件。归档文件(zip,tar,tgz和tar.gz文件)在slave节点上会被解档(un-archived)。
    这些文件可以设置执行权限。
    用户可以通过设置mapred.cache.{files|archives}来分发文件。
    如果要分发多个文件,可以使用逗号分隔文件所在路径。也可以利用API来设置该属性:
    DistributedCache.addCacheFile(URI,conf)/
    DistributedCache.addCacheArchive(URI,conf) and
    DistributedCache.setCacheFiles(URIs,conf)/
    DistributedCache.setCacheArchives(URIs,conf) 其中URI的形式是
    hdfs://host:port/absolute-path#link-name
    在Streaming程序中,可以通过命令行选项 -cacheFile/-cacheArchive
    分发文件。
    用户可以通过
    DistributedCache.createSymlink(Configuration)方法让DistributedCache
    在当前工作目录下创建到缓存文件的符号链接。
    或者通过设置配置文件属性mapred.create.symlink为yes。
    分布式缓存会截取URI的片段作为链接的名字。 例如,URI是
    hdfs://namenode:port/lib.so.1#lib.so,
    则在task当前工作目录会有名为lib.so的链接,
    它会链接分布式缓存中的lib.so.1。
    DistributedCache可在map/reduce任务中作为
    一种基础软件分发机制使用。它可以被用于分发jar包和本地库(native
    libraries)。 DistributedCache.addArchiveToClassPath(Path,
    Configuration)和 DistributedCache.addFileToClassPath(Path,
    Configuration) API能够被用于
    缓存文件和jar包,并把它们加入子jvm的classpath。也可以通过设置配置文档里的属性
    mapred.job.classpath.{files|archives}达到相同的效果。缓存文件可用于分发和装载本地库。
    Tool
    Tool 接口支持处理常用的Hadoop命令行选项。
    Tool 是Map/Reduce工具或应用的标准。应用程序应只处理其定制参数,
    要把标准命令行选项通过 ToolRunner.run(Tool, String[]) 委托给
    GenericOptionsParser处理。
    Hadoop命令行的常用选项有:
    -conf <configuration file>
    -D <property=value>
    -fs <local|namenode:port>
    -jt <local|jobtracker:port>
    IsolationRunner
    IsolationRunner 是帮助调试Map/Reduce程序的工具。
    使用IsolationRunner的方法是,首先设置
    keep.failed.tasks.files属性为true
    (同时参考keep.tasks.files.pattern)。
    然后,登录到任务运行失败的节点上,进入 TaskTracker的本地路径运行
    IsolationRunner:
    $ cd <local path>/taskTracker/${taskid}/work
    $ bin/hadoop org.apache.hadoop.mapred.IsolationRunner ../job.xml
    IsolationRunner会把失败的任务放在单独的一个能够调试的jvm上运行,并且采用和之前完全一样的输入数据。
    Profiling
    Profiling是一个工具,它使用内置的java
    profiler工具进行分析获得(2-3个)map或reduce样例运行分析报告。
    用户可以通过设置属性mapred.task.profile指定系统是否采集profiler信息。
    利用api
    JobConf.setProfileEnabled(boolean)可以修改属性值。如果设为true,
    则开启profiling功能。profiler信息保存在用户日志目录下。缺省情况,profiling功能是关闭的。
    如果用户设定使用profiling功能,可以使用配置文档里的属性
    mapred.task.profile.{maps|reduces} 设置要profile map/reduce
    task的范围。设置该属性值的api是
    JobConf.setProfileTaskRange(boolean,String)。 范围的缺省值是0-2。
    用户可以通过设定配置文档里的属性mapred.task.profile.params
    来指定profiler配置参数。修改属性要使用api
    JobConf.setProfileParams(String)。当运行task时,如果字符串包含%s。
    它会被替换成profileing的输出文件名。这些参数会在命令行里传递到子JVM中。缺省的profiling
    参数是
    -agentlib:hprof=cpu=samples,heap=sites,force=n,thread=y,verbose=n,file=%s。
    调试
    Map/Reduce框架能够运行用户提供的用于调试的脚本程序。
    当map/reduce任务失败时,用户可以通过运行脚本在任务日志(例如任务的标准输出、标准错误、系统日志以及作业配置文件)上做后续处理工作。用户提供的调试脚本程序的标准输出和标准错误会输出为诊断文件。如果需要的话这些输出结果也可以打印在用户界面上。
    在接下来的章节,我们讨论如何与作业一起提交调试脚本。为了提交调试脚本,
    首先要把这个脚本分发出去,而且还要在配置文件里设置。
    如何分发脚本文件:
    用户要用 DistributedCache 机制来分发和链接脚本文件
    如何提交脚本:
    一个快速提交调试脚本的方法是分别为需要调试的map任务和reduce任务设置
    “mapred.map.task.debug.script” 和 “mapred.reduce.task.debug.script”
    属性的值。这些属性也可以通过 JobConf.setMapDebugScript(String) 和
    JobConf.setReduceDebugScript(String) API来设置。对于streaming,
    可以分别为需要调试的map任务和reduce任务使用命令行选项-mapdebug 和
    -reducedegug来提交调试脚本。
    脚本的参数是任务的标准输出、标准错误、系统日志以及作业配置文件。在运行map/reduce失败的节点上运行调试命令是:
    $script $stdout $stderr $syslog $jobconf
    Pipes 程序根据第五个参数获得c++程序名。 因此调试pipes程序的命令是
    $script $stdout $stderr $syslog $jobconf $program
    默认行为
    对于pipes,默认的脚本会用gdb处理core dump, 打印 stack
    trace并且给出正在运行线程的信息。
    JobControl
    JobControl是一个工具,它封装了一组Map/Reduce作业以及他们之间的依赖关系。
    数据压缩
    Hadoop
    Map/Reduce框架为应用程序的写入文件操作提供压缩工具,这些工具可以为map输出的中间数据和作业最终输出数据(例如reduce的输出)提供支持。它还附带了一些
    CompressionCodec的实现,比如实现了 zlib和lzo压缩算法。
    Hadoop同样支持gzip文件格式。
    考虑到性能问题(zlib)以及Java类库的缺失(lzo)等因素,Hadoop也为上述压缩解压算法提供本地库的实现。更多的细节请参考
    这里。
    中间输出
    应用程序可以通过
    JobConf.setCompressMapOutput(boolean)api控制map输出的中间结果,并且可以通过
    JobConf.setMapOutputCompressorClass(Class)api指定
    CompressionCodec。
    作业输出
    应用程序可以通过 FileOutputFormat.setCompressOutput(JobConf,
    boolean) api控制输出是否需要压缩并且可以使用
    FileOutputFormat.setOutputCompressorClass(JobConf,
    Class)api指定CompressionCodec。
    如果作业输出要保存成 SequenceFileOutputFormat格式,需要使用
    SequenceFileOutputFormat.setOutputCompressionType(JobConf,
    SequenceFile.CompressionType)api,来设定
    SequenceFile.CompressionType (i.e. RECORD / BLOCK –
    默认是RECORD)。
    例子:WordCount v2.0
    这里是一个更全面的WordCount例子,它使用了我们已经讨论过的很多Map/Reduce框架提供的功能。
    运行这个例子需要HDFS的某些功能,特别是
    DistributedCache相关功能。因此这个例子只能运行在 伪分布式 或者
    完全分布式模式的 Hadoop上。

 
DistributedCache.addCacheFile(new
URI(“/user/tinfo/zhangguochen/libJMeshCalc.so”), conf);

  DistributedCache.addCacheArchive(new
URI(“/user/tinfo/zhangguochen/libJMeshCalc.zip”),conf);
  DistributedCache.addFileToClassPath(new
URI(“/user/tinfo/zhangguochen/libMeshCal.jar”), conf);

package org.myorg; 

import java.io.*; 
import java.util.*; 

import org.apache.hadoop.fs.Path; 
import org.apache.hadoop.filecache.DistributedCache; 
import org.apache.hadoop.conf.*; 
import org.apache.hadoop.io.*; 
import org.apache.hadoop.mapred.*; 
import org.apache.hadoop.util.*; 

public class WordCount extends Configured implements Tool { 

   public static class Map extends MapReduceBase implements Mapper<LongWritable, Text, Text, IntWritable> { 

     static enum Counters { INPUT_WORDS } 

     private final static IntWritable one = new IntWritable(1); 
     private Text word = new Text(); 

     private boolean caseSensitive = true; 
     private Set<String> patternsToSkip = new HashSet<String>(); 

     private long numRecords = 0; 
     private String inputFile; 

     public void configure(JobConf job) { 
       caseSensitive = job.getBoolean("wordcount.case.sensitive", true); 
       inputFile = job.get("map.input.file"); 

       if (job.getBoolean("wordcount.skip.patterns", false)) { 
         Path[] patternsFiles = new Path[0]; 
         try { 
           patternsFiles = DistributedCache.getLocalCacheFiles(job); 
         } catch (IOException ioe) { 
           System.err.println("Caught exception while getting cached files: " + StringUtils.stringifyException(ioe)); 
         } 
         for (Path patternsFile : patternsFiles) { 
           parseSkipFile(patternsFile); 
         } 
       } 
     } 

     private void parseSkipFile(Path patternsFile) { 
       try { 
         BufferedReader fis = new BufferedReader(new FileReader(patternsFile.toString())); 
         String pattern = null; 
         while ((pattern = fis.readLine()) != null) { 
           patternsToSkip.add(pattern); 
         } 
       } catch (IOException ioe) { 
         System.err.println("Caught exception while parsing the cached file '" + patternsFile + "' : " + StringUtils.stringifyException(ioe)); 
       } 
     } 

     public void map(LongWritable key, Text value, OutputCollector<Text, IntWritable> output, Reporter reporter) throws IOException { 
       String line = (caseSensitive) ? value.toString() : value.toString().toLowerCase(); 

       for (String pattern : patternsToSkip) { 
         line = line.replaceAll(pattern, ""); 
       } 

       StringTokenizer tokenizer = new StringTokenizer(line); 
       while (tokenizer.hasMoreTokens()) { 
         word.set(tokenizer.nextToken()); 
         output.collect(word, one); 
         reporter.incrCounter(Counters.INPUT_WORDS, 1); 
       } 

       if ((++numRecords % 100) == 0) { 
         reporter.setStatus("Finished processing " + numRecords + " records " + "from the input file: " + inputFile); 
       } 
     } 
   } 

   public static class Reduce extends MapReduceBase implements Reducer<Text, IntWritable, Text, IntWritable> { 
     public void reduce(Text key, Iterator<IntWritable> values, OutputCollector<Text, IntWritable> output, Reporter reporter) throws IOException { 
       int sum = 0; 
       while (values.hasNext()) { 
         sum += values.next().get(); 
       } 
       output.collect(key, new IntWritable(sum)); 
     } 
   } 

   public int run(String[] args) throws Exception { 
     JobConf conf = new JobConf(getConf(), WordCount.class); 
     conf.setJobName("wordcount"); 

     conf.setOutputKeyClass(Text.class); 
     conf.setOutputValueClass(IntWritable.class); 

     conf.setMapperClass(Map.class); 
     conf.setCombinerClass(Reduce.class); 
     conf.setReducerClass(Reduce.class); 

     conf.setInputFormat(TextInputFormat.class); 
     conf.setOutputFormat(TextOutputFormat.class); 

     List<String> other_args = new ArrayList<String>(); 
     for (int i=0; i < args.length; ++i) { 
       if ("-skip".equals(args[i])) { 
         DistributedCache.addCacheFile(new Path(args[++i]).toUri(), conf); 
         conf.setBoolean("wordcount.skip.patterns", true); 
       } else { 
         other_args.add(args[i]); 
       } 
     } 

     FileInputFormat.setInputPaths(conf, new Path(other_args.get(0))); 
     FileOutputFormat.setOutputPath(conf, new Path(other_args.get(1))); 

     JobClient.runJob(conf); 
     return 0; 
   } 

   public static void main(String[] args) throws Exception { 
     int res = ToolRunner.run(new Configuration(), new WordCount(), args); 
     System.exit(res); 
   } 
} 

    或者

运行样例
输入样例:
$ bin/hadoop dfs -ls /usr/joe/wordcount/input/
/usr/joe/wordcount/input/file01
/usr/joe/wordcount/input/file02

    conf.set(“mapred.cache.files”,
“/myapp/file”);

$ bin/hadoop dfs -cat /usr/joe/wordcount/input/file01
Hello World, Bye World!

 
 conf.set(“mapred.cache.
archives”, “/mayapp/file.zip”);

$ bin/hadoop dfs -cat /usr/joe/wordcount/input/file02
Hello Hadoop, Goodbye to hadoop.
运行程序:
$ bin/hadoop jar /usr/joe/wordcount.jar org.myorg.WordCount
/usr/joe/wordcount/input /usr/joe/wordcount/output
输出:
$ bin/hadoop dfs -cat /usr/joe/wordcount/output/part-00000
Bye 1
Goodbye 1
Hadoop, 1
Hello 2
World! 1
World, 1
hadoop. 1
to 1
注意此时的输入与第一个版本的不同,输出的结果也有不同。
现在通过DistributedCache插入一个模式文件,文件中保存了要被忽略的单词模式。
$ hadoop dfs -cat /user/joe/wordcount/patterns.txt
.
,
!
to
再运行一次,这次使用更多的选项:
$ bin/hadoop jar /usr/joe/wordcount.jar org.myorg.WordCount
-Dwordcount.case.sensitive=true /usr/joe/wordcount/input
/usr/joe/wordcount/output -skip /user/joe/wordcount/patterns.txt
应该得到这样的输出:
$ bin/hadoop dfs -cat /usr/joe/wordcount/output/part-00000
Bye 1
Goodbye 1
Hadoop 1
Hello 2
World 2
hadoop 1
再运行一次,这一次关闭大小写敏感性(case-sensitivity):
$ bin/hadoop jar /usr/joe/wordcount.jar org.myorg.WordCount
-Dwordcount.case.sensitive=false /usr/joe/wordcount/input
/usr/joe/wordcount/output -skip /user/joe/wordcount/patterns.txt
输出:
$ bin/hadoop dfs -cat /usr/joe/wordcount/output/part-00000
bye 1
goodbye 1
hadoop 2
hello 2
world 2
程序要点
通过使用一些Map/Reduce框架提供的功能,WordCount的第二个版本在原始版本基础上有了如下的改进:
• 展示了应用程序如何在Mapper (和Reducer)中通过configure方法
修改配置参数(28-43行)。
• 展示了作业如何使用DistributedCache 来分发只读数据。
这里允许用户指定单词的模式,在计数时忽略那些符合模式的单词(104行)。
• 展示Tool接口和GenericOptionsParser处理Hadoop命令行选项的功能 (87-116,
119行)。
• 展示了应用程序如何使用Counters(68行),如何通过传递给map(和reduce)
方法的Reporter实例来设置应用程序的状态信息(72行)。
Java和JNI是Sun Microsystems, Inc.在美国和其它国家的注册商标。

 
 以上是配置须要分发的hdfs上的文件,可是前提是这些文件必须在hdfs上存在,看源代码可知道DistributedCache的静态方法事实上就是封装了conf.set的动作。

2.在自己的mapper类中,使用DistributedCache获取下载到本地的文件,大部分情况下这些操作都是重写configure接口,然后把本地文件路径保存在mapper类的成员变量中,供map方法使用。代码例如以下:

 
 private Path[] localFiles;

 
 public void setup(Context context) {

   
   localFiles =
DistributeCache.getLocalCacheFiles(context.getConfiguration;

   
   for(Path temp:localFiles) {

   
        String path =
temp.toString();//path就是此文件在本地的路径

   
        if(path.contains(“myfileName”))
{//获取到自己须要的文件

   
        }

   
   }

   
}

getLocalCacheFiles返回的是数组(元素类型是Path),数组内容是这个task(map或reduce)所属的job设定的全部须要被分发的文件,假设设置了
   
多个文件,能够遍历Path数组,用String.contains(“KeyWord”)来推断是否是你所须要的文件。

 
 获取压缩包的路径

 
 private  File[] inputFiles;

 
 private Path[] localArchives;

 
 public void setup(Context context) {

   
   localArchives = DistributeCache.getLocalCacheArvhives();

   
   for(Path archive : localArchives) {