Mirror of Apache Spark
Scala Java Python R Shell JavaScript Other
Latest commit 7353038 Feb 28, 2017 @uncleGen uncleGen committed with zsxwing [SPARK-19749][SS] Name socket source with a meaningful name
## What changes were proposed in this pull request?

Name socket source with a meaningful name

## How was this patch tested?


Author: uncleGen <hustyugm@gmail.com>

Closes #17082 from uncleGen/SPARK-19749.
Failed to load latest commit information.
.github [SPARK-18073][DOCS][WIP] Migrate wiki to spark.apache.org web site Nov 23, 2016
R [SPARK-19682][SPARKR] Issue warning (or error) when subset method "[[… Feb 23, 2017
assembly [SPARK-19550][BUILD][CORE][WIP] Remove Java 7 support Feb 16, 2017
bin [SPARK-1267][SPARK-18129] Allow PySpark to be pip installed Nov 16, 2016
build [SPARK-19550][BUILD][CORE][WIP] Remove Java 7 support Feb 16, 2017
common [MINOR][BUILD] Fix lint-java breaks in Java Feb 27, 2017
conf [SPARK-11653][DEPLOY] Allow spark-daemon.sh to run in the foreground Oct 20, 2016
core [MINOR][BUILD] Fix lint-java breaks in Java Feb 27, 2017
data [SPARK-16421][EXAMPLES][ML] Improve ML Example Outputs Aug 5, 2016
dev [SPARK-19550] Follow-up: fixed a typo that fails the dev/make-distrib… Feb 18, 2017
docs [MINOR][DOCS] Fixes two problems in the SQL programing guide page Feb 25, 2017
examples [SPARK-15615][SQL][BUILD][FOLLOW-UP] Replace deprecated usage of json… Feb 27, 2017
external [MINOR][BUILD] Fix lint-java breaks in Java Feb 27, 2017
graphx [SPARK-14804][SPARK][GRAPHX] Fix checkpointing of VertexRDD/EdgeRDD Jan 26, 2017
launcher [SPARK-19534][TESTS] Convert Java tests to use lambdas, Java 8 features Feb 19, 2017
licenses [MINOR][BUILD] Add modernizr MIT license; specify "2014 and onwards" … Jun 4, 2016
mllib-local [SPARK-19402][DOCS] Support LaTex inline formula correctly and fix wa… Feb 1, 2017
mllib [SPARK-19746][ML] Faster indexing for logistic aggregator Feb 28, 2017
project [SPARK-19652][UI] Do auth checks for REST API access. Feb 22, 2017
python [SPARK-13330][PYSPARK] PYTHONHASHSEED is not propgated to python worker Feb 24, 2017
repl [SPARK-19481] [REPL] [MAVEN] Avoid to leak SparkContext in Signaling.… Feb 9, 2017
resource-managers [SPARK-15288][MESOS] Mesos dispatcher should handle gracefully when a… Feb 25, 2017
sbin [SPARK-19083] sbin/start-history-server.sh script use of $@ without q… Jan 6, 2017
sql [SPARK-19749][SS] Name socket source with a meaningful name Feb 28, 2017
streaming [MINOR][BUILD] Fix lint-java breaks in Java Feb 27, 2017
tools [SPARK-18695] Bump master branch version to 2.2.0-SNAPSHOT Dec 3, 2016
.gitattributes [SPARK-3870] EOL character enforcement Oct 31, 2014
.gitignore [SPARK-19562][BUILD] Added exclude for dev/pr-deps to gitignore Feb 13, 2017
.travis.yml [SPARK-19464][CORE][YARN][TEST-HADOOP2.6] Remove support for Hadoop 2… Feb 8, 2017
CONTRIBUTING.md [SPARK-18073][DOCS][WIP] Migrate wiki to spark.apache.org web site Nov 23, 2016
LICENSE [SPARK-17960][PYSPARK][UPGRADE TO PY4J 0.10.4] Oct 21, 2016
NOTICE [SPARK-18262][BUILD][SQL] JSON.org license is now CatX Nov 10, 2016
README.md [MINOR][DOCS] Remove Apache Spark Wiki address Dec 10, 2016
appveyor.yml [SPARK-19464][CORE][YARN][TEST-HADOOP2.6] Remove support for Hadoop 2… Feb 8, 2017
pom.xml [SPARK-19405][STREAMING] Support for cross-account Kinesis reads via STS Feb 22, 2017
scalastyle-config.xml [SPARK-13747][CORE] Fix potential ThreadLocal leaks in RPC when using… Dec 13, 2016


Apache Spark

Spark is a fast and general cluster computing system for Big Data. It provides high-level APIs in Scala, Java, Python, and R, 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 DataFrames, MLlib for machine learning, GraphX for graph processing, and Spark Streaming for stream processing.


Online Documentation

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

Building Spark

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

build/mvn -DskipTests clean package

(You do not need to do this if you downloaded a pre-built package.)

You can build Spark using more than one thread by using the -T option with Maven, see "Parallel builds in Maven 3". More detailed documentation is available from the project site, at "Building Spark".

For general development tips, including info on developing Spark using an IDE, see "Useful Developer Tools".

Interactive Scala Shell

The easiest way to start using Spark is through the Scala 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:


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" 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:


Please see the guidance on how to run tests for a module, or individual 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.


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


Please review the Contribution to Spark guide for information on how to get started contributing to the project.