Flink Kafa Connector是Flink内置的Kafka连接器，它包含了从Kafka Topic读入数据的Flink Kafka Consumer以及向Kafka Topic写出数据的Flink Kafka Producer，除此之外Flink Kafa Connector基于Flink Checkpoint机制提供了完善的容错能力。本文从Flink Kafka Connector的基本使用到Kafka在Flink中端到端的容错原理展开讨论。

1 Flink Kafka的使用

在Flink中使用Kafka Connector时需要依赖Kafka的版本，Flink针对不同的Kafka版本提供了对应的Connector实现。

01 版本依赖

既然Flink对不同版本的Kafka有不同实现，在使用时需要注意区分，根据使用环境引入正确的依赖关系。

<dependency>
  <groupId>org.apache.flink</groupId>
  <artifactId>${flink_kafka_connector_version}</artifactId>
  <version>${flink_version}</version>
</dependency>

在上面的依赖配置中${flink_version}指使用Flink的版本，${flink_connector_kafka_version}指依赖的Kafka connector版本对应的artifactId。下表描述了截止目前为止Kafka服务版本与Flink Connector之间的对应关系。

Flink官网内容Apache Kafka Connector（https://ci.apache.org/projects/flink/flink-docs-release-1.7/dev/connectors/kafka.html）中也有详细的说明。

从Flink 1.7版本开始为Kafka 1.0.0及以上版本提供了全新的的Kafka Connector支持，如果使用的Kafka版本在1.0.0及以上可以忽略因Kafka版本差异带来的依赖变化。

02 基本使用

明确了使用的Kafka版本后就可以编写一个基于Flink Kafka读/写的应用程序「本文讨论内容全部基于Flink 1.7版本和Kafka 1.1.0版本」。根据上面描述的对应关系在工程中添加Kafka Connector依赖。

<dependency>
  <groupId>org.apache.flink</groupId>
  <artifactId>flink-connector-kafka_2.11</artifactId>
  <version>1.7.0</version>
</dependency>

下面的代码片段是从Kafka Topic「flink_kafka_poc_input」中消费数据，再写入Kafka Topic「flink_kafka_poc_output」的简单示例。示例中除了读/写Kafka Topic外，没有做其他的逻辑处理。

public static void main(String[] args) {
  StreamExecutionEnvironment env = StreamExecutionEnvironment.getExecutionEnvironment();

  /** 初始化Consumer配置 */
  Properties consumerConfig = new Properties();
  consumerConfig.setProperty("bootstrap.servers", "127.0.0.1:9091");
  consumerConfig.setProperty("group.id", "flink_poc_k110_consumer");

  /** 初始化Kafka Consumer */
  FlinkKafkaConsumer<String> flinkKafkaConsumer = 
    new FlinkKafkaConsumer<String>(
      "flink_kafka_poc_input", 
      new SimpleStringSchema(), 
      consumerConfig
    );
  /** 将Kafka Consumer加入到流处理 */
  DataStream<String> stream = env.addSource(flinkKafkaConsumer);

  /** 初始化Producer配置 */
  Properties producerConfig = new Properties();
  producerConfig.setProperty("bootstrap.servers", "127.0.0.1:9091");

  /** 初始化Kafka Producer */
  FlinkKafkaProducer<String> myProducer = 
    new FlinkKafkaProducer<String>(
      "flink_kafka_poc_output", 
      new MapSerialization(), 
      producerConfig
    );
  /** 将Kafka Producer加入到流处理 */
  stream.addSink(myProducer);

  /** 执行 */
  env.execute();
}

class MapSerialization implements SerializationSchema<String> {
  public byte[] serialize(String element) {
    return element.getBytes();
  }
}

Flink API使用起来确实非常简单，调用addSource方法和addSink方法就可以将初始化好的FlinkKafkaConsumer和FlinkKafkaProducer加入到流处理中。execute执行后，KafkaConsumer和KafkaProducer就可以开始正常工作了。

2 Flink Kafka的容错

众所周知，Flink支持Exactly-once semantics。什么意思呢？翻译过来就是「恰好一次语义」。流处理系统中，数据源源不断的流入到系统、被处理、最后输出结果。我们都不希望系统因人为或外部因素产生任何意想不到的结果。对于Exactly-once语义达到的目的是指即使系统被人为停止、因故障shutdown、无故关机等任何因素停止运行状态时，对于系统中的每条数据不会被重复处理也不会少处理。

