Apache Spark - A unified analytics engine for large-scale data processing
Go to file
Cheng Lian 77bcceb9f0 [SPARK-6748] [SQL] Makes QueryPlan.schema a lazy val
`DataFrame.collect()` calls `SparkPlan.executeCollect()`, which consists of a single line:

```scala
execute().map(ScalaReflection.convertRowToScala(_, schema)).collect()
```

The problem is that, `QueryPlan.schema` is a function. And since 1.3.0, `convertRowToScala` starts returning a `GenericRowWithSchema`. Thus, every `GenericRowWithSchema` instance holds a separate copy of the schema object. Also, YJP profiling result of the following simple micro benchmark (executed in Spark shell) shows that constructing the schema object takes up to ~35% CPU time.

```scala
sc.parallelize(1 to 10000000).
  map(i => (i, s"val_$i")).
  toDF("key", "value").
  saveAsParquetFile("file:///tmp/src.parquet")

// Profiling started from this line
sqlContext.parquetFile("file:///tmp/src.parquet").collect()
```

<!-- Reviewable:start -->
[<img src="https://reviewable.io/review_button.png" height=40 alt="Review on Reviewable"/>](https://reviewable.io/reviews/apache/spark/5398)
<!-- Reviewable:end -->

Author: Cheng Lian <lian@databricks.com>

Closes #5398 from liancheng/spark-6748 and squashes the following commits:

3159469 [Cheng Lian] Makes QueryPlan.schema a lazy val
2015-04-08 07:00:56 +08:00
assembly [SPARK-6371] [build] Update version to 1.4.0-SNAPSHOT. 2015-03-20 18:43:57 +00:00
bagel [SPARK-6371] [build] Update version to 1.4.0-SNAPSHOT. 2015-03-20 18:43:57 +00:00
bin [SPARK-6673] spark-shell.cmd can't start in Windows even when spark was built 2015-04-06 10:11:20 +01:00
build SPARK-5856: In Maven build script, launch Zinc with more memory 2015-02-17 10:10:01 -08:00
conf [SPARK-3619] Part 2. Upgrade to Mesos 0.21 to work around MESOS-1688 2015-03-15 15:46:55 +00:00
core Revert "[SPARK-6568] spark-shell.cmd --jars option does not accept the jar that has space in its path" 2015-04-07 14:34:15 -07:00
data/mllib [SPARK-5939][MLLib] make FPGrowth example app take parameters 2015-02-23 08:47:28 -08:00
dev [HOTFIX][SPARK-4123]: Updated to fix bug where multiple dependencies added breaks Github output 2015-03-30 12:48:26 -07:00
docker [SPARK-1342] Scala 2.10.4 2014-04-01 18:35:50 -07:00
docs [SPARK-3591][YARN]fire and forget for YARN cluster mode 2015-04-07 08:36:25 -05:00
ec2 [SPARK-6636] Use public DNS hostname everywhere in spark_ec2.py 2015-04-06 23:51:47 -07:00
examples [SPARK-6428] Turn on explicit type checking for public methods. 2015-04-03 01:25:02 -07:00
external SPARK-6569 [STREAMING] Down-grade same-offset message in Kafka streaming to INFO 2015-04-06 10:18:56 +01:00
extras [SPARK-6371] [build] Update version to 1.4.0-SNAPSHOT. 2015-03-20 18:43:57 +00:00
graphx [SPARK-6736][GraphX][Doc]Example of Graph#aggregateMessages has error 2015-04-07 01:55:32 -07:00
launcher [SPARK-6406] Launch Spark using assembly jar instead of a separate launcher jar 2015-03-29 12:40:37 +01:00
mllib [SPARK-6733][ Scheduler]Added scala.language.existentials 2015-04-07 10:42:08 -07:00
network [SPARK-6578] Small rewrite to make the logic more clear in MessageWithHeader.transferTo. 2015-04-01 18:36:06 -07:00
project [SPARK-6750] Upgrade ScalaStyle to 0.7. 2015-04-07 12:37:33 -07:00
python [SPARK-6720][MLLIB] PySpark MultivariateStatisticalSummary unit test for normL1... 2015-04-07 14:36:57 -07:00
repl [SPARK-6209] Clean up connections in ExecutorClassLoader after failing to load classes (master branch PR) 2015-03-24 14:38:20 -07:00
sbin [HOTFIX] Update start-slave.sh 2015-03-30 14:59:26 +01:00
sbt Adde LICENSE Header to build/mvn, build/sbt and sbt/sbt 2014-12-29 10:48:53 -08:00
sql [SPARK-6748] [SQL] Makes QueryPlan.schema a lazy val 2015-04-08 07:00:56 +08:00
streaming [SPARK-6602][Core] Replace direct use of Akka with Spark RPC interface - part 1 2015-04-04 11:52:05 -07:00
tools [SPARK-6428] Turn on explicit type checking for public methods. 2015-04-03 01:25:02 -07:00
yarn [SPARK-3591][YARN]fire and forget for YARN cluster mode 2015-04-07 08:36:25 -05:00
.gitattributes [SPARK-3870] EOL character enforcement 2014-10-31 12:39:52 -07:00
.gitignore [SPARK-4924] Add a library for launching Spark jobs programmatically. 2015-03-11 01:03:01 -07:00
.rat-excludes [SPARK-5778] throw if nonexistent metrics config file provided 2015-02-17 10:57:16 -08:00
CONTRIBUTING.md [Docs] minor grammar fix 2014-09-17 12:33:09 -07:00
LICENSE SPARK-5984: Fix TimSort bug causes ArrayOutOfBoundsException 2015-02-28 18:55:34 -08:00
make-distribution.sh [SPARK-6406] Launch Spark using assembly jar instead of a separate launcher jar 2015-03-29 12:40:37 +01:00
NOTICE SPARK-1827. LICENSE and NOTICE files need a refresh to contain transitive dependency info 2014-05-14 09:38:33 -07:00
pom.xml SPARK-6433 hive tests to import spark-sql test JAR for QueryTest access 2015-04-01 16:26:54 +01:00
README.md [docs] [SPARK-6306] Readme points to dead link 2015-03-12 15:01:33 +00:00
scalastyle-config.xml [SPARK-6428] Turn on explicit type checking for public methods. 2015-04-03 01:25:02 -07:00
tox.ini [SPARK-3073] [PySpark] use external sort in sortBy() and sortByKey() 2014-08-26 16:57:40 -07:00

Apache Spark

Spark is a fast and general cluster computing system for Big Data. It provides high-level APIs in Scala, Java, and Python, and an optimized engine that supports general computation graphs for data analysis. It also supports a rich set of higher-level tools including Spark SQL for SQL and structured data processing, MLlib for machine learning, GraphX for graph processing, and Spark Streaming for stream processing.

http://spark.apache.org/

Online Documentation

You can find the latest Spark documentation, including a programming guide, on the project web page and project wiki. This README file only contains basic setup instructions.

Building Spark

Spark is built using Apache Maven. To build Spark and its example programs, run:

mvn -DskipTests clean package

(You do not need to do this if you downloaded a pre-built package.) More detailed documentation is available from the project site, at "Building Spark".

Interactive Scala Shell

The easiest way to start using Spark is through the Scala shell:

./bin/spark-shell

Try the following command, which should return 1000:

scala> sc.parallelize(1 to 1000).count()

Interactive Python Shell

Alternatively, if you prefer Python, you can use the Python shell:

./bin/pyspark

And run the following command, which should also return 1000:

>>> sc.parallelize(range(1000)).count()

Example Programs

Spark also comes with several sample programs in the examples directory. To run one of them, use ./bin/run-example <class> [params]. For example:

./bin/run-example SparkPi

will run the Pi example locally.

You can set the MASTER environment variable when running examples to submit examples to a cluster. This can be a mesos:// or spark:// URL, "yarn-cluster" or "yarn-client" to run on YARN, and "local" to run locally with one thread, or "local[N]" to run locally with N threads. You can also use an abbreviated class name if the class is in the examples package. For instance:

MASTER=spark://host:7077 ./bin/run-example SparkPi

Many of the example programs print usage help if no params are given.

Running Tests

Testing first requires building Spark. Once Spark is built, tests can be run using:

./dev/run-tests

Please see the guidance on how to run all automated tests.

A Note About Hadoop Versions

Spark uses the Hadoop core library to talk to HDFS and other Hadoop-supported storage systems. Because the protocols have changed in different versions of Hadoop, you must build Spark against the same version that your cluster runs.

Please refer to the build documentation at "Specifying the Hadoop Version" for detailed guidance on building for a particular distribution of Hadoop, including building for particular Hive and Hive Thriftserver distributions. See also "Third Party Hadoop Distributions" for guidance on building a Spark application that works with a particular distribution.

Configuration

Please refer to the Configuration guide in the online documentation for an overview on how to configure Spark.