概述

这篇文章是但不仅仅是官方文档的中文翻译，还有里面每一个方法对应的Transformation和运行时对Task的影响。

Prerequisites

• 关于算子想说的有很多，都在上一篇文章里，在这篇文章中，把算子理解为包含了一个函数（Flink实现的或自己实现的，比如MapFunction，FilterFunction）的持续获得输入并且将结果输出出去的任务就好。
• 图中的Task表示一个节点，或者说是一个TaskManager中一个Slot执行的任务
• 流程图中红色代表这个方法在生成Transformation和实际运行时对Task产生的影响

DataStream

• Map

  • 消费一个元素并产出一个元素
  • 参数 MapFunction
  • 返回DataStream
  • 例子：

  DataStream<Integer> dataStream = //...
  dataStream.map(new MapFunction<Integer, Integer>() {
      @Override
      public Integer map(Integer value) throws Exception {
          return 2 * value;
      }
  });
  

  • Transformation: 生成一个OneInputTransformation并包含StreamMap算子

    
    StreamMapTransformation

  • Runtime:

    
    StreamMapTask

• FlatMap

  • 消费一个元素并产生零到多个元素
  • 参数 FlatMapFunction
  • 返回 DataStream
  • 例子：

  dataStream.flatMap(new FlatMapFunction<String, String>() {
      @Override
      public void flatMap(String value, Collector<String> out)
          throws Exception {
          for(String word: value.split(" ")){
              out.collect(word);
          }
      }
  });
  

  • Transformation: 生成一个OneInputTransformation并包含StreamFlatMap算子

    
    StreamFlatMapTransformation

  • Runtime：

    
    StreamFlatMapTask

• Filter

  • 根据FliterFunction返回的布尔值来判断是否保留元素，true为保留，false则丢弃
  • 参数 FilterFunction
  • 返回DataStream
  • 例子：

  dataStream.filter(new FilterFunction<Integer>() {
      @Override
      public boolean filter(Integer value) throws Exception {
          return value != 0;
      }
  });
  

  • Transformation：生成一个OneInputTransformation并包含StreamFilter算子

    
    StreamFilterTransformation

  • Runtime：

    
    StreamFilterTask

• KeyBy

  • 根据指定的Key将元素发送到不同的分区，相同的Key会被分到一个分区（这里分区指的就是下游算子多个并行的节点的其中一个）。keyBy()是通过哈希来分区的。
  • 只能使用KeyedState（Flink做备份和容错的状态）
  • 参数 String，tuple的索引，覆盖了hashCode方法的POJO，不能使数组
  • 返回KeyedStream
  • 例子：

  dataStream.keyBy("someKey") // Key by field "someKey"
  dataStream.keyBy(0) // Key by the first element of a Tuple
  

  • Transformation: KeyBy会产生一个PartitionTransformation，并且通过KeySelector创建一个KeyGroupStreamPartitioner，目的是将输出的数据分区。此外还会把KeySelector保存到KeyedStream的属性中，在下一个Transformation创建时时将KeySelector注入进去。

    
    KeyByTransformation

  • Runtime: 生成StreamGraph时会将PartitionTransformation中的Partitioner 注入到StreamEdge当中，此外还会在下一个StreamNode创建过程中注入KeySelector用于提取元素的Key。之后将Partitioner注入StreamRecordWriter中用于将上一个Task的输出元素指定到某一个ResultSubParition中，此外KeySelector也被注入到下一个Task的算子当中。

    
    KeyBy Runtime

• WindowAll

  • 将元素按照某种特性聚集在一起（如时间：滑动窗口，翻转窗口，会话窗口，又如出现次数：计数窗口）
  • 参数 WindowAssigner
  • 返回 AllWindowedStream
  • 例子：

  dataStream.windowAll(TumblingEventTimeWindows.of(Time.seconds(5))); // Last 5 seconds of data
  

  • Transformation：返回AllWindowedStream，不产生Transformation，详情见AllWindowedStream
  • Runtime：详情见AllWindowedStream