01 Flink Exactly-once

Flink宣称支持Exactly-once其针对的是Flink应用内部的数据流处理。但Flink应用内部要想处理数据首先要有数据流入到Flink应用，其次Flink应用对数据处理完毕后也理应对数据做后续的输出。在Flink中数据的流入称为Source，数据的后续输出称为Sink，对于Source和Sink完全依靠外部系统支撑（比如Kafka）。

Flink自身是无法保证外部系统的Exactly-once语义。但这样一来其实并不能称为完整的Exactly-once，或者说Flink并不能保证端到端Exactly-once。而对于数据精准性要求极高的系统必须要保证端到端的Exactly-once，所谓端到端是指Flink应用从Source一端开始到Sink一端结束，数据必经的起始和结束两个端点。

那么如何实现端到端的Exactly-once呢？Flink应用所依赖的外部系统需要提供Exactly-once支撑，并结合Flink提供的Checkpoint机制和Two Phase Commit才能实现Flink端到端的Exactly-once。对于Source和Sink的容错保障，Flink官方给出了具体说明：

Fault Tolerance Guarantees of Data Sources and Sinks（https://ci.apache.org/projects/flink/flink-docs-release-1.7/dev/connectors/guarantees.html）

02 Flink Checkpoint

在讨论基于Kafka端到端的Exactly-once之前先简单了解一下Flink Checkpoint，详细内容在《Flink Checkpoint原理》中有做讨论。Flink Checkpoint是Flink用来实现应用一致性快照的核心机制，当Flink因故障或其他原因重启后可以通过最后一次成功的Checkpoint将应用恢复到当时的状态。如果在应用中启用了Checkpoint，会由JobManager按指定时间间隔触发Checkpoint，Flink应用内所有带状态的Operator会处理每一轮Checkpoint生命周期内的几个状态。

initializeState

由CheckpointedFunction接口定义。Task启动时获取应用中所有实现了CheckpointedFunction的Operator，并触发执行initializeState方法。在方法的实现中一般都是从状态后端将快照状态恢复。
snapshotState

由CheckpointedFunction接口定义。JobManager会定期发起Checkpoint，Task接收到Checkpoint后获取应用中所有实现了CheckpointedFunction的Operator并触发执行对应的snapshotState方法。

JobManager每发起一轮Checkpoint都会携带一个自增的checkpointId，这个checkpointId代表了快照的轮次。

public interface CheckpointedFunction {
  void snapshotState(FunctionSnapshotContext context) throws Exception;
  void initializeState(FunctionInitializationContext context) throws Exception;
}

notifyCheckpointComplete

由CheckpointListener接口定义。当基于同一个轮次(checkpointId相同)的Checkpoint快照全部处理成功后获取应用中所有实现了CheckpointListener的Operator并触发执行notifyCheckpointComplete方法。触发notifyCheckpointComplete方法时携带的checkpointId参数用来告诉Operator哪一轮Checkpoint已经完成。

public interface CheckpointListener {
  void notifyCheckpointComplete(long checkpointId) throws Exception;
}

03 Flink Kafka端到端Exactly-once

Kafka是非常收欢迎的分布式消息系统，在Flink中它可以作为Source，同时也可以作为Sink。Kafka 0.11.0及以上版本提供了对事务的支持，这让Flink应用搭载Kafka实现端到端的exactly-once成为了可能。下面我们就来深入了解提供了事务支持的Kafka是如何与Flink结合实现端到端exactly-once的。

本文忽略了Barrier机制，所以示例和图中都以单线程为例。Barrier在《Flink Checkpoint原理》有较多讨论。

Flink Kafka Consumer

Kafka自身提供了可重复消费消息的能力，Flink结合Kafka的这个特性以及自身Checkpoint机制，得以实现Flink Kafka Consumer的容错。

Flink Kafka Consumer是Flink应用从Kafka获取数据流消息的一个实现。除了数据流获取、数据发送下游算子这些基本功能外它还提供了完善的容错机制。这些特性依赖了其内部的一些组件以及内置的数据结构协同处理完成。这里，我们先简单了解这些组件和内置数据结构的职责，再结合Flink 运行时 和 故障恢复时 两个不同的处理时机来看一看它们之间是如何协同工作的。

Kafka Topic元数据

从Kafka消费数据的前提是需要知道消费哪个topic，这个topic有多少个partition。组件AbstractPartitionDiscoverer负责获得指定topic的元数据信息，并将获取到的topic元数据信息封装成KafkaTopicPartition集合。
KafkaTopicPartition

