Apache Spark - A unified analytics engine for large-scale data processing
Go to file
gatorsmile d9a3a2a0be [SPARK-16056][SPARK-16057][SPARK-16058][SQL] Fix Multiple Bugs in Column Partitioning in JDBC Source
#### What changes were proposed in this pull request?
This PR is to fix the following bugs:

**Issue 1: Wrong Results when lowerBound is larger than upperBound in Column Partitioning**
```scala
spark.read.jdbc(
  url = urlWithUserAndPass,
  table = "TEST.seq",
  columnName = "id",
  lowerBound = 4,
  upperBound = 0,
  numPartitions = 3,
  connectionProperties = new Properties)
```
**Before code changes:**
The returned results are wrong and the generated partitions are wrong:
```
  Part 0 id < 3 or id is null
  Part 1 id >= 3 AND id < 2
  Part 2 id >= 2
```
**After code changes:**
Issue an `IllegalArgumentException` exception:
```
Operation not allowed: the lower bound of partitioning column is larger than the upper bound. lowerBound: 5; higherBound: 1
```
**Issue 2: numPartitions is more than the number of key values between upper and lower bounds**
```scala
spark.read.jdbc(
  url = urlWithUserAndPass,
  table = "TEST.seq",
  columnName = "id",
  lowerBound = 1,
  upperBound = 5,
  numPartitions = 10,
  connectionProperties = new Properties)
```
**Before code changes:**
Returned correct results but the generated partitions are very inefficient, like:
```
Partition 0: id < 1 or id is null
Partition 1: id >= 1 AND id < 1
Partition 2: id >= 1 AND id < 1
Partition 3: id >= 1 AND id < 1
Partition 4: id >= 1 AND id < 1
Partition 5: id >= 1 AND id < 1
Partition 6: id >= 1 AND id < 1
Partition 7: id >= 1 AND id < 1
Partition 8: id >= 1 AND id < 1
Partition 9: id >= 1
```
**After code changes:**
Adjust `numPartitions` and can return the correct answers:
```
Partition 0: id < 2 or id is null
Partition 1: id >= 2 AND id < 3
Partition 2: id >= 3 AND id < 4
Partition 3: id >= 4
```
**Issue 3: java.lang.ArithmeticException when numPartitions is zero**
```Scala
spark.read.jdbc(
  url = urlWithUserAndPass,
  table = "TEST.seq",
  columnName = "id",
  lowerBound = 0,
  upperBound = 4,
  numPartitions = 0,
  connectionProperties = new Properties)
```
**Before code changes:**
Got the following exception:
```
  java.lang.ArithmeticException: / by zero
```
**After code changes:**
Able to return a correct answer by disabling column partitioning when numPartitions is equal to or less than zero

#### How was this patch tested?
Added test cases to verify the results

Author: gatorsmile <gatorsmile@gmail.com>

