Spark Note – 编程指南
- WBOY原创
- 2016-06-07 16:38:171198浏览
Spark Note – 编程指南. Spark中的基本概念 在Spark中，有下面的基本概念。 Application:基于Spark的用户程序，包含了一个driver program和集群中多个executor Driver Program：运行Application的main()函数并创建SparkContext。通常SparkContext代表driver program Executor：为
在Spark中，有下面的基本概念。
Application:基于Spark的用户程序，包含了一个driver program和集群中多个executor
Driver Program：运行Application的main()函数并创建SparkContext。通常SparkContext代表driver program
Executor：为某Application运行在worker node上的饿一个进程。该进程负责运行Task，并负责将数据存在内存或者磁盘上。每个Application都有自己独立的executors
Cluster Manager: 在集群上获得资源的外部服务（例如 Spark Standalon，Mesos、Yarn）
Worker Node: 集群中任何可运行Application代码的节点
Task：被送到executor上执行的工作单元。
Job：可以被拆分成Task并行计算的工作单元，一般由Spark Action触发的一次执行作业。
Stage：每个Job会被拆分成很多组Task，每组任务被称为stage，也可称TaskSet。该术语可以经常在日志中看打。
RDD：Spark的基本计算单元，通过Scala集合转化、读取数据集生成或者由其他RDD经过算子操作得到。
客户Spark程序（Driver Program）来操作Spark集群是通过SparkContext对象来进行，SparkContext作为一个操作和调度的总入口，在初始化过程中集群管理器会创建DAGScheduler作业调度和TaskScheduler任务调度(For Spark Standalone，而在Spark On Yarn中，TaskScheduler会被YARN代替)。
DAGScheduler作业调度模块是基于Stage的高层调度模块(参考：Spark分析之DAGScheduler)，DAG全称 Directed Acyclic Graph，有向无环图。简单的来说，就是一个由顶点和有方向性的边构成的图中，从任意一个顶点出发，没有任何一条路径会将其带回到出发的顶点。它为每个Spark Job计算具有依赖关系的多个Stage任务阶段（通常根据Shuffle来划分Stage，如groupByKey, reduceByKey等涉及到shuffle的transformation就会产生新的stage），然后将每个Stage划分为具体的一组任务，以TaskSets的形式提交给底层的任务调度模块来具体执行。其中，不同stage之前的RDD为宽依赖关系。 TaskScheduler任务调度模块负责具体启动任务，监控和汇报任务运行情况。
创建SparkContext一般要经过下面几个步骤：
a). 导入Spark的类和隐式转换
import org.apache.spark.{SparkContext, SparkConf}
import org.apache.spark.SparkContext._
b). 构建Spark应用程序的应用信息对象SparkConf
val conf = new SparkConf().setAppName(appName).setMaster(master_url)
c). 利用SparkConf对象来初始化SparkContext
val sc = new SparkContext(conf)
d). 创建RDD、并执行相应的Transformation和action并得到最终结果。
e). 关闭Context
在完成应用的设计和编写后，使用spark-submit来提交应用的jar包。spark-submit的命令行参考如下：
Submitting Applications
./bin/spark-submit \ --class --master \ --deploy-mode \ ... # other options \ [application-arguments]
Spark的运行模式取决于传递给SparkContext的MASTER环境变量的值。master URL可以是以下任一种形式：
Master URL 含义
local 使用一个Worker线程本地化运行SPARK(完全不并行)
local[*] 使用逻辑CPU个数数量的线程来本地化运行Spark
local[K] 使用K个Worker线程本地化运行Spark（理想情况下，K应该根据运行机器的CPU核数设定）
spark://HOST:PORT 连接到指定的Spark standalone master。默认端口是7077.
yarn-client 以客户端模式连接YARN集群。集群的位置可以在HADOOP_CONF_DIR 环境变量中找到。
yarn-cluster 以集群模式连接YARN集群。集群的位置可以在HADOOP_CONF_DIR 环境变量中找到。
mesos://HOST:PORT 连接到指定的Mesos集群。默认接口是5050.
而spark-shell会在启动的时候自动构建SparkContext，名称为sc。
Spark所有的操作都围绕弹性分布式数据集（RDD）进行，这是一个有容错机制并可以被并行操作的元素集合，具有只读、分区、容错、高效、无需物化、可以缓存、RDD依赖等特征。目前有两种类型的基础RDD：并行集合（Parallelized Collections）：接收一个已经存在的Scala集合，然后进行各种并行计算。 Hadoop数据集（Hadoop Datasets）：在一个文件的每条记录上运行函数。只要文件系统是HDFS，或者hadoop支持的任意存储系统即可。 这两种类型的RDD都可以通过相同的方式进行操作，从而获得子RDD等一系列拓展，形成lineage血统关系图。
(Spark Note – 编程指南). 并行化集合
并行化集合是通过调用SparkContext的parallelize方法，在一个已经存在的Scala集合上创建的（一个Seq对象）。集合的对象将会被拷贝，创建出一个可以被并行操作的分布式数据集。例如，下面的解释器输出，演示了如何从一个数组创建一个并行集合。
例如：val rdd = sc.parallelize(Array(Spark Note – 编程指南 to Spark Note – 编程指南0)) 根据能启动的executor的数量来进行切分多个slice，每一个slice启动一个Task来进行处理。
val rdd = sc.parallelize(Array(Spark Note – 编程指南 to Spark Note – 编程指南0), 5) 指定了partition的数量
(Spark Note – 编程指南). Hadoop数据集
Spark可以将任何Hadoop所支持的存储资源转化成RDD,如本地文件（需要网络文件系统，所有的节点都必须能访问到）、HDFS、Cassandra、HBase、Amazon SSpark Note – 编程指南等，Spark支持文本文件、SequenceFiles和任何Hadoop InputFormat格式。
a). 使用textFile()方法可以将本地文件或HDFS文件转换成RDD
支持整个文件目录读取，文件可以是文本或者压缩文件(如gzip等，自动执行解压缩并加载数据)。如textFile（Spark Note – 编程指南Spark Note – 编程指南Spark Note – 编程指南;file:///dfs/dataSpark Note – 编程指南Spark Note – 编程指南Spark Note – 编程指南;）
支持通配符读取,例如：
val rddSpark Note – 编程指南 = sc.textFile("file:///root/access_log/access_log*.filter");
val rddSpark Note – 编程指南=rddSpark Note – 编程指南.map(_.split("\t")).filter(_.length==6)
rddSpark Note – 编程指南.count()
......
Spark Note – 编程指南4/08/Spark Note – 编程指南0 Spark Note – 编程指南4:44:48 INFO HadoopRDD: Input split: file:/root/access_log/access_log.Spark Note – 编程指南00806Spark Note – 编程指南Spark Note – 编程指南.decode.filter:Spark Note – 编程指南Spark Note – 编程指南4Spark Note – 编程指南Spark Note – 编程指南77Spark Note – 编程指南8+Spark Note – 编程指南070590Spark Note – 编程指南
......
textFile()可选第二个参数slice，默认情况下为每一个block分配一个slice。用户也可以通过slice指定更多的分片，但不能使用少于HDFS block的分片数。
b). 使用wholeTextFiles()读取目录里面的小文件，返回（用户名、内容）对
c). 使用sequenceFile[K,V]()方法可以将SequenceFile转换成RDD。SequenceFile文件是Hadoop用来存储二进制形式的key-value对而设计的一种平面文件(Flat File)。
d). 使用SparkContext.hadoopRDD方法可以将其他任何Hadoop输入类型转化成RDD使用方法。一般来说，HadoopRDD中每一个HDFS block都成为一个RDD分区。
此外，通过Transformation可以将HadoopRDD等转换成FilterRDD(依赖一个父RDD产生）和JoinedRDD（依赖所有父RDD）等。
RDD支持两类操作：
转换（transformation）现有的RDD通关转换生成一个新的RDD，转换是延时执行（lazy）的。
动作（actions）在RDD上运行计算后，返回结果给驱动程序或写入文件系统。
例如，map就是一种transformation，它将数据集每一个元素都传递给函数，并返回一个新的分布数据集表示结果。reduce则是一种action，通过一些函数将所有的元素叠加起来，并将最终结果返回给Driver程序。
(Spark Note – 编程指南). map(func)
Return a new distributed dataset formed by passing each element of the source through a function func.
返回一个新分布式数据集，由每一个输入元素经过func函数转换后组成
(Spark Note – 编程指南). filter(func)
Return a new dataset formed by selecting those elements of the source on which func returns true.
返回一个新数据集，由经过func函数计算后返回值为true的输入元素组成
Test:
val num=sc.parallelize(Spark Note – 编程指南 to Spark Note – 编程指南00) val numSpark Note – 编程指南 = num.map(_*Spark Note – 编程指南) val numSpark Note – 编程指南 = numSpark Note – 编程指南.filter(_ % Spark Note – 编程指南 == 0) ...... numSpark Note – 编程指南.collect //res: Array[Int] = Array(6, Spark Note – 编程指南Spark Note – 编程指南, Spark Note – 编程指南8, Spark Note – 编程指南4, Spark Note – 编程指南0, Spark Note – 编程指南6, 4Spark Note – 编程指南, 48, 54, 60, 66, 7Spark Note – 编程指南, 78, 84, 90, 96, Spark Note – 编程指南0Spark Note – 编程指南, Spark Note – 编程指南08, Spark Note – 编程指南Spark Note – 编程指南4, Spark Note – 编程指南Spark Note – 编程指南0, Spark Note – 编程指南Spark Note – 编程指南6, Spark Note – 编程指南Spark Note – 编程指南Spark Note – 编程指南, Spark Note – 编程指南Spark Note – 编程指南8, Spark Note – 编程指南44, Spark Note – 编程指南50, Spark Note – 编程指南56, Spark Note – 编程指南6Spark Note – 编程指南, Spark Note – 编程指南68, Spark Note – 编程指南74, Spark Note – 编程指南80, Spark Note – 编程指南86, Spark Note – 编程指南9Spark Note – 编程指南, Spark Note – 编程指南98) numSpark Note – 编程指南.toDebugString //res5: String = //FilteredRDD[Spark Note – 编程指南0] at filter at :Spark Note – 编程指南6 (48 partitions) // MappedRDD[Spark Note – 编程指南9] at map at :Spark Note – 编程指南4 (48 partitions) // ParallelCollectionRDD[Spark Note – 编程指南8] at parallelize at :Spark Note – 编程指南Spark Note – 编程指南 (48 partitions)
(Spark Note – 编程指南). flatMap(func)
Similar to map, but each input item can be mapped to 0 or more output items (so func should return a Seq rather than a single item).
类似于map，但是每一个输入元素可以被映射为0或多个输出元素（因此func应该返回一个序列，而不是单一元素）
Test:
val kv=sc.parallelize(List(List(Spark Note – 编程指南,Spark Note – 编程指南),List(Spark Note – 编程指南,4),List(Spark Note – 编程指南,6,8)))
kv.flatMap(x=>x.map(_+Spark Note – 编程指南)).collect
//res0: Array[Int] = Array(Spark Note – 编程指南, Spark Note – 编程指南, 4, 5, 4, 7, 9)
//Word Count
sc.textFile('hdfs://hdp0Spark Note – 编程指南:9000/home/debugo/*.txt').flatMap(_.split(' ')).map((_,Spark Note – 编程指南)).reduceByKey(_+_)
(4). mapPartitions(func)
Similar to map, but runs separately on each partition (block) of the RDD, so func must be of type Iterator
类似于map，但独立地在RDD的每一个分块上运行，因此在类型为T的RDD上运行时，func的函数类型必须是Iterator[T] => Iterator[U]。mapPartitions将会被每一个数据集分区调用一次。各个数据集分区的全部内容将作为顺序的数据流传入函数func的参数中，func必须返回另一个Iterator[T]。被合并的结果自动转换成为新的RDD。下面的测试中，元组(Spark Note – 编程指南,4)和(6,7)将由于我们选择的分区策略和方法而消失。
The combined result iterators are automatically converted into a new RDD. Please note, that the tuples (Spark Note – 编程指南,4) and (6,7) are missing from the following result due to the partitioning we chose
Test:
val nums = sc . parallelize (Spark Note – 编程指南 to 9 , Spark Note – 编程指南)
def myfunc[T] ( iter : Iterator [T] ) : Iterator [( T , T ) ] = {
var res = List [(T , T) ]()
var pre = iter.next
while ( iter.hasNext )
{
val cur = iter . next ;
res .::= ( pre , cur )
pre = cur ;
}
res . iterator
}
//myfunc: [T](iter: Iterator[T])Iterator[(T, T)]
nums.mapPartitions(myfunc).collect
//resSpark Note – 编程指南Spark Note – 编程指南: Array[(Int, Int)] = Array((Spark Note – 编程指南,Spark Note – 编程指南), (Spark Note – 编程指南,Spark Note – 编程指南), (5,6), (4,5), (8,9), (7,8))
(5). mapPartitionsWithIndex(func)
Similar to mapPartitions, but also provides func with an integer value representing the index of the partition, so func must be of type (Int, Iterator
类似于mapPartitions, 其函数原型是：
def mapPartitionsWithIndex [ U : ClassTag ]( f : ( Int , Iterator [ T ]) => Iterator [ U ] , preservesPartitioning : Boolean = false ) : RDD [ U ]，
mapPartitionsWithIndex的func接受两个参数，第一个参数是分区的索引，第二个是一个数据集分区的迭代器。而输出的是一个包含经过该函数转换的迭代器。下面测试中，将分区索引和分区数据一起输出。
Test:
val x = sc . parallelize ( List (Spark Note – 编程指南 ,Spark Note – 编程指南 ,Spark Note – 编程指南 ,4 ,5 ,6 ,7 ,8 ,9 ,Spark Note – 编程指南0) , Spark Note – 编程指南)
def myfunc ( index : Int , iter : Iterator [ Int ]) : Iterator [ String ] = {
iter . toList . map ( x => index + "-" + x ) . iterator
}
//myfunc: (index: Int, iter: Iterator[Int])Iterator[String]
x . mapPartitionsWithIndex ( myfunc ) . collect()
res: Array[String] = Array(0-Spark Note – 编程指南, 0-Spark Note – 编程指南, 0-Spark Note – 编程指南, Spark Note – 编程指南-4, Spark Note – 编程指南-5, Spark Note – 编程指南-6, Spark Note – 编程指南-7, Spark Note – 编程指南-8, Spark Note – 编程指南-9, Spark Note – 编程指南-Spark Note – 编程指南0)
(6). sample(withReplacement,fraction, seed)
Sample a fraction fraction of the data, with or without replacement, using a given random number generator seed.
根据fraction指定的比例，对数据进行采样，可以选择是否用随机数进行替换，seed用于指定随机数生成器种子。
val a = sc . parallelize (Spark Note – 编程指南 to Spark Note – 编程指南0000 , Spark Note – 编程指南) a . sample ( false , 0.Spark Note – 编程指南 , 0) . count res0 : Long = 960 a . sample ( true , 0.7 , scala.util.Random.nextInt(Spark Note – 编程指南0000)) . count resSpark Note – 编程指南: Long = 707Spark Note – 编程指南
(7). union(otherDataset)
Return a new dataset that contains the union of the elements in the source dataset and the argument.
返回一个新的数据集，新数据集是由源数据集和参数数据集联合而成。
(8). intersection(otherDataset)
Return a new RDD that contains the intersection of elements in the source dataset and the argument.
(9). distinct([numTasks]))
Return a new dataset that contains the distinct elements of the source dataset.
返回一个包含源数据集中所有不重复元素的新数据集
Test:
val kvSpark Note – 编程指南=sc.parallelize(List(("A",Spark Note – 编程指南),("B",Spark Note – 编程指南),("C",Spark Note – 编程指南),("A",4),("B",5)))
val kvSpark Note – 编程指南=sc.parallelize(List(("A",4),("A", Spark Note – 编程指南),("C",Spark Note – 编程指南),("A",4),("B",5)))
kvSpark Note – 编程指南.distinct.collect
res0: Array[(String, Int)] = Array((A,4), (C,Spark Note – 编程指南), (B,5), (A,Spark Note – 编程指南))
kvSpark Note – 编程指南.union(kvSpark Note – 编程指南).collect
resSpark Note – 编程指南: Array[(String, Int)] = Array((A,Spark Note – 编程指南), (B,Spark Note – 编程指南), (C,Spark Note – 编程指南), (A,4), (B,5), (A,4), (A,Spark Note – 编程指南), (C,Spark Note – 编程指南), (A,4), (B,5))
kvSpark Note – 编程指南.union(kvSpark Note – 编程指南).collect.distinct
resSpark Note – 编程指南: Array[(String, Int)] = Array((A,Spark Note – 编程指南), (B,Spark Note – 编程指南), (C,Spark Note – 编程指南), (A,4), (B,5), (A,Spark Note – 编程指南))
kvSpark Note – 编程指南.intersection(kvSpark Note – 编程指南).collect
res4Spark Note – 编程指南: Array[(String, Int)] = Array((A,4), (C,Spark Note – 编程指南), (B,5))
(Spark Note – 编程指南0.)groupByKey([numTasks])
When called on a dataset of (K, V) pairs, returns a dataset of (K, Iterable
Note: If you are grouping in order to perform an aggregation (such as a sum or average) over each key, using reduceByKey or combineByKey will yield much better performance.
Note: By default, the level of parallelism in the output depends on the number of partitions of the parent RDD. You can pass an optional numTasks argument to set a different number of tasks.
在一个（K,V）对的数据集上调用，返回一个（K，Seq[V])对的数据集
注意：默认情况下，只有8个并行任务来做操作，但是你可以传入一个可选的numTasks参数来改变它。如果分组是用来计算聚合操作（如sum或average），那么应该使用reduceByKey 或combineByKey 来提供更好的性能。
groupByKey, reduceByKey等transformation操作涉及到了shuffle操作，所以这里引出两个概念宽依赖和窄依赖。
窄依赖(narrow dependencies)
子RDD的每个分区依赖于常数个父分区（与数据规模无关）
输入输出一对一的算子，且结果RDD的分区结构不变。主要是map/flatmap
输入输出一对一的算子，但结果RDD的分区结构发生了变化，如union/coalesce
从输入中选择部分元素的算子，如filter、distinct、substract、sample
宽依赖(wide dependencies)
子RDD的每个分区依赖于所有的父RDD分区
对单个RDD基于key进行重组和reduce，如groupByKey，reduceByKey
对两个RDD基于key进行join和重组，如join
经过大量shuffle生成的RDD，建议进行缓存。这样避免失败后重新计算带来的开销。
注意：reduce是一个action，和reduceByKey完全不同。
(Spark Note – 编程指南Spark Note – 编程指南).reduceByKey(func, [numTasks])
When called on a dataset of (K, V) pairs, returns a dataset of (K, V) pairs where the values for each key are aggregated using the given reduce function func, which must be of type (V,V) => V. Like ingroupByKey, the number of reduce tasks is configurable through an optional second argument.
在一个（K，V)对的数据集上调用时，返回一个（K，V）对的数据集，使用指定的reduce函数，将相同key的值聚合到一起。类似groupByKey，reduce任务个数是可以通过第二个可选参数来配置的
(Spark Note – 编程指南Spark Note – 编程指南).sortByKey([ascending], [numTasks])
When called on a dataset of (K, V) pairs where K implements Ordered, returns a dataset of (K, V) pairs sorted by keys in ascending or descending order, as specified in the boolean ascending argument.
在一个（K，V)对的数据集上调用，K必须实现Ordered接口，返回一个按照Key进行排序的（K，V）对数据集。升序或降序由ascending布尔参数决定
Test:
val kvSpark Note – 编程指南=sc.parallelize(List(("A",Spark Note – 编程指南),("B",Spark Note – 编程指南),("C",Spark Note – 编程指南),("A",4),("B",5)))
res0: Array[(String, Int)] = Array((A,Spark Note – 编程指南), (A,4), (B,Spark Note – 编程指南), (B,5), (C,Spark Note – 编程指南))
kvSpark Note – 编程指南.sortByKey().collect //注意sortByKey的小括号不能省
resSpark Note – 编程指南: Array[(String, Int)] = Array((A,Spark Note – 编程指南), (A,4), (B,Spark Note – 编程指南), (B,5), (C,Spark Note – 编程指南))
kvSpark Note – 编程指南.groupByKey().collect
resSpark Note – 编程指南: Array[(String, Iterable[Int])] = Array((A,ArrayBuffer(Spark Note – 编程指南, 4)), (B,ArrayBuffer(Spark Note – 编程指南, 5)), (C,ArrayBuffer(Spark Note – 编程指南)))
kvSpark Note – 编程指南.reduceByKey(_+_).collect
resSpark Note – 编程指南: Array[(String, Int)] = Array((A,5), (B,7), (C,Spark Note – 编程指南))
(Spark Note – 编程指南Spark Note – 编程指南). join(otherDataset, [numTasks])
When called on datasets of type (K, V) and (K, W), returns a dataset of (K, (V, W)) pairs with all pairs of elements for each key. Outer joins are also supported through leftOuterJoin and rightOuterJoin.
在类型为（K,V)和（K,W)类型的数据集上调用时，返回一个相同key对应的所有元素对在一起的(K, (V, W))数据集
(Spark Note – 编程指南4).cogroup(otherDataset, [numTasks])
When called on datasets of type (K, V) and (K, W), returns a dataset of (K, Iterable
在类型为（K,V)和（K,W)的数据集上调用，返回一个 (K, Seq[V], Seq[W])元组的数据集。这个操作也可以称之为groupwith
Test:
val kvSpark Note – 编程指南=sc.parallelize(List(("A",Spark Note – 编程指南),("B",Spark Note – 编程指南),("C",Spark Note – 编程指南),("A",4),("B",5)))
val kvSpark Note – 编程指南=sc.parallelize(List(("A",Spark Note – 编程指南0),("B",Spark Note – 编程指南0),("D",Spark Note – 编程指南0)))
kvSpark Note – 编程指南.join(kvSpark Note – 编程指南).collect
resSpark Note – 编程指南6: Array[(String, (Int, Int))] = Array((A,(Spark Note – 编程指南,Spark Note – 编程指南0)), (A,(4,Spark Note – 编程指南0)), (B,(Spark Note – 编程指南,Spark Note – 编程指南0)), (B,(5,Spark Note – 编程指南0)))
kvSpark Note – 编程指南.cogroup(kvSpark Note – 编程指南).collect
res0: Array[(String, (Iterable[Int], Iterable[Int]))] = Array((A,(ArrayBuffer(Spark Note – 编程指南, 4),ArrayBuffer(Spark Note – 编程指南0))), (B,(ArrayBuffer(Spark Note – 编程指南, 5),ArrayBuffer(Spark Note – 编程指南0))), (C,(ArrayBuffer(Spark Note – 编程指南),ArrayBuffer())), (D,(ArrayBuffer(),ArrayBuffer(Spark Note – 编程指南0))))
(Spark Note – 编程指南5).cartesian(otherDataset)
When called on datasets of types T and U, returns a dataset of (T, U) pairs (all pairs of elements).
笛卡尔积，在类型为 T 和 U 类型的数据集上调用时，返回一个 (T, U)对数据集(两两的元素对)
(Spark Note – 编程指南6). pipe(command, [envVars])
Pipe each partition of the RDD through a shell command, e.g. a Perl or bash script. RDD elements are written to the processSpark Note – 编程指南Spark Note – 编程指南7;s stdin and lines output to its stdout are returned as an RDD of strings.
通过POSIX 管道来将每个RDD分区的数据传入一个shell命令（例如Perl或bash脚本）。RDD元素会写入到进程的标准输入，其标准输出会作为RDD字符串返回。
(Spark Note – 编程指南7).coalesce(numPartitions)
Decrease the number of partitions in the RDD to numPartitions. Useful for running operations more efficiently after filtering down a large dataset.
将RDD分区的数量降低为numPartitions，对于经过过滤后的大数据集的在线处理更加有效。
(Spark Note – 编程指南8).repartition(numPartitions)
Reshuffle the data in the RDD randomly to create either more or fewer partitions and balance it across them. This always shuffles all data over the network.
随机重新shuffle RDD中的数据，并创建numPartitions个分区。这个操作总会通过网络来shuffle全部数据。
(Spark Note – 编程指南9). reduce(func)
Aggregate the elements of the dataset using a function func (which takes two arguments and returns one). The function should be commutative and associative so that it can be computed correctly in parallel.
通过函数func（接受两个参数，返回一个参数）聚集数据集中的所有元素。这个功能必须可交换且可关联的，从而可以正确的被并行执行。
(Spark Note – 编程指南0). collect()
Return all the elements of the dataset as an array at the driver program. This is usually useful after a filter or other operation that returns a sufficiently small subset of the data.
在驱动程序中，以数组的形式，返回数据集的所有元素。这通常会在使用filter或者其它操作并返回一个足够小的数据子集后再使用会比较有用。
(Spark Note – 编程指南Spark Note – 编程指南). count()
Return the number of elements in the dataset.
返回数据集的元素的个数。
(Spark Note – 编程指南Spark Note – 编程指南). first()
Return the first element of the dataset (similar to take(Spark Note – 编程指南)).
返回数据集的第一个元素（类似于take（Spark Note – 编程指南））
(Spark Note – 编程指南Spark Note – 编程指南). take(n)
Return an array with the first n elements of the dataset. Note that this is currently not executed in parallel. Instead, the driver program computes all the elements.
返回一个由数据集的前n个元素组成的数组。注意，这个操作目前并非并行执行，而是由驱动程序计算所有的元素
(Spark Note – 编程指南4). countByKey()
Only available on RDDs of type (K, V). Returns a hashmap of (K, Int) pairs with the count of each key.
对(K,V)类型的RDD有效，返回一个(K，Int)对的Map，表示每一个key对应的元素个数
(Spark Note – 编程指南5). foreach(func)
Run a function func on each element of the dataset. This is usually done for side effects such as updating an accumulator variable (see below) or interacting with external storage systems.
在数据集的每一个元素上，运行函数func进行更新。这通常用于边缘效果，例如更新一个累加器，或者和外部存储系统进行交互，例如HBase.
Test:
val num=sc.parallelize(Spark Note – 编程指南 to Spark Note – 编程指南0)
num.reduce (_ + _)
resSpark Note – 编程指南: Int = 55
num.take(5)
resSpark Note – 编程指南: Array[Int] = Array(Spark Note – 编程指南, Spark Note – 编程指南, Spark Note – 编程指南, 4, 5)
num.first
resSpark Note – 编程指南: Int = Spark Note – 编程指南
num.count
res4: Long = Spark Note – 编程指南0
num.take(5).foreach(println)
Spark Note – 编程指南
Spark Note – 编程指南
Spark Note – 编程指南
4
5
val kvSpark Note – 编程指南=sc.parallelize(List(("A",Spark Note – 编程指南),("B",Spark Note – 编程指南),("C",Spark Note – 编程指南),("A",4),("B",5),("A",7),("B",7)))
val kvSpark Note – 编程指南_count=kvSpark Note – 编程指南.countByKey()
kvSpark Note – 编程指南_count: scala.collection.Map[String,Long] = Map(A -> Spark Note – 编程指南, C -> Spark Note – 编程指南, B -> Spark Note – 编程指南)
(Spark Note – 编程指南6). takeSample(withReplacement,num, seed)
Return an array with a random sample of num elements of the dataset, with or without replacement, using the given random number generator seed.
返回一个数组，在数据集中随机采样num个元素组成，可以选择是否用随机数替换不足的部分，Seed用于指定的随机数生成器种子
(Spark Note – 编程指南7). takeOrdered(n, [ordering])
Return the first n elements of the RDD using either their natural order or a custom comparator.
返回一个由数据集的前n个元素组成的有序数组，使用自然序或自定义的比较器。
(Spark Note – 编程指南8). saveAsTextFile(path)
Write the elements of the dataset as a text file (or set of text files) in a given directory in the local filesystem, HDFS or any other Hadoop-supported file system. Spark will call toString on each element to convert it to a line of text in the file.
将数据集的元素，以textfile的形式，保存到本地文件系统，HDFS或者任何其它hadoop支持的文件系统。对于每个元素，Spark将会调用toString方法，将它转换为文件中的文本行
(Spark Note – 编程指南9). saveAsSequenceFile(path)
Write the elements of the dataset as a Hadoop SequenceFile in a given path in the local filesystem, HDFS or any other Hadoop-supported file system. This is available on RDDs of key-value pairs that either implement HadoopSpark Note – 编程指南Spark Note – 编程指南7;s Writable interface. In Scala, it is also available on types that are implicitly convertible to Writable (Spark includes conversions for basic types like Int, Double, String, etc).
将数据集的元素，以Hadoop sequencefile的格式，保存到指定的目录下，本地系统，HDFS或者任何其它hadoop支持的文件系统。这个只限于由key-value对组成，并实现了Hadoop的Writable接口，或者隐式的可以转换为Writable的RDD。（Spark包括了基本类型的转换，例如Int，Double，String，等等）
(Spark Note – 编程指南0). saveAsObjectFile(path)
Write the elements of the dataset in a simple format using Java serialization, which can then be loaded usingSparkContext.objectFile().
将数据集元素写入Java序列化的可以被SparkContext.objectFile()加载的简单格式中。
当然,transformation和action的操作远远不止这些。其他请参考API文档:
RDD API
Spark可以使用 persist 和 cache 方法将任意 RDD 缓存到内存、磁盘文件系统中。缓存是容错的，如果一个 RDD 分片丢失，可以通过构建它的 transformation自动重构。被缓存的 RDD 被使用的时，存取速度会被大大加速。一般的executor内存60%做 cache， 剩下的40%做task。
Spark中，RDD类可以使用cache() 和 persist() 方法来缓存。cache()是persist()的特例，将该RDD缓存到内存中。而persist可以指定一个StorageLevel。StorageLevel的列表可以在StorageLevel 伴生单例对象中找到：
object StorageLevel {
val NONE = new StorageLevel(false, false, false, false)
val DISK_ONLY = new StorageLevel(true, false, false, false)
val DISK_ONLY_Spark Note – 编程指南 = new StorageLevel(true, false, false, false, Spark Note – 编程指南)
val MEMORY_ONLY = new StorageLevel(false, true, false, true)
val MEMORY_ONLY_Spark Note – 编程指南 = new StorageLevel(false, true, false, true, Spark Note – 编程指南)
val MEMORY_ONLY_SER = new StorageLevel(false, true, false, false)
val MEMORY_ONLY_SER_Spark Note – 编程指南 = new StorageLevel(false, true, false, false, Spark Note – 编程指南)
val MEMORY_AND_DISK = new StorageLevel(true, true, false, true)
val MEMORY_AND_DISK_Spark Note – 编程指南 = new StorageLevel(true, true, false, true, Spark Note – 编程指南)
val MEMORY_AND_DISK_SER = new StorageLevel(true, true, false, false)
val MEMORY_AND_DISK_SER_Spark Note – 编程指南 = new StorageLevel(true, true, false, false, Spark Note – 编程指南)
val OFF_HEAP = new StorageLevel(false, false, true, false) // Tachyon
}
// 其中，StorageLevel 类的构造器参数如下：
class StorageLevel private( private var useDisk_ : Boolean, private var useMemory_ : Boolean, private var useOffHeap_ : Boolean, private var deserialized_ : Boolean, private var replication_ : Int = Spark Note – 编程指南)
Spark的不同StorageLevel ，目的满足内存使用和CPU效率权衡上的不同需求。我们建议通过以下的步骤来进行选择：
·如果你的RDDs可以很好的与默认的存储级别(MEMORY_ONLY)契合，就不需要做任何修改了。这已经是CPU使用效率最高的选项，它使得RDDs的操作尽可能的快。
·如果不行，试着使用MEMORY_ONLY_SER并且选择一个快速序列化的库使得对象在有比较高的空间使用率的情况下，依然可以较快被访问。
·尽可能不要存储到硬盘上，除非计算数据集的函数，计算量特别大，或者它们过滤了大量的数据。否则，重新计算一个分区的速度，和与从硬盘中读取基本差不多快。
·如果你想有快速故障恢复能力，使用复制存储级别(例如：用Spark来响应web应用的请求)。所有的存储级别都有通过重新计算丢失数据恢复错误的容错机制，但是复制存储级别可以让你在RDD上持续的运行任务，而不需要等待丢失的分区被重新计算。
·如果你想要定义你自己的存储级别(比如复制因子为Spark Note – 编程指南而不是Spark Note – 编程指南)，可以使用StorageLevel 单例对象的apply()方法。
在不会使用cached RDD的时候，及时使用unpersist方法来释放它。
在应用开发中，一个函数被传递给Spark操作（例如map和reduce），在一个远程集群上运行，它实际上操作的是这个函数用到的所有变量的独立拷贝。这些变量会被拷贝到每一台机器。通常看来，在任务之间中，读写共享变量显然不够高效。然而，Spark还是为两种常见的使用模式，提供了两种有限的共享变量：广播变量和累加器。
(Spark Note – 编程指南). 广播变量（Broadcast Variables）
– 广播变量缓存到各个节点的内存中，而不是每个 Task
– 广播变量被创建后，能在集群中运行的任何函数调用
– 广播变量是只读的，不能在被广播后修改
– 对于大数据集的广播， Spark 尝试使用高效的广播算法来降低通信成本
使用方法：
val broadcastVar = sc.broadcast(Array(Spark Note – 编程指南, Spark Note – 编程指南, Spark Note – 编程指南))
(Spark Note – 编程指南). 累加器
累加器只支持加法操作，可以高效地并行，用于实现计数器和变量求和。Spark 原生支持数值类型和标准可变集合的计数器，但用户可以添加新的类型。只有驱动程序才能获取累加器的值
使用方法：
val accum = sc.accumulator(0) sc.parallelize(Array(Spark Note – 编程指南, Spark Note – 编程指南, Spark Note – 编程指南, 4)).foreach(x => accum + = x) accum.value val num=sc.parallelize(Spark Note – 编程指南 to Spark Note – 编程指南00)
：
http://spark.apache.org/docs/latest/programming-guide.html
http://www.oschina.net/translate/spark-configuration
http://shiyanjun.cn/archives/744.html
《Apache Spark API By Example》
原文地址：Spark Note – Programming Guide, 感谢原作者分享。