Pydoop Script is the easiest way to write simple MapReduce programs for Hadoop. With Pydoop Script, you only need to write a map and/or a reduce functions and the system will take care of the rest.
For a full explanation please see the tutorial.
In the simplest case, Pydoop Script is invoked as:
pydoop script MODULE INPUT OUTPUT
where MODULE is the file (on your local file system) containing your map and reduce functions, in Python, while INPUT and OUTPUT are, respectively, the HDFS paths of your input data and your job’s output directory.
Options are shown in the following table.
|-m||--map-fn||Name of map function within module (default: mapper)|
|-r||--reduce-fn||Name of reduce function within module (default: reducer)|
|-c||--combine-fn||Name of combine function within module (default: None)|
|-t||--kv-separator||Key-value separator string in final output (default: <tab> character)|
|--num-reducers||Number of reduce tasks. Specify 0 to only perform map phase (default: 3 * num task trackers)|
|-D||Set a property value, such as -D mapred.compress.map.output=true|
In addition to the options listed above, you can pass any of the options used by Hadoop tools, but you must pass them after the pydoop script options listed above:
|-conf <configuration file>||specify an application configuration file|
|-fs <local|namenode:port>||specify a namenode|
|-jt <local|jobtracker:port>||specify a job tracker|
|-files <list of files>||comma-separated files to be copied to the map reduce cluster|
|-libjars <list of jars>||comma-separated jar files to include in the classpath|
|-archives <list of archives>||comma-separated archives to be unarchived on the compute machines|
Here is the word count example modified to ignore stop words from a file that is distributed to all the nodes using the -files option:
with open('stop_words.txt') as f: STOP_WORDS = frozenset(l.strip() for l in f if not l.isspace()) def mapper(_, v, writer): for word in v.split(): if word in STOP_WORDS: writer.count("STOP_WORDS", 1) else: writer.emit(word, 1) def reducer(word, icounts, writer): writer.emit(word, sum(map(int, icounts)))
pydoop script word_count.py hdfs_input hdfs_output -files stop_words.txt
While this script works, it has the obvious weakness of loading the stop words list even when executing the reducer (since it’s loaded as soon as we import the module). If this inconvenience is a concern, we could solve the issue by triggering the loading from the mapper function, or by writing a full Pydoop application which would give us all the control we need to only load the list when required.
In this section we assume you’ll be using the default TextInputFormat and TextOutputFormat record reader/writer. You may select a different input or output format by configuring the appropriate Hadoop properties (see the custom input format example <input_format_example>.
The mapper function in your module will be called for each record in your input data. It receives 3 parameters:
The combiner function will be called for each unique key-value pair produced by your map function. It also receives 3 parameters:
The key-value pair emitted by your combiner will be piped to the reducer.
The reducer function will be called for each unique key-value pair produced by your map function. It also receives 3 parameters:
The key-value pair emitted by your reducer will be joined by the key-value separator specified with the --kv-separator option.
The writer object given as the third parameter to both the mapper and reducer functions has the following methods:
The latter two methods are useful for keeping your task alive in cases where the amount of computation to be done for a single record might exceed Hadoop’s timeout interval: Hadoop kills a task after a number of milliseconds set through the mapred.task.timeout property – which defaults to 600000, i.e., 10 minutes – if it neither reads an input, writes an output, nor updates its status string.
Pydoop Script lets you access the values of your job configuration properties through a dict-like object, which gets passed as the fourth (optional) parameter to your functions. To see the methods available check out the api.
If you’d like to give your map and reduce functions names different from mapper and reducer, you may do so, but you must tell the script tool. Use the --map-fn and --reduce-fn command line arguments to select your customized names. Combiner functions can only be assigned by explicitly setting the --combine-fn flag.
You may have a program that doesn’t use a reduce function. Specify --num-reducers 0 on the command line and your map output will be written directly to file. In this case, you map output will go directly to the output formatter and be written to your final output, separated by the key-value separator.