KafkaTopicPartition结构用于记录topic与partition的对应关系，内部定义了String topic和int partition两个主要属性。假设topic A有2个分区，通过组件AbstractPartitionDiscoverer处理后将得到由两个KafkaTopicPartition对象组成的集合：KafkaTopicPartition(topic:A, partition:0)和KafkaTopicPartition(topic:A, partition:1)
Kafka数据消费

作为Flink Source，Flink Kafka Consumer最主要的职责就是能从Kafka中获取数据，交给下游处理。在Kafka Consumer中AbstractFetcher组件负责完成这部分功能。除此之外Fetcher还负责offset的提交、KafkaTopicPartitionState结构的数据维护。
KafkaTopicPartitionState

KafkaTopicPartitionState是一个非常核心的数据结构，基于内部的4个基本属性，Flink Kafka Consumer维护了topic、partition、已消费offset、待提交offset的关联关系。Flink Kafka Consumer的容错机制依赖了这些数据。

除了这4个基本属性外KafkaTopicPartitionState还有两个子类，一个是支持PunctuatedWatermark的实现，另一个是支持PeriodicWatermark的实现，这两个子类在原有基础上扩展了对水印的支持，我们这里不做过多讨论。

状态持久化

Flink Kafka Consumer的容错性依靠的是状态持久化，也可以称为状态快照。对于Flink Kafka Consumer来说，这个状态持久化具体是对topic、partition、已消费offset的对应关系做持久化。

在实现中，使用ListState<Tuple2<KafkaTopicPartition, Long>>定义了状态存储结构，在这里Long表示的是offset类型，所以实际上就是使用KafkaTopicPartition和offset组成了一个对儿，再添加到状态后端集合。
状态恢复

当状态成功持久化后，一旦应用出现故障，就可以用最近持久化成功的快照恢复应用状态。在实现中，状态恢复时会将快照恢复到一个TreeMap结构中，其中key是KafkaTopicPartition，value是对应已消费的offset。恢复成功后，应用恢复到故障前Flink Kafka Consumer消费的offset，并继续执行任务，就好像什么都没发生一样。

运行时

我们假设Flink应用正常运行，Flink Kafka Consumer消费topic为Topic-A，Topic-A只有一个partition。在运行期间，主要做了这么几件事

Kafka数据消费

KafkaFetcher不断的从Kafka消费数据，消费的数据会发送到下游算子并在内部记录已消费过的offset。下图描述的是Flink Kafka Consumer从消费Kafka消息到将消息发送到下游算子的一个处理过程。

接下来我们再结合消息真正开始处理后，KafkaTopicPartitionState结构中的数据变化。

可以看到，随着应用的运行，KafkaTopicPartitionState中的offset属性值发生了变化，它记录了已经发送到下游算子消息在Kafka中的offset。在这里由于消息P0-C已经发送到下游算子，所以KafkaTopicPartitionState.offset变更为2。

状态快照处理

如果Flink应用开启了Checkpoint，JobManager会定期触发Checkpoint。FlinkKafkaConsumer实现了CheckpointedFunction，所以它具备快照状态(snapshotState)的能力。在实现中，snapshotState具体干了这么两件事

下图描述当一轮Checkpoint开始时FlinkKafkaConsumer的处理过程。在例子中，FlinkKafkaConsumer已经将offset=3的P0-D消息发送到下游，当checkpoint触发时将topic=Topic-A；partition=0；offset=3作为最后的状态持久化到外部存储。
- 将当前快照轮次(CheckpointId)与topic、partition、offset写入到一个待提交offset的Map集合，其中key是CheckpointId。
- 将FlinkKafkaConsumer当前运行状态持久化，即将topic、partition、offset持久化。一旦出现故障，就可以根据最新持久化的快照进行恢复。

下图描述当一轮Checkpoint开始时FlinkKafkaConsumer的处理过程。在例子中，FlinkKafkaConsumer已经将offset=3的P0-D消息发送到下游，当checkpoint触发时将topic=Topic-A；partition=0；offset=3作为最后的状态持久化到外部存储。

快照结束处理

