Apache Spark - A unified analytics engine for large-scale data processing
Go to file
Juliusz Sompolski 8077bb04f3 [SPARK-23445] ColumnStat refactoring
## What changes were proposed in this pull request?

Refactor ColumnStat to be more flexible.

* Split `ColumnStat` and `CatalogColumnStat` just like `CatalogStatistics` is split from `Statistics`. This detaches how the statistics are stored from how they are processed in the query plan. `CatalogColumnStat` keeps `min` and `max` as `String`, making it not depend on dataType information.
* For `CatalogColumnStat`, parse column names from property names in the metastore (`KEY_VERSION` property), not from metastore schema. This means that `CatalogColumnStat`s can be created for columns even if the schema itself is not stored in the metastore.
* Make all fields optional. `min`, `max` and `histogram` for columns were optional already. Having them all optional is more consistent, and gives flexibility to e.g. drop some of the fields through transformations if they are difficult / impossible to calculate.

The added flexibility will make it possible to have alternative implementations for stats, and separates stats collection from stats and estimation processing in plans.

## How was this patch tested?

Refactored existing tests to work with refactored `ColumnStat` and `CatalogColumnStat`.
New tests added in `StatisticsSuite` checking that backwards / forwards compatibility is not broken.

Author: Juliusz Sompolski <julek@databricks.com>

Closes #20624 from juliuszsompolski/SPARK-23445.
2018-02-26 23:37:31 -08:00
.github [SPARK-18073][DOCS][WIP] Migrate wiki to spark.apache.org web site 2016-11-23 11:25:47 +00:00
assembly [SPARK-23028] Bump master branch version to 2.4.0-SNAPSHOT 2018-01-13 00:37:59 +08:00
bin [SPARK-22994][K8S] Use a single image for all Spark containers. 2018-01-11 10:37:35 -08:00
build [SPARK-19810][BUILD][CORE] Remove support for Scala 2.10 2017-07-13 17:06:24 +08:00
common [SPARK-23381][CORE] Murmur3 hash generates a different value from other implementations 2018-02-16 17:17:55 -08:00
conf [SPARK-22466][SPARK SUBMIT] export SPARK_CONF_DIR while conf is default 2017-11-09 14:33:08 +09:00
core [SPARK-23476][CORE] Generate secret in local mode when authentication on 2018-02-22 12:07:51 -08:00
data [SPARK-23205][ML] Update ImageSchema.readImages to correctly set alpha values for four-channel images 2018-01-25 18:15:29 -06:00
dev [SPARK-23383][BUILD][MINOR] Make a distribution should exit with usage while detecting wrong options 2018-02-20 07:51:30 -06:00
docs [SPARK-23476][CORE] Generate secret in local mode when authentication on 2018-02-22 12:07:51 -08:00
examples [MINOR][DOC] Use raw triple double quotes around docstrings where there are occurrences of backslashes. 2018-02-03 10:31:04 -08:00
external [SPARK-23484][SS] Fix possible race condition in KafkaContinuousReader 2018-02-21 14:56:13 -08:00
graphx [SPARK-23028] Bump master branch version to 2.4.0-SNAPSHOT 2018-01-13 00:37:59 +08:00
hadoop-cloud [SPARK-23028] Bump master branch version to 2.4.0-SNAPSHOT 2018-01-13 00:37:59 +08:00
launcher [SPARK-23020][CORE] Fix another race in the in-process launcher test. 2018-02-02 11:43:22 +08:00
licenses [SPARK-19112][CORE] Support for ZStandard codec 2017-11-01 14:54:08 +01:00
mllib [SPARK-22886][ML][TESTS] ML test for structured streaming: ml.recomme… 2018-02-25 09:29:59 -06:00
mllib-local [SPARK-23085][ML] API parity for mllib.linalg.Vectors.sparse 2018-01-19 09:28:35 -06:00
project [SPARK-20659][CORE] Removing sc.getExecutorStorageStatus and making StorageStatus private 2018-02-13 06:54:15 -08:00
python [SPARK-23217][ML][PYTHON] Add distanceMeasure param to ClusteringEvaluator Python API 2018-02-21 12:39:36 -06:00
R [SPARK-23327][SQL] Update the description and tests of three external API or functions 2018-02-06 16:46:43 -08:00
repl [SPARK-20659][CORE] Removing sc.getExecutorStorageStatus and making StorageStatus private 2018-02-13 06:54:15 -08:00
resource-managers [SPARK-23449][K8S] Preserve extraJavaOptions ordering 2018-02-26 10:28:45 -08:00
sbin [SPARK-22994][K8S] Use a single image for all Spark containers. 2018-01-11 10:37:35 -08:00
sql [SPARK-23445] ColumnStat refactoring 2018-02-26 23:37:31 -08:00
streaming [SPARK-23438][DSTREAMS] Fix DStreams data loss with WAL when driver crashes 2018-02-26 08:39:44 -08:00
tools [SPARK-23028] Bump master branch version to 2.4.0-SNAPSHOT 2018-01-13 00:37:59 +08:00
.gitattributes [SPARK-3870] EOL character enforcement 2014-10-31 12:39:52 -07:00
.gitignore [SPARK-7721][PYTHON][TESTS] Adds PySpark coverage generation script 2018-01-22 22:12:50 +09: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-23340][SQL] Upgrade Apache ORC to 1.4.3 2018-02-17 00:25:36 -08: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-20657][CORE] Speed up rendering of the stages page. 2018-01-11 19:41:48 +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.