1 基本的 API 概念
Flink程序是实现分布式集合转换的常规程序(例如,过滤,映射,更新状态,加入,分组,定义窗口,聚合)。最初从源创建集合(例如,通过从文件,kafka主题或从本地的内存集合中读取)。结果通过接收器返回,接收器可以例如将数据写入(分布式)文件或标准输出(例如,命令行终端)。 Flink程序可以在各种环境中运行,独立运行或嵌入其他程序中。执行可以在本地JVM中执行,也可以在许多计算机的集群上执行。
根据数据源的类型,即有界或无界源,您可以编写批处理程序或流程序,其中
- DataSet API用于批处理
- DataStream API用于流式处理。
注意:在显示如何使用API的实际示例时,我们将使用StreamingExecutionEnvironment和DataStream API。 DataSet API中的概念完全相同,只需用ExecutionEnvironment和DataSet替换即可。
- 大数据的处理流程
2 DataSet & DataStream
Flink具有特殊类DataSet和DataStream来表示程序中的数据。 可以将它们视为可以包含重复项的不可变数据集合。
- 在DataSet的情况下,数据是有限的
- 而对于DataStream,元素的数量可以是无限的
这些集合在某些关键方面与常规Java集合不同。 首先,它们是不可变的
,这意味着一旦创建它们,就无法添加或删除元素。 也不能简单地检查里面的元素
。
最初通过在Flink程序中添加源来创建集合,并通过使用诸如map,filter等API方法对它们进行转换来从这些集合中派生新集合。
可以看出底层使用了数据源
3 Flink 项目流程剖析
Flink程序看起来像是转换数据集合的常规程序。 每个程序包含相同的基本部分:
- 获得执行环境,
- 加载/创建初始数据,
- 指定此数据的转换,
- 指定放置计算结果的位置,
- 触发程序执行
Scala版本
我们现在将概述每个步骤 Scala DataSet API的所有核心类都可以在org.apache.flink.api.scala包中找到 而Scala DataStream API的类可以在org.apache.flink.streaming.api.scala中找到
StreamExecutionEnvironment是所有Flink程序的基础 可以在StreamExecutionEnvironment上使用这些静态方法获取一个:
代码语言:javascript复制1:getExecutionEnvironment()
2:createLocalEnvironment()
3:createRemoteEnvironment(host: String, port: Int, jarFiles: String*)
- 法1示例代码
- 法2示例代码
此方法将环境的默认并行度设置为给定参数,默认为通过[[setDefaultLocalParallelism(Int)]]设置的值。
通常,只需要使用getExecutionEnvironment()
,因为这将根据上下文执行正确的操作:
- 如果在IDE中执行程序或作为常规Java程序,它将创建一个本地环境,将执行在本地机器上的程序。
- 如果从程序中创建了一个JAR文件,并通过命令行调用它,则Flink集群管理器将执行您的main方法,
getExecutionEnvironment()
将返回一个执行环境,用于在集群上执行程序。
对于指定数据源,执行环境可以通过各种途径从文件中读取
- 逐行读取它们
- CSV文件
- 使用完全自定义数据输入格式
要将文本文件作为一系列行读取,可以使用:
代码语言:javascript复制val env = StreamExecutionEnvironment.getExecutionEnvironment()
val text: DataStream[String] = env.readTextFile("file:///path/to/file")
这将提供一个DataStream
,然后就可以在其上应用转换来创建新的派生DataStream
也可以通过使用转换函数调用DataSet
上的方法来应用转换。 例如,map转换如下所示:
val input: DataSet[String] = ...
val mapped = input.map { x => x.toInt }
这将通过将原始集合中的每个String转换为Integer来创建新的DataStream
一旦有了包含最终结果的DataStream,就可以通过创建接收器将其写入外部系统。 这些只是创建接收器的一些示例方法:
代码语言:javascript复制writeAsText(path: String)
print()
一旦指定了完整的程序,就需要通过调用StreamExecutionEnvironment
上的execute()
触发程序执行
根据ExecutionEnvironment
的类型,将在本地计算机上触发执行或提交程序以在集群上执行。
execute()方法返回一个JobExecutionResult,它包含执行时间和累加器结果。
触发程序执行。环境将执行导致"sink"操作运作程序的所有部分 Sink操作例如是打印结果或将它们转发到消息队列。 该法将记录程序执行并使用提供的名称显示。
4 延迟执行
所有Flink程序都是延迟执行:当执行程序的main方法时,数据加载和转换不会立即执行。而是创建每个操作并将其添加到程序的计划中。
当执行环境上的execute()
调用显式触发执行时,实际执行操作。
程序是在本地执行还是在集群上执行取决于执行环境的类型
延迟执行使我们可以构建Flink作为一个整体计划单元执行的复杂程序,进行内部的优化。
5 指定keys
上述程序中的这些数据如何确定呢?
某些转换(join,coGroup,keyBy,groupBy)要求在元素集合上定义key 其他转换(Reduce,GroupReduce,Aggregate,Windows)允许数据在应用之前在key上分组。
- DataSet分组为
DataSet<...> input = // [...]
DataSet<...> reduced = input
.groupBy(/*define key here*/)
.reduceGroup(/*do something*/);
虽然可以使用DataStream指定key
代码语言:javascript复制DataStream<...> input = // [...]
DataStream<...> windowed = input
.keyBy(/*define key here*/)
.window(/*window specification*/);
Flink的数据模型不基于键值对。 因此,无需将数据集类型物理打包到键和值中。 键是“虚拟的”:它们被定义为实际数据上的函数,以指导分组操作符。
注意:在下面的讨论中,将使用DataStream API和keyBy。 对于DataSet API,只需要用DataSet和groupBy替换。
5.1 定义元组的键
- 源码
即 :按给定的键位置(对于元组/数组类型)对DataStream的元素进行分组,以与分组运算符(如分组缩减或分组聚合)一起使用。
最简单的情况是在元组的一个或多个字段上对元组进行分组:
代码语言:javascript复制val input: DataStream[(Int, String, Long)] = // [...]
val keyed = input.keyBy(0)
元组在第一个字段(整数类型)上分组。
代码语言:javascript复制val input: DataSet[(Int, String, Long)] = // [...]
val grouped = input.groupBy(0,1)
在这里,我们将元组分组在由第一个和第二个字段组成的复合键上。
关于嵌套元组的注释:如果你有一个带有嵌套元组的DataStream,例如:
代码语言:javascript复制DataStream<Tuple3<Tuple2<Integer, Float>,String,Long>> ds;
指定keyBy(0)将使系统使用完整的Tuple2作为键(以Integer和Float为键)。 如果要“导航”到嵌套的Tuple2中,则必须使用下面解释的字段表达式键。
5.2 指定key的字段表达式
可以使用基于字符串的字段表达式来引用嵌套字段,并定义用于分组,排序,连接或coGrouping的键。
字段表达式可以非常轻松地选择(嵌套)复合类型中的字段,例如Tuple和POJO类型。
我们有一个WC POJO,其中包含两个字段“word”和“count”。
- Java版本代码
- Scala版本代码
要按字段分组,我们只需将其名称传递给keyBy()函数。
代码语言:javascript复制// some ordinary POJO (Plain old Java Object)
class WC(var word: String, var count: Int) {
def this() { this("", 0L) }
}
val words: DataStream[WC] = // [...]
val wordCounts = words.keyBy("word").window(/*window specification*/)
// or, as a case class, which is less typing
case class WC(word: String, count: Int)
val words: DataStream[WC] = // [...]
val wordCounts = words.keyBy("word").window(/*window specification*/)
5.2.1 字段表达式语法:
- 按字段名称选择POJO字段 例如,“user”指的是POJO类型的“user”字段
- 通过1偏移字段名称或0偏移字段索引选择元组字段 例如,“_ 1”和“5”分别表示Scala Tuple类型的第一个和第六个字段。
- 可以在POJO和Tuples中选择嵌套字段 例如,“user.zip”指的是POJO的“zip”字段,其存储在POJO类型的“user”字段中。 支持任意嵌套和混合POJO和元组,例如“_2.user.zip”或“user._4.1.zip”。
- 可以使用“_”通配符表达式选择完整类型 这也适用于非Tuple或POJO类型的类型。
5.2.2 字段表达示例
代码语言:javascript复制class WC(var complex: ComplexNestedClass, var count: Int) {
def this() { this(null, 0) }
}
class ComplexNestedClass(
var someNumber: Int,
someFloat: Float,
word: (Long, Long, String),
hadoopCitizen: IntWritable) {
def this() { this(0, 0, (0, 0, ""), new IntWritable(0)) }
}
这些是上面示例代码的有效字段表达式:
- “count”:WC类中的count字段。
- “complex”:递归选择POJO类型ComplexNestedClass的字段复合体的所有字段。
- “complex.word._3”:选择嵌套Tuple3的最后一个字段。
- “complex.hadoopCitizen”:选择Hadoop IntWritable类型。
5.3 指定key的key选择器函数
定义键的另一种方法是“键选择器”功能。 键选择器函数将单个元素作为输入并返回元素的键。 key可以是任何类型,并且可以从确定性计算中导出。
以下示例显示了一个键选择器函数,它只返回一个对象的字段:
- Java
- Scala
6 指定转换函数
大多数转换都需要用户自定义的函数。 本节列出了如何指定它们的不同方法
6.1 Java版本
6.1.1 实现接口
最基本的方法是实现一个提供的接口:
代码语言:javascript复制class MyMapFunction implements MapFunction<String, Integer> {
public Integer map(String value) { return Integer.parseInt(value); }
};
data.map(new MyMapFunction());
6.1.2 匿名类
可以将函数作为匿名类传递:
代码语言:javascript复制data.map(new MapFunction<String, Integer> () {
public Integer map(String value) { return Integer.parseInt(value); }
});
6.1.3 Java 8 Lambdas
Flink还支持Java API中的Java 8 Lambdas。
代码语言:javascript复制data.filter(s -> s.startsWith("http://"));
data.reduce((i1,i2) -> i1 i2);
6.1.4 增强函数
所有需要用户定义函数的转换都可以将增强函数作为参数。 例如,与其写成
代码语言:javascript复制class MyMapFunction implements MapFunction<String, Integer> {
public Integer map(String value) { return Integer.parseInt(value); }
};
不如写成
代码语言:javascript复制class MyMapFunction extends RichMapFunction<String, Integer> {
public Integer map(String value) { return Integer.parseInt(value); }
};
并像往常一样将函数传递给map转换:
代码语言:javascript复制data.map(new MyMapFunction());
也可以定义为匿名类:
代码语言:javascript复制data.map (new RichMapFunction<String, Integer>() {
public Integer map(String value) { return Integer.parseInt(value); }
});
除了用户定义的函数(map,reduce等)之外,Rich函数还提供了四种方法:open,close,getRuntimeContext和setRuntimeContext。 这些用于参数化函数(请参阅将参数传递给函数),创建和完成本地状态,访问广播变量以及访问运行时信息(如累加器和计数器)
7 支持的数据类型
Flink对DataSet或DataStream中可以包含的元素类型设置了一些限制。 原因是系统分析类型以确定有效的执行策略。
有六种不同类别的数据类型:
- Java 元组 and Scala Case 类
- Java POJOs
- 原生类型
- Regular Classes
- Values
- Hadoop Writables
- Special Types
7.1 元组 and Case 类
7.1.1 Java版本
元组是包含固定数量的具有各种类型的字段的复合类型。 Java API提供从Tuple0到Tuple25的类。
元组的每个字段都可以是包含更多元组的任意的Flink的类型,从而产生嵌套元组。 可以使用字段名称tuple.f4直接访问元组的字段,也可以使用通用getter方法tuple.getField(int position)。 字段索引从0开始。
代码语言:javascript复制这与Scala的元组形成对比,但Java的常规索引更为一致。
DataStream<Tuple2<String, Integer>> wordCounts = env.fromElements(
new Tuple2<String, Integer>("hello", 1),
new Tuple2<String, Integer>("world", 2));
wordCounts.map(new MapFunction<Tuple2<String, Integer>, Integer>() {
@Override
public Integer map(Tuple2<String, Integer> value) throws Exception {
return value.f1;
}
});
wordCounts.keyBy(0); // also valid .keyBy("f0")
7.1.2 Scala版本
Scala case类(和Scala元组是case类的特例)是包含固定数量的具有各种类型的字段的复合类型。 元组字段由它们的1偏移名称寻址,例如第一个字段的_1。 字段按名称访问。
代码语言:javascript复制case class WordCount(word: String, count: Int)
val input = env.fromElements(
WordCount("hello", 1),
WordCount("world", 2)) // Case Class Data Set
input.keyBy("word")// key by field expression "word"
val input2 = env.fromElements(("hello", 1), ("world", 2)) // Tuple2 Data Set
input2.keyBy(0, 1) // key by field positions 0 and 1
7.2 POJOs
如果满足以下要求,则Flink将Java和Scala类视为特殊的POJO数据类型:
- public限定
- 它必须有一个没有参数的公共构造函数(默认构造函数)。
- 所有字段都是public的,或者必须通过getter和setter函数访问。 对于名为foo的字段,getter和setter方法必须命名为getFoo()和setFoo()。
- Flink必须支持字段的类型。 目前,Flink使用Avro序列化任意对象(例如Date)。
Flink分析POJO类型的结构,即它了解POJO的字段。 因此,POJO类型比一般类型更容易使用。 此外,Flink可以比一般类型更有效地处理POJO。
以下示例显示了一个包含两个公共字段的简单POJO。
7.2.1 Java版本
代码语言:javascript复制public class WordWithCount {
public String word;
public int count;
public WordWithCount() {}
public WordWithCount(String word, int count) {
this.word = word;
this.count = count;
}
}
DataStream<WordWithCount> wordCounts = env.fromElements(
new WordWithCount("hello", 1),
new WordWithCount("world", 2));
wordCounts.keyBy("word"); // key by field expression "word"
7.2.2 Scala 版本
代码语言:javascript复制class WordWithCount(var word: String, var count: Int) {
def this() {
this(null, -1)
}
}
val input = env.fromElements(
new WordWithCount("hello", 1),
new WordWithCount("world", 2)) // Case Class Data Set
input.keyBy("word")// key by field expression "word"
7.3 原生类型
Flink支持所有Java和Scala原生类型,如Integer,String和Double。
7.4 General Class Types
Flink支持大多数Java和Scala类(API和自定义)。 限制适用于包含无法序列化的字段的类,如文件指针,I / O流或其他本机资源。 遵循Java Beans约定的类通常可以很好地工作。
所有未标识为POJO类型的类都由Flink作为常规类类型处理。 Flink将这些数据类型视为黑盒子,并且无法访问其内容(即,用于有效排序)。 使用序列化框架Kryo对常规类型进行反序列化。
7.5 Values
值类型手动描述其序列化和反序列化。 它们不是通过通用序列化框架,而是通过使用读取和写入方法实现org.apache.flinktypes.Value接口来为这些操作提供自定义代码。当通用序列化效率非常低时,使用值类型是合理的。
一个示例是将元素的稀疏向量实现为数组的数据类型。知道数组大部分为零,可以对非零元素使用特殊编码,而通用序列化只需编写所有数组元素。
org.apache.flinktypes.CopyableValue接口以类似的方式支持手动内部克隆逻辑。
Flink带有与基本数据类型对应的预定义值类型。 (ByteValue,ShortValue,IntValue,LongValue,FloatValue,DoubleValue,StringValue,CharValue,BooleanValue)。这些值类型充当基本数据类型的可变变体:它们的值可以被更改,允许程序员重用对象并从垃圾收集器中消除压力。
7.6 Hadoop Writables
可以使用实现org.apache.hadoop.Writable接口的类型。 write()和readFields()方法中定义的序列化逻辑将用于序列化。
7.7 Special Types
可以使用特殊类型,包括Scala的Either,Option和Try Java API有自己的自定义Either实现。 与Scala的Either类似,它代表两种可能类型的值,左或右。 两者都可用于错误处理或需要输出两种不同类型记录的运算符。
7.8 Type Erasure & Type Inference
仅适用于Java
Java编译器在编译后抛弃了大部分泛型类型信息。这在Java中称为类型擦除。这意味着在运行时,对象的实例不再知道其泛型类型。例如,DataStream 和DataStream 的实例于JVM看起来相同。
Flink在准备执行程序时(当调用程序的主要方法时)需要类型信息。 Flink Java API尝试重建以各种方式丢弃的类型信息,并将其显式存储在数据集和运算符中。您可以通过DataStream.getType()检索类型。该方法返回TypeInformation的一个实例,这是Flink表示类型的内部方式。
类型推断有其局限性,在某些情况下需要程序员的“合作”。这方面的示例是从集合创建数据集的方法,例如
代码语言:javascript复制ExecutionEnvironment.fromCollection()
可以在其中传递描述类型的参数。但是像MapFunction <I,O>这样的通用函数也可能需要额外的类型信息。
ResultTypeQueryable接口可以通过输入格式和函数实现,以明确告知API其返回类型。调用函数的输入类型通常可以通过先前操作的结果类型来推断。
参考
Apache Flink