当所有算子基于同一轮次快照处理结束后，会调用CheckpointListener.notifyCheckpointComplete(checkpointId)通知算子Checkpoint完成，参数checkpointId指明了本次通知是基于哪一轮Checkpoint。在FlinkKafkaConsumer的实现中，接到Checkpoint完成通知后会变更KafkaTopicPartitionState.commitedOffset属性值。最后再将变更后的commitedOffset提交到Kafka brokers或Zookeeper。

在这个例子中，commitedOffset变更为4，因为在快照阶段，将topic=Topic-A;partition=0;offset=3的状态做了快照，在真正提交offset时是将快照的offset + 1作为结果提交的。「源代码KafkaFetcher.java 207行doCommitInternalOffsetsToKafka方法」

故障恢复

Flink应用崩溃后，开始进入恢复模式。假设Flink Kafka Consumer最后一次成功的快照状态是topic=Topic-A；partition=0；offset=3，在恢复期间按照下面的先后顺序执行处理。

状态初始化

状态初始化阶段尝试从状态后端加载出可以用来恢复的状态。它由CheckpointedFunction.initializeState接口定义。在FlinkKafkaConsumer的实现中，从状态后端获得快照并写入到内部存储结构TreeMap，其中key是由KafkaTopicPartition表示的topic与partition，value为offset。下图描述的是故障恢复的第一个阶段，从状态后端获得快照，并恢复到内部存储。

function初始化

function初始化阶段除了初始化OffsetCommitMode和partitionDiscoverer外，还会初始化一个Map结构，该结构用来存储应用待消费信息。如果应用需要从快照恢复状态，则从待恢复状态中初始化这个Map结构。下图是该阶段从快照恢复的处理过程。

function初始化阶段兼容了正常启动和状态恢复时offset的初始化。对于正常启动过程，StartupMode的设置决定待消费信息中的结果。该模式共有5种，默认为StartupMode.GROUP_OFFSETS。

开始执行

在该阶段中，将KafkaFetcher初始化、初始化内部消费状态、启动消费线程等等，其目的是为了将FlinkKafkaConsumer运行起来，下图描述了这个阶段的处理流程

这里对图中两个步骤做个描述

步骤3，使用状态后端的快照结果topic=Topic-A；partition=0；offset=3初始化Flink Kafka Consumer内部维护的Kafka处理状态。因为是恢复流程，所以这个内部维护的处理状态也应该随着快照恢复。
步骤4，在真正消费Kafka数据前(指调用KafkaConsumer.poll方法)，使用Kafka提供的seek方法将offset重置到指定位置，而这个offset具体算法就是状态后端offset + 1。在例子中，消费Kafka数据前将offset重置为4，所以状态恢复后KafkaConsumer是从offset=4位置开始消费。「源代码KafkaConsumerThread.java 428行」

总结

上述的3个步骤是恢复期间主要的处理流程，一旦恢复逻辑执行成功，后续处理流程与正常运行期间一致。最后对FlinkKafkaConsumer用一句话做个总结。

「将offset提交权交给FlinkKafkaConsumer，其内部维护Kafka消费及提交的状态。基于Kafka可重复消费能力并配合Checkpoint机制和状态后端存储能力，就能实现FlinkKafkaConsumer容错性，即Source端的Exactly-once语义」。

Flink Kafka Producer

Flink Kafka Producer是Flink应用向Kafka写出数据的一个实现。在Kafka 0.11.0及以上版本中提供了事务支持，这让Flink搭载Kafka的事务特性可以轻松实现Sink端的Exactly-once语义。关于Kafka事务特性在《Kafka幂等与事务》中做了详细讨论。

在Flink Kafka Producer中，有一个非常重要的组件FlinkKafkaInternalProducer，这个组件代理了Kafka客户端org.apache.kafka.clients.producer.KafkaProducer，它为Flink Kafka Producer操作Kafka提供了强有力的支撑。在这个组件内部，除了代理方法外，还提供了一些关键操作。个人认为，Flink Kafka Sink能够实现Exactly-once语义除了需要Kafka支持事务特性外，同时也离不开FlinkKafkaInternalProducer组件提供的支持，尤其是下面这些关键操作：

事务重置FlinkKafkaInternalProducer组件中最关键的处理当属事务重置，事务重置由resumeTransaction方法实现「源代码FlinkKafkaInternalProducer.java 144行」。由于Kafka客户端未暴露针对事务操作的API，所以在这个方法内部，大量的使用了反射。方法中使用反射获得KafkaProducer依赖的transactionManager对象，并将状态后端快照的属性值恢复到transactionManager对象中，这样以达到让Flink Kafka Producer应用恢复到重启前的状态。