• Union

  • 将两个或多个datastream合并，创造一个新的流包含这些datastream的所有元素
  • 参数DataStream（一个或多个）
  • 返回UnionStream
  • 例子：

  dataStream.union(otherStream1, otherStream2, ...);
  

  • Transformation: 从所有相关的stream中获取Transformation并注入到UnionTransformation的inputs中

    
    UnionTransformation
  • Runtime：这些Inputs会在下一个Transformation创建时被作为Input来穿件StreamEdge，如果上下游并行度一致则会生成ForwardPartitioner，不一致则是RebalancePartitioner。由于Partitioner是在处理下游Transformation生成的，所以这里没有图。

• Join

  • 将两个DataStream按照key和window join在一起
  • 参数：1. KeySelector1 2. KeySelector2 3. DataStream 4. WindowAssigner 5. JoinFunction/FlatJoinFunction
  • 返回DataStream
  • 例子：

  dataStream.join(otherStream)
      .where(<key selector>).equalTo(<key selector>)
      .window(TumblingEventTimeWindows.of(Time.seconds(3)))
      .apply (new JoinFunction () {...});
  

  • Transformation：1. 调用join方法后生成JoinedStream，JoinedStream保存了两个input 2. 调用where方法生成一个内部类Where对象，注入KeySelector1 3. 调用equalTo生成内部类EqualTo对象，注入KeySelector2 4. 调用window升成内部静态类WithWindow，并且注入WindowAssigner（在该对象中还可以注入Trigger和Evictor 5. 最后调用apply方法将（Flat)JoinFunction注入并且用一个(Flat)JoinCoGroupFunction封装起来，而在这一步会将所有注入的对象用在coGroup上。详情见下一个Window CoGroup的解析。
  • Runtime： 与Window CoGroup相同，详情见下一个WIndow CoGroup解析

• Window CoGroup

  • 根据Key和window将两个DataStream的元素聚集在两个集合中，根据CoGroupFunction来处理这两个集合，并产出结果
  • 参数 1. DataStream 2. KeySelector1 3. KeySelector2 4. WindowAssigner 5. CoGroupFunction
  • 返回DataStream
  • 例子：

  dataStream.coGroup(otherStream)
      .where(0).equalTo(1)
      .window(TumblingEventTimeWindows.of(Time.seconds(3)))
      .apply (new CoGroupFunction () {...});
  

  • Transformation：生成一个TaggedUnion类型和unionKeySelector，里面分别包含了两个流的元素类型和两个流的KeySelector。将两个流通过map分别输出为类型是TaggedUnion的两个流（map详情见StreamMap），再Union在一起（详情见Union），再使用合并过后的流和unionKeySelector生成一个KeyedStream（详情见KeyBy），最后使用KeyedStream的window方法并传入WindowAssigner生成WindowedStream，并apply CoGroupFunction来处理（详情见WindowedStream Apply方法）。总体来说，Flink对这个方法做了很多内部的转换，最后生成了两个StreamMapTransformation，一个PartitionTransformation和一个包含了WindowOperator的OneInputTransformation。

    
    CoGroupTransformation

  • Runtime：参考每个Transformation对应的Runtime情况

• Connect

  • 将两个DataStream连接在一起，使得他们之间可以共享状态
  • 参数 DataStream
  • 返回ConnectedStreams
  • 例子：

  DataStream<Integer> someStream = //...
  DataStream<String> otherStream = //...
  
  ConnectedStreams<Integer, String> connectedStreams = someStream.connect(otherStream);
  

  • Transformation：在这一步会生成一个包含了两个DataStream的ConnectedStreams对象，不会有Transformation产生。详情见后续ConnectedStreams的API详解。

• Split

  • 按照一个规则将一个流的元素产出到两个或多个支流（每个元素可以发送到不止一个支流）
  • 参数 OutputSelector
  • 返回 SplitStream
  • 例子：

  SplitStream<Integer> split = someDataStream.split(new OutputSelector<Integer>() {
      @Override
      public Iterable<String> select(Integer value) {
          List<String> output = new ArrayList<String>();
          if (value % 2 == 0) {
              output.add("even");
          }
          else {
              output.add("odd");
          }
          return output;
      }
  });
  

  • Transformation：在这一步会生成一个SplitTransformation，里面包含了OutputSelector。

    
    SplitTransformation

  • Runtime: 在生成StreamGraph时找到父Transformation，并将OutputSelector注入到父StreamNode中。生成JobGraph的时候在注入到对应的JobNode中，最后在运行时封装到OperatorChain的OutputCollector中并且注入算子。

    
    SplitRuntime