Closes #13773 from gatorsmile/jdbcPartitioning.
2016-06-20 21:49:33 -07:00
.github [MINOR][MAINTENANCE] Fix typo for the pull request template. 2016-02-24 00:45:31 -08:00
assembly [SPARK-14925][BUILD] Re-introduce 'unused' dependency so that published POMs are flattened 2016-04-26 15:14:17 -07:00
bin [SPARK-15531][DEPLOY] spark-class tries to use too much memory when running Launcher 2016-05-27 11:28:28 -07:00
build [SPARK-14279][BUILD] Pick the spark version from pom 2016-06-06 09:42:50 -07:00
common [SPARK-16018][SHUFFLE] Shade netty to load shuffle jar in Nodemanger 2016-06-17 15:44:33 -05:00
conf [SPARK-15806][DOCUMENTATION] update doc for SPARK_MASTER_IP 2016-06-12 14:25:48 +01:00
core [SPARK-16017][CORE] Send hostname from CoarseGrainedExecutorBackend to driver 2016-06-17 15:48:17 -07:00
data [SPARK-15608][ML][EXAMPLES][DOC] add examples and documents of ml.isotonic regression 2016-06-16 17:35:40 -07:00
dev [SPARK-15975] Fix improper Popen retcode code handling in dev/run-tests 2016-06-16 14:18:58 -07:00
docs [SPARK-15863][SQL][DOC] Initial SQL programming guide update for Spark 2.0 2016-06-20 14:50:28 -07:00
examples [SPARK-15159][SPARKR] SparkSession roxygen2 doc, programming guide, example updates 2016-06-20 13:46:24 -07:00
external [SPARK-15086][CORE][STREAMING] Deprecate old Java accumulator API 2016-06-12 11:44:33 -07:00
graphx [MINOR] Fix Typos 'an -> a' 2016-06-06 09:35:47 +01:00
launcher [MINOR] Fix Java Lint errors introduced by #13286 and #13280 2016-06-08 14:51:00 +01:00
licenses [MINOR][BUILD] Add modernizr MIT license; specify "2014 and onwards" in license copyright 2016-06-04 21:41:27 +01:00
mllib [SPARK-15946][MLLIB] Conversion between old/new vector columns in a DataFrame (Python) 2016-06-17 21:22:29 -07:00
mllib-local [MINOR] Fix Typos 'an -> a' 2016-06-06 09:35:47 +01:00
project [SPARK-15851][BUILD] Fix the call of the bash script to enable proper run in Windows 2016-06-15 20:11:23 -07:00
python [SPARK-13792][SQL] Limit logging of bad records in CSV data source 2016-06-20 21:46:12 -07:00
R [SPARK-15294][R] Add pivot to SparkR 2016-06-20 21:09:39 -07:00
repl [SPARK-15942][REPL] Unblock :reset command in REPL. 2016-06-19 20:12:00 +01:00
sbin [SPARK-15806][DOCUMENTATION] update doc for SPARK_MASTER_IP 2016-06-12 14:25:48 +01:00
sql [SPARK-16056][SPARK-16057][SPARK-16058][SQL] Fix Multiple Bugs in Column Partitioning in JDBC Source 2016-06-20 21:49:33 -07:00
streaming [SPARK-15086][CORE][STREAMING] Deprecate old Java accumulator API 2016-06-12 11:44:33 -07:00
tools [MINOR][DOCS] Use multi-line JavaDoc comments in Scala code. 2016-04-02 17:50:40 -07:00
yarn [SPARK-15046][YARN] Parse value of token renewal interval correctly. 2016-06-15 09:09:21 -05:00
.gitattributes [SPARK-3870] EOL character enforcement 2014-10-31 12:39:52 -07:00
.gitignore [MINOR][BUILD] Adds spark-warehouse/ to .gitignore 2016-05-05 14:33:14 -07:00
.travis.yml [SPARK-15207][BUILD] Use Travis CI for Java Linter and JDK7/8 compilation test 2016-05-10 21:04:22 +01:00
CONTRIBUTING.md [SPARK-6889] [DOCS] CONTRIBUTING.md updates to accompany contribution doc updates 2015-04-21 22:34:31 -07:00
LICENSE [MINOR][BUILD] Add modernizr MIT license; specify "2014 and onwards" in license copyright 2016-06-04 21:41:27 +01:00
NOTICE [MINOR][BUILD] Add modernizr MIT license; specify "2014 and onwards" in license copyright 2016-06-04 21:41:27 +01:00
pom.xml [SPARK-15839] Fix Maven doc-jar generation when JAVA_7_HOME is set 2016-06-09 12:32:29 -07:00
README.md [SPARK-15821][DOCS] Include parallel build info 2016-06-14 13:59:01 +01:00
scalastyle-config.xml [SPARK-6429] Implement hashCode and equals together 2016-04-22 12:24:12 +01: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 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:

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 developing Spark using an IDE, see Eclipse and IntelliJ.

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.