You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

394 lines
23 KiB
Markdown

This file contains invisible Unicode characters!

This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden characters.

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 15 | 数据源与数据格式DataFrame从何而来
你好,我是吴磊。
在上一讲我们重点讲解了DataFrame与Spark SQL的渊源并提到DataFrame是Spark SQL的重要入口。换句话说通过创建DataFrame并沿用DataFrame开发API我们才能充分利用Spark SQL优化引擎提供种种“性能红利”。显然对于初学者来说第一步的创建DataFrame就变得至关重要。
之前 [第13讲](https://time.geekbang.org/column/article/424550)我们做小汽车摇号倍率分析时用了SparkSession的read API从Parquet文件创建DataFrame其实创建DataFrame的方法还有很多。毫不夸张地说DataFrame的创建途径异常丰富为什么这么说呢
如下图所示Spark支持多种数据源按照数据来源进行划分这些数据源可以分为如下几个大类Driver端自定义的数据结构、分布式文件系统、关系型数据库RDBMS、关系型数据仓库、NoSQL数据库以及其他的计算引擎。
![图片](https://static001.geekbang.org/resource/image/f9/f6/f99dae173ba0268a8bd486ab200ecdf6.jpg?wh=1920x696 "Spark支持的数据源")
显然要深入地介绍Spark与每一种数据源的集成并不现实也没必要咱们只需要把注意力放在那些最常用、最常见的集成方式即可。
这一讲我会从Driver、文件系统与RDBMS三个方面为你讲解5种常见的DataFrame创建方式然后带你了解不同方式的使用场景跟优劣分析。
## 从Driver创建DataFrame
在Driver端Spark可以直接从数组、元组、映射等数据结构创建DataFrame。使用这种方式创建的DataFrame通常数据量有限因此这样的DataFrame往往不直接参与分布式计算而是用于辅助计算或是数据探索。尽管如此学习这部分知识点还是非常必要的因为它可以帮我们更直观地理解DataFrame与RDD的关系。
还记得吗在数据表示Data Representation相比RDDDataFrame仅仅是多了一个Schema。甚至可以说DataFrame就是带Schema的RDD。因此创建DataFrame的第一种方法就是先创建RDD然后再给它“扣上”一顶Schema的“帽子”。
从本地数据结构创建RDD我们用的是SparkContext的parallelize方法而给RDD“扣帽子”我们要用到SparkSession的createDataFrame方法。
### createDataFrame方法
为了创建RDD我们先来定义列表数据seq。seq的每个元素都是二元元组元组第一个元素的类型是String第二个元素的类型是Int。有了列表数据结构接下来我们创建RDD如下所示。
```scala
import org.apache.spark.rdd.RDD
val seq: Seq[(String, Int)] = Seq(("Bob", 14), ("Alice", 18))
val rdd: RDD[(String, Int)] = sc.parallelize(seq)
```
有了RDD之后我们来给它制作一顶“帽子”也就是我们刚刚说的Schema。创建Schema我们需要用到Spark SQL内置的几种类型如StructType、StructField、StringType、IntegerType等等。
其中StructType用于定义并封装SchemaStructFiled用于定义Schema中的每一个字段包括字段名、字段类型而像StringType、IntegerType这些\*Type类型表示的正是字段类型。为了和RDD数据类型保持一致Schema对应的元素类型应该是StringTypeIntegerType
```scala
import org.apache.spark.sql.types.{StringType, IntegerType, StructField, StructType}
val schema:StructType = StructType( Array(
StructField("name", StringType),
StructField("age", IntegerType)
))
```
好啦到此为止我们有了RDD也有了为它量身定做的“帽子”Schema。不过在把帽子扣上去之前我们还要先给RDD整理下“发型”。这是什么意思呢
createDataFrame方法有两个形参第一个参数正是RDD第二个参数是Schema。createDataFrame要求RDD的类型必须是RDD\[Row\]其中的Row是org.apache.spark.sql.Row因此对于类型为RDD\[(String, Int)\]的rdd我们需要把它转换为RDD\[Row\]。
```scala
import org.apache.spark.sql.Row
val rowRDD: RDD[Row] = rdd.map(fileds => Row(fileds._1, fileds._2))
```
“发型”整理好之后我们就可以调用createDataFrame来创建DataFrame代码如下所示。
```scala
import org.apache.spark.sql.DataFrame
val dataFrame: DataFrame = spark.createDataFrame(rowRDD,schema)
```
DataFrame创建好之后别忘了验证它的可用性我们可以通过调用show方法来做简单的数据探索验证DataFrame创建是否成功。
```scala
dataFrame.show
 
/** 结果显示
+----+---+
| name| age|
+----+---+
| Bob| 14|
| Alice| 18|
+----+---+
*/
```
历尽千辛万苦我们先是用Driver端数据结构创建RDD然后再调用createDataFrame把RDD转化为DataFrame。你可能会说“相比用parallelize创建RDD用createDataFrame创建DataFrame的方法未免复杂了些有没有更简便的方法呢”我们接着往下看。
### toDF方法
其实要把RDD转化为DataFrame我们并不一定非要亲自制作Schema这顶帽子还可以直接在RDD之后调用toDF方法来做到这一点。咱们先来看toDF函数的用法然后再去分析spark.implicits是如何帮我们轻松创建DataFrame的。
```scala
import spark.implicits._
val dataFrame: DataFrame = rdd.toDF
dataFrame.printSchema
/** Schema显示
root
|-- _1: string (nullable = true)
|-- _2: integer (nullable = false)
*/
```
可以看到我们显示导入了spark.implicits包中的所有方法然后通过在RDD之上调用toDF就能轻松创建DataFrame。实际上利用spark.implicits我们甚至可以跳过创建RDD这一步直接通过seq列表来创建DataFrame。
```scala
import spark.implicits._
val dataFrame: DataFrame = seq.toDF
dataFrame.printSchema
/** Schema显示
root
|-- _1: string (nullable = true)
|-- _2: integer (nullable = false)
*/
```
是不是感觉这个方法很简洁、很轻松不过你可能会问“既然有toDF这条捷径一开始干嘛还要花功夫去学步骤繁琐的createDataFrame方法呢
网络上流行过这么一句话“你的岁月静好是有人在背后帮你负重前行。”toDF也是同样的道理我们之所以能用toDF轻松创建DataFrame关键在于spark.implicits这个包提供了各种隐式方法。
隐式方法是Scala语言中一类特殊的函数这类函数不需要开发者显示调用函数体中的计算逻辑在适当的时候会自动触发。正是它们在背后默默地帮我们用seq创建出RDD再用createDataFrame方法把RDD转化为DataFrame。
## 从文件系统创建DataFrame
说完第一类数据源接下来我们再来看看Spark如何从文件系统创建DataFrame。
Spark支持多种文件系统常见的有HDFS、Amazon S3、本地文件系统等等。不过无论哪种文件系统Spark都要通过SparkSession的read API来读取数据并创建DataFrame。所以接下来我们需要先弄明白read API要怎样使用都有哪些注意事项。
read API由SparkSession提供它允许开发者以统一的形式来创建DataFrame如下图所示。
![图片](https://static001.geekbang.org/resource/image/52/43/525441865dede68fa5a9138cb930de43.jpg?wh=1920x654 "read API统一入口")
可以看到要使用read API创建DataFrame开发者只需要调用SparkSession的read方法同时提供3类参数即可。这3类参数分别是文件格式、加载选项和文件路径它们分别由函数format、option和load来指定。
先来看第1类参数文件格式它就是文件的存储格式如CSVComma Separated Values、Text、Parquet、ORC、JSON。Spark SQL支持种类丰富的文件格式除了这里列出的几个例子外Spark SQL还支持像Zip压缩文件、甚至是图片Image格式。
完整的格式支持,你可以参考下图,或是访问[官网给出的列表](https://docs.databricks.com/data/data-sources/index.html)。在后续的讲解中我们还会挑选一些常用的数据格式来演示read API的具体用法。
![图片](https://static001.geekbang.org/resource/image/3c/e2/3c0751be7a5cyya43025cf51f4c7cce2.jpg?wh=1920x406 "read API支持的数据格式")
文件格式决定了第2类参数加载选项的可选集合也就是说不同的数据格式可用的选型有所不同。比如CSV文件格式可以通过option(“header”, true)来表明CSV文件的首行为Data Schema但其他文件格式就没有这个选型。之后讲到常见文件格式用法时我们再对其加载选项做具体讲解。
值得一提的是加载选项可以有零个或是多个当需要指定多个选项时我们可以用“option(选项1, 值1).option(选项2, 值2)”的方式来实现。
read API的第3类参数是文件路径这个参数很好理解它就是文件系统上的文件定位符。比如本地文件系统中的“/dataSources/wikiOfSpark.txt”HDFS分布式文件系统中的“hdfs://hostname:port/myFiles/userProfiles.csv”或是Amazon S3上的“s3://myBucket/myProject/myFiles/results.parquet”等等。
了解了read API的一般用法之后接下来我们结合一些常见的数据格式来进行举例说明。对于那些在这节课没有展开介绍的文件格式你可以参考[官网给出的用法](https://docs.databricks.com/data/data-sources/index.html)来做开发。
### 从CSV创建DataFrame
以可读性好的纯文本方式来存储结构化数据CSV文件格式的身影常见于数据探索、数据分析、机器学习等应用场景。经过上面的分析我们知道要从CSV文件成功地创建DataFrame关键在于了解并熟悉与之有关的加载选项。那么我们就来看看CSV格式都有哪些对应的option它们的含义都是什么。
![图片](https://static001.geekbang.org/resource/image/ba/7d/baa646d5c88322e88376d905573f4a7d.jpg?wh=1920x943 "CSV格式常用的option选项")
从上往下看首先是“header”header的设置值为布尔值也即true或false它用于指定CSV文件的首行是否为列名。如果是的话那么Spark SQL将使用首行的列名来创建DataFrame否则使用“\_c”加序号的方式来命名每一个数据列比如“\_c0”、“\_c1”等等。
对于加载的每一列数据不论数据列本身的含义是什么Spark SQL都会将其视为String类型。例如对于后面这个CSV文件Spark SQL将“name”和“age”两个字段都视为String类型。
```scala
name,age
alice,18
bob,14
```
```scala
import org.apache.spark.sql.DataFrame
val csvFilePath: String = _
val df: DataFrame = spark.read.format("csv").option("header", true).load(csvFilePath)
// df: org.apache.spark.sql.DataFrame = [name: string, age: string]
df.show
/** 结果打印
+-----+---+
| name| age|
+-----+---+
| alice| 18|
| bob| 14|
+-----+---+
*/
```
要想在加载的过程中为DataFrame的每一列指定数据类型我们需要显式地定义Data Schema并在read API中通过调用schema方法来将Schema传递给Spark SQL。Data Schema的定义我们讲createDataFrame函数的时候提过咱们不妨一起来回顾一下。
定义Schema
```scala
import org.apache.spark.sql.types.{StringType, IntegerType, StructField, StructType}
val schema:StructType = StructType( Array(
StructField("name", StringType),
StructField("age", IntegerType)
))
```
调用schema方法来传递Data Schema
```scala
val csvFilePath: String = _
val df: DataFrame = spark.read.format("csv").schema(schema).option("header", true).load(csvFilePath)
// df: org.apache.spark.sql.DataFrame = [name: string, age: int]
```
可以看到在使用schema方法明确了Data Schema以后数据加载完成之后创建的DataFrame类型由原来的“\[name: string, age: string\]”,变为“\[name: string, age: int\]”。需要注意的是,**并不是所有文件格式都需要schema方法来指定Data Schema**因此在read API的一般用法中schema方法并不是必需环节。
![图片](https://static001.geekbang.org/resource/image/52/43/525441865dede68fa5a9138cb930de43.jpg?wh=1920x654 "read API的一般用法")
我们接着说CSV格式的option选项。在“header”之后第二个选项是“seq”它是用于分隔列数据的分隔符可以是任意字符串默认值是逗号。常见的分隔符还有Tab、“|”,等等。
之后的“escape”和“nullValue”分别用于指定文件中的转义字符和空值而“dateFormat”则用于指定日期格式它的设置值是任意可以转换为Java SimpleDateFormat类型的字符串默认值是“yyyy-MM-dd”。
最后一个选项是“mode”它用来指定文件的读取模式更准确地说它明确了Spark SQL应该如何对待CSV文件中的“脏数据”。
所谓脏数据它指的是数据值与预期数据类型不符的数据记录。比如说CSV文件中有一列名为“age”数据它用于记录用户年龄数据类型为整型Int。那么显然age列数据不能出现像“8.5”这样的小数、或是像“8岁”这样的字符串这里的“8.5”或是“8岁”就是我们常说的脏数据。
在不调用schema方法来显示指定Data Schema的情况下Spark SQL将所有数据列都看作是String类型。我们不难发现mode选项的使用往往会与schema方法的调用如影随形。
mode支持3个取值分别是permissive、dropMalformed和failFast它们的含义如下表所示。
![图片](https://static001.geekbang.org/resource/image/ca/af/ca8e9d19dc596b5e61b6f2bccdyy84af.jpg?wh=1920x717 "mode取值与含义")
可以看到除了“failFast”模式以外另外两个模式都不影响DataFrame的创建。以下面的CSV文件为例要想剔除脏数据也就是“cassie, six”这条记录同时正常加载满足类型要求的“干净”数据我们需要同时结合schema方法与mode选项来实现。
CSV文件内容
```scala
name,age
alice,18
bob,14
cassie, six
```
调用schema方法来传递Data Schema
```scala
val csvFilePath: String = _
val df: DataFrame = spark.read.format("csv")
.schema(schema)
.option("header", true)
.option("mode", "dropMalformed")
.load(csvFilePath)
// df: org.apache.spark.sql.DataFrame = [name: string, age: int]
df.show
/** 结果打印
+-----+---+
| name| age|
+-----+---+
| alice| 18|
| bob| 14|
+-----+---+
*/
```
好啦关于从CSV文件创建DataFrame我们就讲完了。不难发现从CSV创建DataFrame过程相对比较繁琐开发者需要注意的细节也很多。不过毕竟CSV简单直接、跨平台、可读性好、应用广泛因此掌握这部分开发技巧还是非常值得的。
### 从Parquet / ORC创建DataFrame
接下来我们就来说说Parquet格式和ORC格式相比从CSV创建DataFrame这两个方法就没那么麻烦了。
Parquet与ORC都是应用广泛的列存Column-based Store文件格式。顾名思义列存是相对行存Row-based Store而言的。
在传统的行存文件格式中,数据记录以行为单位进行存储。虽然这非常符合人类的直觉,但在数据的检索与扫描方面,行存数据往往效率低下。例如,在数据探索、数据分析等数仓应用场景中,我们往往仅需扫描数据记录的某些字段,但在行存模式下,我们必须要扫描全量数据,才能完成字段的过滤。
CSV就是典型的行存数据格式以如下的内容为例如果我们想要统计文件中女生的数量那么我们不得不扫描每一行数据判断gender的取值然后才能决定是否让当前记录参与计数。
CSV文件内容
```plain
name,age,gender
alice,18,female
bob,14,male
```
列存文件则不同,它以列为单位,对数据进行存储,每一列都有单独的文件或是文件块。还是以上面的文件内容为例,如果采用列存格式的话,那么文件的存储方式将会变成下面的样子。
![图片](https://static001.geekbang.org/resource/image/6b/0e/6b97ae414a1ea55e18018b8b056b260e.jpg?wh=1920x880 "列存文件格式示意图")
可以看到数据按列存储想要统计女生的数量我们只需扫描gender列的数据文件而不必扫描name与age字段的数据文件。相比行存列存有利于大幅削减数据扫描所需的文件数量。
不仅如此对于每一个列存文件或是文件块列存格式往往会附加header和footer等数据结构来记录列数据的统计信息比如最大值、最小值、记录统计个数等等。这些统计信息会进一步帮助提升数据访问效率例如对于max=“male”同时min=“male”的gender文件来说在统计女生计数的时候我们完全可以把这样的文件跳过不进行扫描。
再者很多列存格式往往在文件中记录Data Schema比如Parquet和ORC它们会利用Meta Data数据结构来记录所存储数据的数据模式。这样一来在读取类似列存文件时我们无需再像读取CSV一样去手工指定Data Schema这些繁琐的步骤都可以省去。因此使用read API来读取Parquet或是ORC文件就会变得非常轻松如下所示。
使用read API读取Parquet文件
```scala
val parquetFilePath: String = _
val df: DataFrame = spark.read.format("parquet").load(parquetFilePath)
```
使用read API读取ORC文件
```scala
val orcFilePath: String = _
val df: DataFrame = spark.read.format("orc").load(orcFilePath)
```
可以看到在read API的用法中我们甚至不需要指定任何option只要有format和load这两个必需环节即可。是不是非常简单
好啦到此为止我们梳理了如何从文件系统在不同的数据格式下创建DataFrame。在这一讲的最后我们再来简单地了解一下如何从关系型数据库创建DataFrame毕竟这个场景在我们日常的开发中还是蛮常见的。
## 从RDBMS创建DataFrame
使用read API读取数据库就像是使用命令行连接数据库那么简单。而使用命令行连接数据库我们往往需要通过参数来指定数据库驱动、数据库地址、用户名、密码等关键信息。read API也是一样只不过这些参数通通由option选项来指定以MySQL为例read API的使用方法如下。
使用read API连接数据库并创建DataFrame
```scala
spark.read.format("jdbc")
.option("driver", "com.mysql.jdbc.Driver")
.option("url", "jdbc:mysql://hostname:port/mysql")
.option("user", "用户名")
.option("password","密码")
.option("numPartitions", 20)
.option("dbtable", "数据表名 ")
.load()
```
访问数据库我们同样需要format方法来指定“数据源格式”这里的关键字是“jdbc”。请注意由于数据库URL通过option来指定因此调用load方法不再需要传入“文件路径”我们重点来关注option选项的设置。
与命令行一样option选项同样需要driver、url、user、password这些参数来指定数据库连接的常规设置。不过毕竟调用read API的目的是创建DataFrame因此我们还需要指定“dbtable”选项来确定要访问哪个数据表。
有意思的是除了将表名赋值给“dbtable”以外我们还可以把任意的SQL查询语句赋值给该选项这样在数据加载的过程中就能完成数据过滤提升访问效率。例如我们想从users表选出所有的女生数据然后在其上创建DataFrame。
```scala
val sqlQuery: String = select * from users where gender = female’”
spark.read.format("jdbc")
.option("driver", "com.mysql.jdbc.Driver")
.option("url", "jdbc:mysql://hostname:port/mysql")
.option("user", "用户名")
.option("password","密码")
.option("numPartitions", 20)
.option("dbtable", sqlQuery)
.load()
```
此外为了提升后续的并行处理效率我们还可以通过“numPartitions”选项来控制DataFrame的并行度也即DataFrame的Partitions数量。
需要额外注意的是在默认情况下Spark安装目录并没有提供与数据库连接有关的任何Jar包因此对于想要访问的数据库不论是MySQL、PostgreSQL还是Oracle、DB2我们都需要把相关Jar包手工拷贝到Spark安装目录下的Jars文件夹。与此同时我们还要在spark-shell命令或是spark-submit中通过如下两个命令行参数来告诉Spark相关Jar包的访问地址。
* driver-class-path mysql-connector-java-version.jar
* jars mysql-connector-java-version.jar
好啦,到此为止,这一讲的内容就全部讲完啦!今天的内容有点多,我们来一起总结一下。
## 重点回顾
今天这一讲我们聚焦在DataFrame的创建方式上。Spark支持种类丰富的数据源与数据格式我们今天的重点是通过Driver、文件系统和关系型数据库来创建DataFrame。
在Driver端我们可以使用createDataFrame方法来创建DataFrame需要注意的是这种创建方式有两个前提条件。**一是底层RDD的类型必须是RDD\[Row\]二是我们需要手工创建Data Schema**。Schema的创建需要用到StructType、StructField等数据类型你要牢记在心。
```scala
import org.apache.spark.sql.types.{StringType, IntegerType, StructField, StructType}
val schema:StructType = StructType( Array(
StructField("name", StringType),
StructField("age", IntegerType)
))
```
除了这种比较繁琐的方式之外我们还可以利用spark.implicits.\_提供的隐式方法通过在RDD或是原始序列数据之上调用toDF方法轻松创建DataFrame。
接着使用SparkSession的read API我们分别讲解了从CSV、Parquet、ORC和关系型数据库创建DataFrame的一般方法。read API调用的一般方法需要你熟练掌握。
![图片](https://static001.geekbang.org/resource/image/52/43/525441865dede68fa5a9138cb930de43.jpg?wh=1920x654 "read API的一般用法")
由于Parquet、ORC这类列存格式在文件中内置了Data Schema因此访问这类文件格式只有format和load两个方法是必需的。
相比之下读取CSV较为复杂。首先为了指定Data Schema开发者需要额外通过schema方法来输入预定义的数据模式。再者CSV的option选项比较多你可以参考后面的表格来更好地控制CSV数据的加载过程。
![图片](https://static001.geekbang.org/resource/image/ba/7d/baa646d5c88322e88376d905573f4a7d.jpg?wh=1920x943 "CSV格式常用的option选项")
最后我们学习了read API访问RDBMS的一般方法。与命令行的访问方式类似你需要通过多个option选项来指定数据库连接所必需的访问参数如数据库驱动、URL地址、用户名、密码等等。特别地你还可以为“dbtable”选项指定表名或是查询语句对数据的加载过程进行干预和控制。
## 每课一练
给定如下CSV文件请你分别使用permissive, dropMalformed, failFast这3种mode对比read API所创建的DataFrame之间的区别。
```verilog
name,age
alice,18
bob,14
cassie, six
```
欢迎你在留言区跟我交流活动,也推荐你把这一讲的内容分享给更多的同事、朋友,跟他一起学习进步。