• Iterate

  • 通过将一个算子的输出重定向到某个输入Operator上来创个一个循环。非常适合用来持续更新一个模型。
  • 过程 DataStream → IterativeStream → DataStream
  • 例子：

  IterativeStream<Long> iteration = initialStream.iterate();
  DataStream<Long> iterationBody = iteration.map (/*do something*/);
  DataStream<Long> feedback = iterationBody.filter(new FilterFunction<Long>(){
      @Override
      public boolean filter(Integer value) throws Exception {
          return value > 0;
      }
  });
  iteration.closeWith(feedback);
  DataStream<Long> output = iterationBody.filter(new FilterFunction<Long>(){
      @Override
      public boolean filter(Integer value) throws Exception {
          return value <= 0;
      }
  });              
  

  • Iterate不展开讲解

• ExtractTimestamps

  • 从元素中提取timestamp来用作事件时间（EventTime）。
  • 参数 TimeStampExtractor
  • 返回 DataStream
  • 例子：

  stream.assignTimestamps (new TimeStampExtractor() {...}); 
  

  • Transformation：assignTimestamps会将TimeStampExtractor注入进刚创建的ExtractTimestampsOperator，再通过ExtractTimestampsOperator生成一个OneInputTransformation

    
    ExtractTimestampsTransformation

  • Runtime：

    
    ExtractTimestampsTask

• Project

  • 如果元素是Tuple，直接通过index提取出Tuple中的字段组成新的Tuple，并产出结果
  • 参数 Tuple中的index（int， 一个或多个）
  • 返回 DataStream
  • 例子：

  DataStream<Tuple3<Integer, Double, String>> in = // [...]
  DataStream<Tuple2<String, Integer>> out = in.project(2,0);
  

  • Transformation：生成一个OneInputTransformation并包含StreamProjection算子

    
    StreamProjectionTransformation

  • Runtime

    
    StreamProjectionTask

• Custom partitioning

  • 通过用户定义的流分区器（Partitioner）将每个元素传输到指定的subtask
  • 参数 Partitioner， Tuple索引/POJO属性名/KeySelector
  • 返回 DataStream
  • 例子：

  dataStream.partitionCustom(partitioner, "someKey");
  dataStream.partitionCustom(partitioner, 0);
  

  • Transformation：partitionCustom类似于KeyBy，不过partitioner是由自己定制并且输出的不是KeyedStream。首先会通过KeySelector和用户实现的Partitioner生成一个CustomPartitionerWrapper（StreamPartitioner），再讲它注入到PartitionTransformation。

    
    CustomPartitioningTransformation

  • Runtime：将Partitioner注入StreamRecordWriter中用于将上一个Task的输出元素指定到某一个ResultSubParition中

    
    CustomPartitioningTask

• Random partitioning

  • 将元素按照均匀分布打散到下游
  • 返回 DataStream
  • 例子：

  dataStream.shuffle();
  

  • Transformation: 将partitioner换成ShufflePartitioner，其余同上
  • Runtime：同上

• Rebalancing (Round-robin partitioning)

  • 通过轮询调度（Round-robin）将元素均匀的分配到下游
  • 返回 DataStream
  • 例子

  dataStream.rebalance();
  

  • Transformation: 将partitioner换成RebalancePartitioner，其余同上
  • Runtime：同上

• Rescaling

  • 通过轮询调度将元素从上游的task一个子集发送到下游task的一个子集
  • 返回 DataStream
  • 原理：第一个task并行度为2，第二个task并行度为6，第三个task并行度为2。从第一个task到第二个task，Src的子集Src1 和 Map的子集Map1，2，3对应起来，Src1会以轮询调度的方式分别向Map1，2，3发送记录。从第二个task到第三个task，Map的子集1，2，3对应Sink的子集1，这三个流的元素只会发送到Sink1。
    假设我们每个TaskManager有三个Slot，并且我们开了SlotSharingGroup，那么通过rescale，所有的数据传输都在一个TaskManager内，不需要通过网络。
  • rescale.png
  • 例子

  dataStream.rescale();
  

  • Transformation: 将partitioner换成RescalePartitioner，其余同上
  • Runtime：同上

