[KYUUBI #425] [DOCS] Getting Started with Kyuubi and Cloudera Hue
 [](https://github.com/yaooqinn/kyuubi/pull/425)      [❨?❩](https://pullrequestbadge.com/?utm_medium=github&utm_source=yaooqinn&utm_campaign=badge_info)<!-- PR-BADGE: PLEASE DO NOT REMOVE THIS COMMENT --> <!-- Thanks for sending a pull request! Here are some tips for you: 1. If this is your first time, please read our contributor guidelines: https://kyuubi.readthedocs.io/en/latest/community/contributions.html 2. If the PR is related to an issue in https://github.com/yaooqinn/kyuubi/issues, add '[KYUUBI #XXXX]' in your PR title, e.g., '[KYUUBI #XXXX] Your PR title ...'. 3. If the PR is unfinished, add '[WIP]' in your PR title, e.g., '[WIP][KYUUBI #XXXX] Your PR title ...'. --> ### _Why are the changes needed?_ <!-- Please clarify why the changes are needed. For instance, 1. If you add a feature, you can talk about the use case of it. 2. If you fix a bug, you can clarify why it is a bug. --> ### _How was this patch tested?_ - [ ] Add some test cases that check the changes thoroughly including negative and positive cases if possible - [x] Add screenshots for manual tests if appropriate  - [ ] [Run test](https://kyuubi.readthedocs.io/en/latest/tools/testing.html#running-tests) locally before make a pull request Closes #425 from pan3793/hue. 67a451e [Cheng Pan] fix adcfd6a [Cheng Pan] [DOCS] Getting Started with Kyuubi and Cloudera Hue Authored-by: Cheng Pan <379377944@qq.com> Signed-off-by: ulysses-you <ulyssesyou18@gmail.com>
This commit is contained in:
parent
e0452b2dbb
commit
4deb20600a
BIN
docs/imgs/hue/cloudera_manager.png
Normal file
BIN
docs/imgs/hue/cloudera_manager.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 31 KiB |
BIN
docs/imgs/hue/editor.png
Normal file
BIN
docs/imgs/hue/editor.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 26 KiB |
BIN
docs/imgs/hue/spark_sql_cdh6.png
Normal file
BIN
docs/imgs/hue/spark_sql_cdh6.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 120 KiB |
BIN
docs/imgs/hue/spark_sql_docker.png
Normal file
BIN
docs/imgs/hue/spark_sql_docker.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 108 KiB |
BIN
docs/imgs/hue/start.png
Normal file
BIN
docs/imgs/hue/start.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 35 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 36 KiB |
@ -15,3 +15,5 @@ In this section, you will learn how to setup and interact with kyuubi quickly.
|
||||
quick_start_with_beeline
|
||||
quick_start_with_jdbc
|
||||
quick_start_with_datagrip
|
||||
quick_start_with_hue
|
||||
|
||||
|
||||
@ -4,11 +4,115 @@
|
||||
|
||||
</div>
|
||||
|
||||
# Getting Started With Cloudera Hue
|
||||
# Getting Started with Kyuubi and Cloudera Hue
|
||||
|
||||
## What is Hue
|
||||
|
||||
docker run -it -p 8888:8888 gethue/hue:latest
|
||||
[Hue](https://gethue.com/) is an open source SQL Assistant for Databases & Data Warehouses.
|
||||
|
||||
http://localhost:8888/
|
||||
## Preparation
|
||||
|
||||

|
||||
### Get Kyuubi Started
|
||||
|
||||
[Get the server Started](quick_start.md) first before your try Hue with Kyuubi.
|
||||
|
||||
```bash
|
||||
Welcome to
|
||||
__ __ __
|
||||
/\ \/\ \ /\ \ __
|
||||
\ \ \/'/' __ __ __ __ __ __\ \ \____/\_\
|
||||
\ \ , < /\ \/\ \/\ \/\ \/\ \/\ \\ \ '__`\/\ \
|
||||
\ \ \\`\\ \ \_\ \ \ \_\ \ \ \_\ \\ \ \L\ \ \ \
|
||||
\ \_\ \_\/`____ \ \____/\ \____/ \ \_,__/\ \_\
|
||||
\/_/\/_/`/___/> \/___/ \/___/ \/___/ \/_/
|
||||
/\___/
|
||||
\/__/
|
||||
```
|
||||
|
||||
## Run Hue in Docker
|
||||
|
||||
Here we demo running Kyuubi on macOS and Hue on [Docker for Mac](https://docs.docker.com/docker-for-mac/),
|
||||
there are several known limitations of network, and you can find
|
||||
[workarounds from here](https://docs.docker.com/docker-for-mac/networking/#known-limitations-use-cases-and-workarounds).
|
||||
|
||||
### Configuration
|
||||
|
||||
1. Copy a configuration template from Hue Docker image.
|
||||
|
||||
```
|
||||
docker run --rm gethue/hue:latest cat /usr/share/hue/desktop/conf/hue.ini > hue.ini
|
||||
```
|
||||
|
||||
2. Modify the `hue.ini`
|
||||
|
||||
```ini
|
||||
[beeswax]
|
||||
# Kyuubi 1.1.x support thrift version from 1 to 10
|
||||
thrift_version=7
|
||||
# change to your username to avoid permissions issue for local test
|
||||
auth_username=chengpan
|
||||
|
||||
[notebook]
|
||||
[[interpreters]]
|
||||
[[[sql]]]
|
||||
name=SparkSQL
|
||||
interface=hiveserver2
|
||||
|
||||
[spark]
|
||||
# Host of the Spark Thrift Server
|
||||
# For macOS users, use docker.for.mac.host.internal to access host network
|
||||
sql_server_host=docker.for.mac.host.internal
|
||||
|
||||
# Port of the Spark Thrift Server
|
||||
sql_server_port=10009
|
||||
|
||||
# other configurations
|
||||
...
|
||||
```
|
||||
|
||||
### Start Hue in Docker
|
||||
|
||||
```
|
||||
docker run -p 8888:8888 -v $PWD/hue.ini:/usr/share/hue/desktop/conf/hue.ini gethue/hue:latest
|
||||
```
|
||||
|
||||
Go http://localhost:8888/ and follow the guide to create an account.
|
||||
|
||||

|
||||
|
||||
Having fun with Hue and Kyuubi!
|
||||
|
||||

|
||||
|
||||
### For CDH 6.x Users
|
||||
|
||||
If you are using CDH 6.x, there is a trick that CDH 6.x blocks Spark in default, you need to modify the configuration to
|
||||
overwrite the `desktop.app_blacklist` to remove this restriction.
|
||||
|
||||
Config Hue in Cloudera Manager.
|
||||
|
||||

|
||||
|
||||
Refer following configuration and tune it to fit your environment.
|
||||
```
|
||||
[desktop]
|
||||
app_blacklist=zookeeper,hbase,impala,search,sqoop,security
|
||||
use_new_editor=true
|
||||
[[interpreters]]
|
||||
[[[sparksql]]]
|
||||
name=Spark SQL
|
||||
interface=hiveserver2
|
||||
# other interpreters
|
||||
...
|
||||
[spark]
|
||||
sql_server_host=kyuubi-server-host
|
||||
sql_server_port=10009
|
||||
```
|
||||
|
||||
You need to restart the Hue Service to activate the configuration changes, and then Spark SQL will available in editor list.
|
||||
|
||||

|
||||
|
||||
Having fun with Hue and Kyuubi!
|
||||
|
||||

|
||||
|
||||
Loading…
Reference in New Issue
Block a user