Exemplos de pipeline - MaxCompute: Central de Documentação do Alibaba Cloud

Este exemplo demonstra como contar a frequência de palavras com um job de Pipeline MapReduce do MaxCompute. O pipeline encadeia um mapper (TokenizerMapper) e dois reducers (SumReducer e IdentityReducer), ilustrando como a API de Pipeline conecta vários estágios de processamento em um único job.

Pré-requisitos

Antes de começar, verifique se você:

Concluiu a configuração do ambiente descrita em Primeiros passos

Configure os recursos de teste

1. Prepare o pacote JAR

Coloque o arquivo mapreduce-examples.jar no diretório bin\data\resources da instalação do cliente MaxCompute.

2. Crie as tabelas

Execute as seguintes instruções SQL no cliente MaxCompute:

CREATE TABLE wc_in (key STRING, value STRING);
CREATE TABLE wc_out(key STRING, cnt BIGINT);

3. Adicione o pacote JAR como recurso

add jar data\resources\mapreduce-examples.jar -f;

A flag -f substitui um recurso existente com o mesmo nome. Omita-a ao adicionar o pacote JAR pela primeira vez.

4. Importe os dados de teste

Use um comando do Tunnel para enviar o arquivo data.txt do diretório bin do cliente MaxCompute para a tabela wc_in:

tunnel upload data.txt wc_in;

O arquivo data.txt contém a seguinte linha:

hello,odps

Execute o pipeline

Execute o seguinte comando no cliente MaxCompute:

jar -resources mapreduce-examples.jar -classpath data\resources\mapreduce-examples.jar
com.aliyun.odps.mapred.open.example.WordCountPipeline wc_in wc_out;

Verifique o resultado

Após a conclusão do job, consulte a tabela wc_out para confirmar a saída:

SELECT * FROM wc_out;

A saída esperada é:

+------------+------------+
| key        | cnt        |
+------------+------------+
| hello      | 1          |
| odps       | 1          |
+------------+------------+

Código de exemplo

Para configurar dependências do Project Object Model (POM), consulte Precauções.

Funcionamento do pipeline

O pipeline encadeia três estágios. Cada estágio transforma os dados da seguinte forma:

wc_in (key STRING, value STRING) → TokenizerMapper → (word STRING, count BIGINT) → SumReducer → (word STRING, count BIGINT) → IdentityReducer → wc_out (key STRING, cnt BIGINT)

Classe	Função
`TokenizerMapper`	Divide cada registro em tokens e emite `(word, 1)` para cada token
`SumReducer`	Agrega as contagens para cada chave de palavra
`IdentityReducer`	Grava os pares finais `(word, count)` na tabela de saída

O design com dois reducers separa a agregação da formatação de saída. O SumReducer acumula totais de todas as saídas dos mappers. Em seguida, o IdentityReducer mapeia o esquema intermediário para o esquema da tabela wc_out. Isso mantém as duas responsabilidades independentes, facilitando o teste e a substituição de cada reducer.

Se você omitir OutputKeySortColumns , PartitionColumns e OutputGroupingColumns para um mapper durante a construção do pipeline, o framework usa a OutputKey do mapper como valor padrão para todos os três parâmetros.

Código Java