• Broadcasting

  • 将元素广播到每个分区
  • 返回DataStream
  • 例子：

  dataStream.broadcast();
  

KeyedStream

• Reduce

  • 根据ReduceFunction将元素与上一个reduce后的结果合并，产出合并之后的结果。
  • 参数 ReduceFunction
  • 返回 DataStream
  • 例子：

  keyedStream.reduce(new ReduceFunction<Integer>() {
      @Override
      public Integer reduce(Integer value1, Integer value2)
      throws Exception {
          return value1 + value2;
      }
  });
  

  • Transformation：生成一个OneInputTransformation并包含StreamGroupedReduce算子

    
    KeyedReduceTransformation

  • Runtime：

    
    KeyedReduceTask

• Fold

  • 根据FoldFunction和初始值，将元素与上一个fold过后的结果合并，产出合并之后的结果。
  • 参数 FoldFunction
  • 返回 DataStream
  • 例子：

  DataStream<String> result =
    keyedStream.fold("start", new FoldFunction<Integer, String>() {
      @Override
      public String fold(String current, Integer value) {
          return current + "-" + value;
      }
    });
  

  • Transformation：将StreamGroupedReduce换成StreamGroupedFold，其余同Reduce
  • Runtime：将StreamGroupedReduce换成StreamGroupedFold，其余同Reduce

• Aggregations

  • Flink实现的一系列聚合方法，具体作用由方法名就可以得知
  • 返回 DataStream
  • 例子：

  keyedStream.sum(0);
  keyedStream.sum("key");
  keyedStream.min(0);
  keyedStream.min("key");
  keyedStream.max(0);
  keyedStream.max("key");
  keyedStream.minBy(0);
  keyedStream.minBy("key");
  keyedStream.maxBy(0);
  keyedStream.maxBy("key");
  

  • Transformation：StreamGroupedReduce里注入了Flink内置的Aggregation方法实现，同Reduce
  • Transformation：同Reduce

• Window

  • 窗口将同一个key的元素按照某种特性聚集在一起（如时间：滑动窗口，翻转窗口，会话窗口，又如出现次数：计数窗口）
  • 返回WindowedStream
  • 参数WindowAssigner
  • 例子：

  dataStream.window(TumblingEventTimeWindows.of(Time.seconds(5))); // Last 5 seconds of data
  

  • Transformation: 生成一个WindowedStream，不产生Transformation，详情见WindowedStream详解
  • Runtime：详情见WindowedStream

• Interval Join

  • 给定一个时间间隔，将两个流中的元素按照key来做join
  • 满足条件e1.timestamp + lowerBound <= e2.timestamp <= e1.timestamp + upperBound
  • 参数 1. KeyedStream 2. Time: LowerBound and UpperBound 3. boolean(optional) 4. boolean(optional) 5. IntervalJoinFunction
  • 返回DataStream
  • 例子：

  // this will join the two streams so that
  // key1 == key2 && leftTs - 2 < rightTs < leftTs + 2
  keyedStream.intervalJoin(otherKeyedStream)
      .between(Time.milliseconds(-2), Time.milliseconds(2)) // lower and upper bound
      .upperBoundExclusive(true) // optional
      .lowerBoundExclusive(true) // optional
      .process(new IntervalJoinFunction() {...});
  

WindowedStream

• Apply

  • 使用WindowFunction对window重的元素做处理（例如聚合操作）并产出结果
  • 参数 WindowFunction
  • 返回 DataStream
  • 例子：

  windowedStream.apply (new WindowFunction<Tuple2<String,Integer>, Integer, Tuple, Window>() {
      public void apply (Tuple tuple,
              Window window,
              Iterable<Tuple2<String, Integer>> values,
              Collector<Integer> out) throws Exception {
          int sum = 0;
          for (value t: values) {
              sum += t.f1;
          }
          out.collect (new Integer(sum));
      }
  });
  

  • Transformation：

    
    WindowApplyTransformation

  • Runtime：

    
    WindowApply Task

