Spark 2.2.0 文档中文版 Quick Start 快速开始

原地址:http://spark.apache.org/docs/latest/quick-start.html

  这篇指导对使用Spark提供了一个快速的介绍。我们首先介绍API,通过spark交互式shell(Python或Scala)。然后如何在JAVA、scala、python上写应用程序。

  跟随这篇指导,首先从spark网站上下载一个release。因为我们不使用HDFS,你可以下载任何版本的hadoop。

  注意:在spark2.0之前,主要的编程界面是RDD。在spark2.0之后,RDD被Dataset取代。Dataset很像RDD,但是会有更多的优化,RDD的接口依旧智齿,并且你能够在《RDD编程指导》得到一个更完整的引用。然而,我们非常推荐你使用DataSet,会比RDD有更好的表现。看《SQL编程指导》得到更多关于Dateset的指导。

  spark Shell 的交互分析:

  基础:

  spark shell 提供了一个简单的方式去学习API,同样也是一个非常强大的交互式Dataset分析工具。可以应用在scala(运行与JAVA VM,可以使用现有的JAVA库)、python。在spark目录下运行下面代码开启spark

./bin/spark-shell

  spark首要概念是分布式items收集。Dataset能够从Hadoop输入格式(HDFS)上创建,或者从其他Dataset转化。让我们从spark源文件目录中的README文件中做一个新的Dataset。

scala> val textFile = spark.read.textFile("README.md")
textFile: org.apache.spark.sql.Dataset[String] = [value: string]

  你可以直接从Dataset中获取值,通过使用一些action,或转化dataset为一个新的。详细请读《API doc》。

scala> textFile.count() // Number of items in this Dataset
res0: Long = 126 // May be different from yours as README.md will change over time, similar to other outputs

scala> textFile.first() // First item in this Dataset
res1: String = # Apache Spark

  现在让我们把这个Dataset转化为一个新的。我们用filter返回一个新的Dataset(新的Dataset是原文件条目的子集)

scala> val linesWithSpark = textFile.filter(line => line.contains("Spark"))
linesWithSpark: org.apache.spark.sql.Dataset[String] = [value: string]

  我们可以连接转化(transformation)和行动(actions)

scala> textFile.filter(line => line.contains("Spark")).count() // How many lines contain "Spark"?
res3: Long = 15

 

  更多的dataset操作

  Dataset的action和transformtion可以用来做更复杂的计算任务。找出单词数最多的那一行:

scala> textFile.map(line => line.split(" ").size).reduce((a, b) => if (a > b) a else b)
res4: Long = 15

  第一个map是得到一个整数,创建一个新的Dataset,reduce用来找最大的单词数。他们的参数是scala函数,你可以使用scala,java。例如,我们可以在任何地方简单地公开调用函数。我们使用Math.max函数让这段胆码更容易理解。

scala> import java.lang.Math
import java.lang.Math

scala> textFile.map(line => line.split(" ").size).reduce((a, b) => Math.max(a, b))
res5: Int = 15

  一个常见的数据流模式叫做MapReduce,因Hadoop而普及。spark可以很简单地继承MapReduce:

scala> val wordCounts = textFile.flatMap(line => line.split(" ")).groupByKey(identity).count()
wordCounts: org.apache.spark.sql.Dataset[(String, Long)] = [value: string, count(1): bigint]

  在这里,我们调用flatmap图转化一个行Dataset为一个单词Dataset,然后结合groupByKey和count去计算每个单词在文件中出现的次数,使用pair。收集单词数,使用:

scala> wordCounts.collect()
res6: Array[(String, Int)] = Array((means,1), (under,2), (this,3), (Because,1), (Python,2), (agree,1), (cluster.,1), ...)

  

  缓冲:

  spark同样支持把数据放在集群内存的缓存里,当数据重复被存取的时候这非常有用,比如查询一个很火的dataset,或者跑一些迭代算法(PageRank等)。举一个简单例子,我们把linesWithSpark 放进缓存。

scala> linesWithSpark.cache()
res7: linesWithSpark.type = [value: string]

scala> linesWithSpark.count()
res8: Long = 15

scala> linesWithSpark.count()
res9: Long = 15

  用spark浏览和缓存100行的文本看起来很愚蠢,有趣的是这些相同的函数被使用在一个非常大的数据集,甚至跨越数十数百个节点。你同样跨越使用 bin/spark-shell 连接集群,正如RDD编程中的描述。

 

  独立程序:

  假设我们希望用sparkAPI写一个独立程序,我们将通过一个简单的程序java(Maven)

  这个例子将使用Maven去编译一个应用jar,任何类似的build系统也都能工作。

  我们将创建一个非常简单的spark应用。SimpleApp.java

/* SimpleApp.java */
import org.apache.spark.sql.SparkSession;

public class SimpleApp {
  public static void main(String[] args) {
    String logFile = "YOUR_SPARK_HOME/README.md"; // Should be some file on your system
    SparkSession spark = SparkSession.builder().appName("Simple Application").getOrCreate();
    Dataset<String> logData = spark.read.textFile(logFile).cache();

    long numAs = logData.filter(s -> s.contains("a")).count();
    long numBs = logData.filter(s -> s.contains("b")).count();

    System.out.println("Lines with a: " + numAs + ", lines with b: " + numBs);

    spark.stop();
  }
}

   这个程序只是计算了包含‘a’的行的数量和包含‘b’的行的数量,在Spark的README中。注意你需要替换YOURS_SPARK_HOME为你本地spark安装的地方。不像前面spark-shell的例子(初始化自己SparkSession),我们初始化一个SparkSession作为程序的一部分。

  去build这个程序,我们也需要写一个Maven-pom.xml文件列出spark是一个依赖。注意spark要人工标出scala的版本。

<project>
  <groupId>edu.berkeley</groupId>
  <artifactId>simple-project</artifactId>
  <modelVersion>4.0.0</modelVersion>
  <name>Simple Project</name>
  <packaging>jar</packaging>
  <version>1.0</version>
  <dependencies>
    <dependency> <!-- Spark dependency -->
      <groupId>org.apache.spark</groupId>
      <artifactId>spark-sql_2.11</artifactId>
      <version>2.2.0</version>
    </dependency>
  </dependencies>
</project>

  我们通过标准的Maven目录结构来展示这些文件

$ find .
./pom.xml
./src
./src/main
./src/main/java
./src/main/java/SimpleApp.java

 

  下一步:

  祝贺你运行了第一个你的spark应用

  --一个深入的API概述,请开始《RDD编程指导》和《SQL编程指导》,或者看其他部分“编程指导”菜单。

  --在集群上跑程序,请看《部署概述》

  --最后,spark包含了一些样例在example目录下(scala,java,python,R),你可以这样运行他们

# For Scala and Java, use run-example:
./bin/run-example SparkPi

 

posted @ 2017-07-18 16:38  fdu_taoshiqian  阅读(970)  评论(0编辑  收藏  举报