package com.aliyun.odps.mapred.open.example;
import java.io.IOException;
import java.util.Iterator;
import com.aliyun.odps.Column;
import com.aliyun.odps.OdpsException;
import com.aliyun.odps.OdpsType;
import com.aliyun.odps.data.Record;
import com.aliyun.odps.data.TableInfo;
import com.aliyun.odps.mapred.Job;
import com.aliyun.odps.mapred.MapperBase;
import com.aliyun.odps.mapred.ReducerBase;
import com.aliyun.odps.pipeline.Pipeline;
public class WordCountPipelineTest {
    public static class TokenizerMapper extends MapperBase {
        Record word;
        Record one;
        @Override
            public void setup(TaskContext context) throws IOException {
            word = context.createMapOutputKeyRecord();
            one = context.createMapOutputValueRecord();
            one.setBigint(0, 1L);
        }
        @Override
            public void map(long recordNum, Record record, TaskContext context)
            throws IOException {
            for (int i = 0; i < record.getColumnCount(); i++) {
                String[] words = record.get(i).toString().split("\\s+");
                for (String w : words) {
                    word.setString(0, w);
                    context.write(word, one);
                }
            }
        }
    }
    public static class SumReducer extends ReducerBase {
        private Record value;
        @Override
            public void setup(TaskContext context) throws IOException {
            value = context.createOutputValueRecord();
        }
        @Override
            public void reduce(Record key, Iterator<Record> values, TaskContext context)
            throws IOException {
            long count = 0;
            while (values.hasNext()) {
                Record val = values.next();
                count += (Long) val.get(0);
            }
            value.set(0, count);
            context.write(key, value);
        }
    }
    public static class IdentityReducer extends ReducerBase {
        private Record result;
        @Override
            public void setup(TaskContext context) throws IOException {
            result = context.createOutputRecord();
        }
        @Override
            public void reduce(Record key, Iterator<Record> values, TaskContext context)
            throws IOException {
            while (values.hasNext()) {
                result.set(0, key.get(0));
                result.set(1, values.next().get(0));
                context.write(result);
            }
        }
    }
    public static void main(String[] args) throws OdpsException {
        if (args.length != 2) {
            System.err.println("Usage: WordCountPipeline <in_table> <out_table>");
            System.exit(2);
        }
        Job job = new Job();
        /** During pipeline construction, if you do not specify OutputKeySortColumns, PartitionColumns, and OutputGroupingColumns for a mapper, the framework uses OutputKey of the mapper as the default values of these parameters.
         */
        Pipeline pipeline = Pipeline.builder()
            .addMapper(TokenizerMapper.class)
            .setOutputKeySchema(
            new Column[] { new Column("word", OdpsType.STRING) })
            .setOutputValueSchema(
            new Column[] { new Column("count", OdpsType.BIGINT) })
            .setOutputKeySortColumns(new String[] { "word" })
            .setPartitionColumns(new String[] { "word" })
            .setOutputGroupingColumns(new String[] { "word" })
            .addReducer(SumReducer.class)
            .setOutputKeySchema(
            new Column[] { new Column("word", OdpsType.STRING) })
            .setOutputValueSchema(
            new Column[] { new Column("count", OdpsType.BIGINT)})
            .addReducer(IdentityReducer.class).createPipeline();
        /** Add the pipeline to jobconf. If you want to configure a combiner, use jobconf. */
        job.setPipeline(pipeline);
        /** Configure the input and output tables. */
        job.addInput(TableInfo.builder().tableName(args[0]).build());
        job.addOutput(TableInfo.builder().tableName(args[1]).build());
        /** Submit the job and wait for it to complete. */
        job.submit();
        job.waitForCompletion();
        System.exit(job.isSuccessful() == true ? 0 : 1);
    }
}

Detalhamento do fluxo de dados

Com a entrada hello,odps, o comando Tunnel carrega os dados como um único registro na tabela wc_in. Ele armazena hello na coluna key e odps na coluna value.

O TokenizerMapper itera sobre todas as colunas de cada registro usando record.getColumnCount(). Para cada valor de coluna, ele chama split("\\s+") e emite um par (word, 1) por token. Como hello e odps não contêm espaços em branco, cada um é tratado como um único token. O mapper emite:

(hello, 1)
(odps, 1)

O SumReducer recebe todos os valores para cada chave de palavra e acumula a contagem. Como cada palavra aparece apenas uma vez, ele emite:

(hello, 1)
(odps, 1)

O IdentityReducer lê os pares (word, count) provenientes do SumReducer e os grava na tabela de saída wc_out. Ele mapeia as posições das colunas para corresponder ao esquema (key STRING, cnt BIGINT).

Saída final em wc_out:

| hello      | 1          |
| odps       | 1          |