• Reduce

  • 根据ReduceFunction将窗口中的元素按照key和window合并，并产出结果
  • 参数 ReduceFunction
  • 返回DataStream
  • 例子

  windowedStream.reduce (new ReduceFunction<Tuple2<String,Integer>>() {
      public Tuple2<String, Integer> reduce(Tuple2<String, Integer> value1, Tuple2<String, Integer> value2) throws Exception {
          return new Tuple2<String,Integer>(value1.f0, value1.f1 + value2.f1);
      }
  });
  

  • Transformation：基本同上，将ReduceFunction注入到WindowOperator中（具体注入方式要看有没有evictor，这边不作赘述）。
  • Runtime：同上

• Aggregations

  • Flink实现的一系列聚合方法，具体作用由方法名就可以得知，需要注意的是他们被分别作用在按key和window分割过后的元素集合上
  • 返回 DataStream
  • 例子：

  windowedStream.sum(0);
  windowedStream.sum("key");
  windowedStream.min(0);
  windowedStream.min("key");
  windowedStream.max(0);
  windowedStream.max("key");
  windowedStream.minBy(0);
  windowedStream.minBy("key");
  windowedStream.maxBy(0);
  windowedStream.maxBy("key");
  

  • Transformation：WindowOperator里注入了Flink内置的Aggregation方法实现，其余同上
  • Runtime：同上

AllWindowedStream

• Apply

  • 使用WindowFunction对window重的元素做处理（例如聚合操作）并产出结果
  • 与WindowedStream的区别在于是否有key
  • 参数 WindowFunction
  • 返回 DataStream
  • 例子

  // applying an AllWindowFunction on non-keyed window stream
  allWindowedStream.apply (new AllWindowFunction<Tuple2<String,Integer>, Integer, Window>() {
      public void apply (Window window,
              Iterable<Tuple2<String, Integer>> values,
              Collector<Integer> out) throws Exception {
          int sum = 0;
          for (value t: values) {
              sum += t.f1;
          }
          out.collect (new Integer(sum));
      }
  });
  

  • Transformation：AllWindowedStream.apply()与WindowedStream.apply()基本是一致的，只是没有KeySelector
  • Runtime：通WindowedStream.apply()

ConnectedStreams

• CoMap, CoFlatMap

  • 同时对两个流进行Map或FlatMap操作
  • 参数 CoMapFunction, CoFlatMapFunction
  • 返回 DataStream
  • 例子：

  connectedStreams.map(new CoMapFunction<Integer, String, Boolean>() {
      @Override
      public Boolean map1(Integer value) {
          return true;
      }
      
      @Override
      public Boolean map2(String value) {
          return false;
      }
  });
  connectedStreams.flatMap(new CoFlatMapFunction<Integer, String, String>() {
  
     @Override
     public void flatMap1(Integer value, Collector<String> out) {
         out.collect(value.toString());
     }
  
     @Override
     public void flatMap2(String value, Collector<String> out) {
         for (String word: value.split(" ")) {
           out.collect(word);
         }
     }
  });
  

  • Transformation：ConnectedStream并不会产生Transformation，只会保存两个Input DataStream，从inputs中的DataStream获取父Transformation，并生成一个CoStream(Flat)Map算子。KeySelector依赖于父Transformation注入（如果是PartitionTransformation的话）。

    
    Co(Flat)MapTransformation

  • Runtime: Task会具体负责调用processElement1方法还是processElement2方法。

    
    CoStream(Flat)MapTask

SplitStream

• Select

  • 根据SplitStream中OutputSelector设定的规则获取一个或多个DataStream
  • 参数 OutputNames
  • 返回 DataStream
  • 例子：

  SplitStream<Integer> split;
  DataStream<Integer> even = split.select("even");
  DataStream<Integer> odd = split.select("odd");
  DataStream<Integer> all = split.select("even","odd");
  

  • Transformation：生成SelectTransformation，里面包含了OutputSelector

    
    SelectTransformation

  • Runtime：生成StreamGraph时会将OutputNames注入到新生成的StreamEdge中，然后注入到对应的JobEdge中，最后用它来生成OutputCollector中的outputMap，发送消息时根据相应的selectedName发送到相应的下游Task

    
    Select Runtime