下面我们结合Flink 运行时 和 故障恢复 两个不同的处理时机来了解Flink Kafka Producer内部如何工作。

运行时

我们假设Flink应用正常运行，Flink Kafka Producer正常接收上游数据并写到Topic-B的Topic中，Topic-B只有一个partition。在运行期间，主要做以下几件事：

数据发送到Kafka

上游算子不断的将数据Sink到FlinkKafkaProducer，FlinkKafkaProducer接到数据后封装ProducerRecord对象并调用Kafka客户端KafkaProducer.send方法将ProducerRecord对象写入缓冲「源代码FlinkKafkaProducer.java 616行」。下图是该阶段的描述：

状态快照处理

Flink 1.7及以上版本使用FlinkKafkaProducer作为Kafka Sink，它继承抽象类TwoPhaseCommitSinkFunction，根据名字就能知道，这个抽象类主要实现两阶段提交。为了集成Flink Checkpoint机制，抽象类实现了CheckpointedFunction和CheckpointListener，因此它具备快照状态(snapshotState)能力。状态快照处理具体做了下面三件事：
调用KafkaProducer客户端flush方法，将缓冲区内全部记录发送到Kafka，但不提交。这些记录写入到Topic-B，此时这些数据的事务隔离级别为UNCOMMITTED，也就是说如果有个服务消费Topic-B，并且设置的isolation.level=read_committed，那么此时这个消费端还无法poll到flush的数据，因为这些数据尚未commit。什么时候commit呢？在快照结束处理阶段进行commit，后面会提到。
将快照轮次与当前事务记录到一个Map表示的待提交事务集合中，key是当前快照轮次的CheckpointId，value是由TransactionHolder表示的事务对象。TransactionHolder对象内部记录了transactionalId、producerId、epoch以及Kafka客户端kafkaProducer的引用。
持久化当前事务处理状态，也就是将当前处理的事务详情存入状态后端，供应用恢复时使用。

下图是状态快照处理阶段处理过程

快照结束处理

TwoPhaseCommitSinkFunction实现了CheckpointListener，应用中所有算子的快照处理成功后会收到基于某轮Checkpoint完成的通知。当FlinkKafkaProducer收到通知后，主要任务就是提交上一阶段产生的事务，而具体要提交哪些事务是从上一阶段生成的待提交事务集合中获取的。

图中第4步执行成功后，flush到Kafka的数据从UNCOMMITTED变更为COMMITTED，这意味着此时消费端可以poll到这批数据了。

2PC(两阶段提交)理论的两个阶段分别对应了FlinkKafkaProducer的状态快照处理阶段和快照结束处理阶段，前者是通过Kafka的事务初始化、事务开启、flush等操作预提交事务，后者是通过Kafka的commit操作真正执行事务提交。

故障恢复

Flink应用崩溃后，FlinkKafkaProducer开始进入恢复模式。下图为应用崩溃前的状态描述：

在恢复期间主要的处理在状态初始化阶段。当Flink任务重启时会触发状态初始化，此时应用与Kafka已经断开了连接。但在运行期间可能存在数据flush尚未提交的情况。

如果想重新提交这些数据需要从状态后端恢复当时KafkaProducer持有的事务对象，具体一点就是恢复当时事务的transactionalId、producerId、epoch。这个时候就用到了FlinkKafkaInternalProducer组件中的事务重置，在状态初始化时从状态后端获得这些事务信息，并重置到当前KafkaProducer中，再执行commit操作。这样就可以恢复任务重启前的状态，Topic-B的消费端依然可以poll到应用恢复后提交的数据。

需要注意的是：如果这个重置并提交的动作失败了，可能会造成数据丢失。下图描述的是状态初始化阶段的处理流程：

总结

FlinkKafkaProducer故障恢复期间，状态初始化是比较重要的处理阶段。这个阶段在Kafka事务特性的强有力支撑下，实现了事务状态的恢复，并且使得状态存储占用空间最小。依赖Flink提供的TwoPhaseCommitSinkFunction实现类，我们自己也可以对Sink做更多的扩展。

本文作者：TalkingData 史天舒

本文转载自公众号TalkingData（ID：TalkingData）。

原文链接：

https://mp.weixin.qq.com/s/1qrY2aujZwt8JtOr-24d7Q

创作场景

Flink Kafka Connector 与 Exactly Once 剖析