Apache Spark - A unified analytics engine for large-scale data processing
Go to file
Marcelo Vanzin 8b497046c6 [SPARK-20654][CORE] Add config to limit disk usage of the history server.
This change adds a new configuration option and support code that limits
how much disk space the SHS will use. The default value is pretty generous
so that applications will, hopefully, only rarely need to be replayed
because of their disk stored being evicted.

This works by keeping track of how much data each application is using.
Also, because it's not possible to know, before replaying, how much space
will be needed, it's possible that usage will exceed the configured limit
temporarily. The code uses the concept of a "lease" to try to limit how
much the SHS will exceed the limit in those cases.

Active UIs are also tracked, so they're never deleted. This works in
tandem with the existing option of how many active UIs are loaded; because
unused UIs will be unloaded, their disk stores will also become candidates
for deletion. If the data is not deleted, though, re-loading the UI is
pretty quick.

Author: Marcelo Vanzin <vanzin@cloudera.com>

Closes #20011 from vanzin/SPARK-20654.
2017-12-29 10:40:09 -06:00
.github [SPARK-18073][DOCS][WIP] Migrate wiki to spark.apache.org web site 2016-11-23 11:25:47 +00:00
assembly [SPARK-22646][K8S] Spark on Kubernetes - basic submission client 2017-12-11 15:15:05 -08:00
bin [SPARK-22597][SQL] Add spark-sql cmd script for Windows users 2017-11-24 19:55:26 +01:00
build [SPARK-19810][BUILD][CORE] Remove support for Scala 2.10 2017-07-13 17:06:24 +08:00
common [SPARK-22324][SQL][PYTHON] Upgrade Arrow to 0.8.0 2017-12-21 20:43:56 +09:00
conf [SPARK-22466][SPARK SUBMIT] export SPARK_CONF_DIR while conf is default 2017-11-09 14:33:08 +09:00
core [SPARK-20654][CORE] Add config to limit disk usage of the history server. 2017-12-29 10:40:09 -06:00
data [SPARK-21866][ML][PYSPARK] Adding spark image reader 2017-11-22 15:45:45 -08:00
dev [SPARK-22921][PROJECT-INFRA] Choices for Assigning Jira on Merge 2017-12-29 07:30:49 -06:00
docs [SPARK-22648][K8S] Add documentation covering init containers and secrets 2017-12-28 13:53:04 +09:00
examples [SPARK-22833][EXAMPLE] Improvement SparkHive Scala Examples 2017-12-26 09:37:39 -08:00
external [MINOR][BUILD] Fix Java linter errors 2017-12-28 09:43:50 -06:00
graphx [SPARK-14540][BUILD] Support Scala 2.12 closures and Java 8 lambdas in ClosureCleaner (step 0) 2017-11-08 10:24:40 +00:00
hadoop-cloud [SPARK-7481][BUILD] Add spark-hadoop-cloud module to pull in object store access. 2017-05-07 10:15:31 +01:00
launcher [SPARK-11035][CORE] Add in-process Spark app launcher. 2017-12-28 17:00:49 -06:00
licenses [SPARK-19112][CORE] Support for ZStandard codec 2017-11-01 14:54:08 +01:00
mllib [SPARK-22905][MLLIB] Fix ChiSqSelectorModel save implementation 2017-12-28 17:32:30 -08:00
mllib-local [SPARK-22289][ML] Add JSON support for Matrix parameters (LR with coefficients bound) 2017-12-12 11:27:01 -08:00
project [SPARK-22789] Map-only continuous processing execution 2017-12-22 23:05:03 -08:00
python [SPARK-22370][SQL][PYSPARK][FOLLOW-UP] Fix a test failure when xmlrunner is installed. 2017-12-29 23:04:28 +09:00
R [SPARK-21208][R] Adds setLocalProperty and getLocalProperty in R 2017-12-28 20:18:47 +09:00
repl [SPARK-20706][SPARK-SHELL] Spark-shell not overriding method/variable definition 2017-12-05 18:08:36 -06:00
resource-managers [SPARK-11035][CORE] Add in-process Spark app launcher. 2017-12-28 17:00:49 -06:00
sbin [SPARK-22648][K8S] Add documentation covering init containers and secrets 2017-12-28 13:53:04 +09:00
sql [SPARK-21657][SQL] optimize explode quadratic memory consumpation 2017-12-29 21:08:34 +08:00
streaming [SPARK-22788][STREAMING] Use correct hadoop config for fs append support. 2017-12-20 11:31:11 -06:00
tools [SPARK-14280][BUILD][WIP] Update change-version.sh and pom.xml to add Scala 2.12 profiles and enable 2.12 compilation 2017-09-01 19:21:21 +01:00
.gitattributes [SPARK-3870] EOL character enforcement 2014-10-31 12:39:52 -07:00
.gitignore [SPARK-21485][SQL][DOCS] Spark SQL documentation generation for built-in functions 2017-07-26 09:38:51 -07:00
.travis.yml [SPARK-18278][SCHEDULER] Spark on Kubernetes - Basic Scheduler Backend 2017-11-28 23:02:09 -08:00
appveyor.yml [SPARK-22817][R] Use fixed testthat version for SparkR tests in AppVeyor 2017-12-17 14:40:41 +09:00
CONTRIBUTING.md [SPARK-18073][DOCS][WIP] Migrate wiki to spark.apache.org web site 2016-11-23 11:25:47 +00:00
LICENSE [SPARK-19112][CORE] Support for ZStandard codec 2017-11-01 14:54:08 +01:00
NOTICE [SPARK-18278][SCHEDULER] Spark on Kubernetes - Basic Scheduler Backend 2017-11-28 23:02:09 -08:00
pom.xml [SPARK-22875][BUILD] Assembly build fails for a high user id 2017-12-28 11:44:06 -06:00
README.md [MINOR][DOCS] Replace non-breaking space to normal spaces that breaks rendering markdown 2017-04-03 10:09:11 +01:00
scalastyle-config.xml [SPARK-20642][CORE] Store FsHistoryProvider listing data in a KVStore. 2017-09-27 20:33:41 +08:00

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.

http://spark.apache.org/

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:

./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" 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 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.

Configuration

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

Contributing

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