https://github.com/emcecs/spark-ecs-connector
[Archived] ArchiveECS connector for Apache Spark
https://github.com/emcecs/spark-ecs-connector
apache-spark ecs
Last synced: 9 months ago
JSON representation
[Archived] ArchiveECS connector for Apache Spark
- Host: GitHub
- URL: https://github.com/emcecs/spark-ecs-connector
- Owner: EMCECS
- Created: 2016-02-15T23:12:40.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2017-10-10T16:24:59.000Z (almost 9 years ago)
- Last Synced: 2025-02-02T01:31:58.573Z (over 1 year ago)
- Topics: apache-spark, ecs
- Language: Scala
- Homepage: https://www.dellemc.com/en-us/storage/ecs/index.htm
- Size: 20.6 MB
- Stars: 7
- Watchers: 22
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Bucket Metadata Search with Spark SQL (2.x)
The [spark-ecs-connector](https://github.com/emcvipr/spark-ecs-connector) project makes it possible to view an ECS bucket as a Spark dataframe.
Each row in the dataframe corresponds to an object in the bucket, and each column coresponds to a piece of object metadata.
**How it Works**
Spark SQL supports querying external data sources and rendering the results as a dataframe. With the [PrunedFilteredScan](https://spark.apache.org/docs/latest/api/scala/index.html#org.apache.spark.sql.sources.PrunedFilteredScan) trait, the external data source handles column pruning and predicate pushdown. In other words, the WHERE clause is pushed to ECS by taking advantage of the bucket metadata search feature of ECS 2.2.
# Using
### Linking to your Spark 2.x Application
The library is published to Maven Central. Link to the library using these dependency coordinates:
```
com.emc.ecs:spark-ecs-connector_2.11:1.4.2
```
### Using in Zeppelin
1. Install Zeppelin 0.7+.
2. `export SPARK_LOCAL_IP=127.0.0.1`
3. `bin/zeppelin.sh`
Create a notebook with the following commands. Replace `***` with your S3 credentials.
```
%dep
z.load("com.emc.ecs:spark-ecs-connector_2.11:1.4.2")
```
```
import java.net.URI
import com.emc.ecs.spark.sql.sources.s3._
val endpointUri = new URI("http://10.1.83.51:9020/")
val credential = ("***ACCESS KEY ID***", "***SECRET ACCESS KEY***")
val df = sqlContext.read.bucket(endpointUri, credential, "ben_bucket", withSystemMetadata = false)
df.createOrReplaceTempView("ben_bucket")
```
```
%sql
SELECT * FROM ben_bucket
WHERE `image-viewcount` >= 5000 AND `image-viewcount` <= 10000
```
# Contributing
## Building
The project use the Gradle build system and includes a script that automatically downloads Gradle.
Build and install the library to your local Maven repository as follows:
```
$ ./gradlew publishShadowPublicationToMavenLocal
```
## TODO
1. Implement 'OR' pushdown. ECS supports 'or', but not in combination with 'and'.
2. Avoid sending a query containing a non-indexable key.