Spark-SQL-on-HBase - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #typescript #android #machine-learning #rust #linux #nodejs #java #cli #kubernetes #awesome-list #security #openai

Spark-SQL-on-HBase

(★ 316)

Native, optimized access to HBase Data through Spark SQL/Dataframe Interfaces

파일 탐색기

최종 버전 다운로드 (.zip)

- hbase-sql
- pyspark-hbase
- SparkSQLOnHBase_v2.2.docx
- README.md
- sales1m.csv.tar.gz
- spark-hbase-demo1.md
- spark-hbase-demo2.md
- spark-hbase-demo3.md
- teacher1k.csv
- - __init__.py
  - shell.py
.gitignore
LICENSE
pom.xml
README.md
spark-hbase_2.10.iml

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/Huawei-Spark/Spark-SQL-on-HBase

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd Spark-SQL-on-HBase

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Maven (Java)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java 프로젝트를 빌드/실행하려면 필요합니다.
Maven mvn 명령어를 쓰기 위한 빌드 도구입니다.

$ mvn -DskipTests clean install

Maven으로 의존성 설치와 빌드를 진행합니다.

$ mvn clean install

Maven으로 의존성 설치와 빌드를 진행합니다.

mvn -Phbase,hadoop-2.4 test

Maven으로 의존성 설치와 빌드를 진행합니다.

mvn -Phbase,hadoop-2.4 test -DwildcardSuites=org.apache.spark.sql.hbase.BasicQueriesSuite

Maven으로 의존성 설치와 빌드를 진행합니다.

✅ BUILD SUCCESS 메시지가 뜨면 성공입니다. target/ 폴더에 결과물이 생성됩니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## Astro: Fast SQL on HBase using SparkSQL

Apache HBase is a distributed Key-Value store of data on HDFS. It is modeled after Google’s Big Table, and provides APIs to query the data. The data is organized, partitioned and distributed by its “row keys”. Per partition, the data is further physically partitioned by “column families” that specify collections of “columns” of data. The data model is for wide and sparse tables where columns are dynamic and may well be sparse.

Although HBase is a very useful big data store, its access mechanism is very primitive and only through client-side APIs, Map/Reduce interfaces and interactive shells. SQL accesses to HBase data are available through Map/Reduce or interfaces mechanisms such as Apache Hive and Impala, or some “native” SQL technologies like Apache Phoenix. While the former is usually cheaper to implement and use, their latencies and efficiencies often cannot compare favorably with the latter and are often suitable only for offline analysis. The latter category, in contrast, often performs better and qualifies more as online engines; they are often on top of purpose-built execution engines.

Currently Spark supports queries against HBase data through HBase’s Map/Reduce interface (i.e., TableInputFormat). Spark SQL supports use of Hive data, which theoretically should be able to support HBase data access, out-of-box, through HBase’s Map/Reduce interface and therefore falls into the first category of the “SQL on HBase” technologies.

We believe, as an unified big data processing engine, Spark is in good position to provide better HBase support.

## Online Documentation

Online documentation https://github.com/Huawei-Spark/Spark-SQL-on-HBase/blob/master/doc/SparkSQLOnHBase_v2.2.docx

## Requirements

This version of 1.0.0 requires Spark 1.4.0.

## Building Spark HBase

Spark HBase is built using [Apache Maven](http://maven.apache.org/).

I. Clone and build Huawei-Spark/Spark-SQL-on-HBase
```
$ git clone https://github.com/Huawei-Spark/Spark-SQL-on-HBase spark-hbase
```

II. Go to the root of the source tree
```
$ cd spark-hbase
```

III. Build the project
Build without testing
```
$ mvn -DskipTests clean install 
```
Or, build with testing. It will run test suites against a HBase minicluster.
```
$ mvn clean install
```

## Activate Coprocessor and Custom Filter in HBase

First, add the path of spark-hbase jar to the hbase-env.sh in $HBASE_HOME/conf directory, as follows:
```
HBASE_CLASSPATH=$HBASE_CLASSPATH:/spark-hbase-root-dir/target/spark-sql-on-hbase-1.0.0.jar
```
Then, register the coprocessor service 'CheckDirEndPoint' to hbase-site.xml in the same directory, as follows:
```
<property>
    <name>hbase.coprocessor.region.classes</name>
    <value>org.apache.spark.sql.hbase.CheckDirEndPointImpl</value>
</property>
```
(Warning: Don't register another coprocessor service 'SparkSqlRegionObserver' here !)

## Interactive Scala Shell

The easiest way to start using Spark HBase is through the Scala shell:
```
./bin/hbase-sql
```

## Python Shell

First, add the spark-hbase jar to the SPARK_CLASSPATH in the $SPARK_HOME/conf directory, as follows:
```
SPARK_CLASSPATH=$SPARK_CLASSPATH:/spark-hbase-root-dir/target/spark-sql-on-hbase-1.0.0.jar
```
Then go to the spark-hbase installation directory and issue
```
./bin/pyspark-hbase
```
A successfull message is as follows:

You are using Spark SQL on HBase!!!
   HBaseSQLContext available as hsqlContext.

To run a python script, the PYTHONPATH environment should be set to the "python" directory of the Spark-HBase installation. For example,
```
export PYTHONPATH=/root-of-Spark-HBase/python
```

Note that the shell commands are not included in the Zip file of the Spark release. They are for developers' use only for this version of 1.0.0. Instead, users can use "$SPARK_HOME/bin/spark-shell --packages Huawei-Spark/Spark-SQL-on-HBase:1.0.0" for SQL shell or "$SPARK_HOME/bin/pyspark --packages Huawei-Spark/Spark-SQL-on-HBase:1.0.0" for Pythin shell.

## Running Tests

Testing first requires [building Spark HBase](#building-spark-hbase). Once Spark HBase is built ...

Run all test suites from Maven:
```
mvn -Phbase,hadoop-2.4 test
```
Run a single test suite from Maven, for example:
```
mvn -Phbase,hadoop-2.4 test -DwildcardSuites=org.apache.spark.sql.hbase.BasicQueriesSuite
```
## IDE Setup

We use IntelliJ IDEA for Spark HBase development. You can get the community edition for free and install the JetBrains Scala plugin from Preferences > Plugins.

To import the current Spark HBase project for IntelliJ:

1. Download IntelliJ and install the Scala plug-in for IntelliJ. You may also need to install Maven plug-in for IntelliJ.
2. Go to "File -> Import Project", locate the Spark HBase source directory, and select "Maven Project".
3. In the Import Wizard, select "Import Maven projects automatically" and leave other settings at their default. 
4. Make sure some specific profiles are enabled. Select corresponding Hadoop version, "maven3" and also"hbase" in order to get dependencies.
5. Leave other settings at their default and you should be able to start your development.
6. When you run the scala test, sometimes you will get out of memory exception. You can increase your VM memory usage by the following setting, for example:

```
-XX:MaxPermSize=512m -Xmx3072m
```

You can also make those setting to be the default by setting to the "Defaults -> ScalaTest".

## Configuration

Please refer to the [Configuration guide](http://spark.apache.org/docs/latest/configuration.html)
in the online documentation for an overview on how to configure Spark.