Skip to content

ZEPPELIN-1452: Include Phoenix 'thin client' instructions in docs #1436

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
randerzander wants to merge 5 commits into from
Closed

ZEPPELIN-1452: Include Phoenix 'thin client' instructions in docs #1436

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
38b1692
Updated JDBC docs to include Phoenix thin client
randerzander Sep 19, 2016
d2720c3
tweaked jdbc readme
randerzander Sep 19, 2016
2964ba8
Update jdbc.md
randerzander Sep 19, 2016
6e2dff0
Update jdbc.md
randerzander Sep 19, 2016
3ed029e
Update jdbc.md
randerzander Sep 20, 2016
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 40 additions & 2 deletions docs/interpreter/jdbc.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -269,38 +269,76 @@ To develop this functionality use this [method](http://docs.oracle.com/javase/7/
</table>

### Phoenix
#### Properties

Phoenix supports `thick` and `thin` connection types:

- Thick client is faster, but must connect directly to ZooKeeper and HBase RegionServers.
- Thin client has fewer dependencies and connects through a [Phoenix Query Server](http://phoenix.apache.org/server.html) instance.

Use the appropriate `phoenix.driver` and `phoenix.url` for your connection type.

Copy link
Contributor

@AhyoungRyu AhyoungRyu Sep 20, 2016

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @randerzander. Thanks for your contribution!

Probably it's a nitpick, currently those 4 lines are rendered like below,
screen shot 2016-09-20 at 4 16 59 pm

So how about changing the 4 lines to like this? (You can just copy&paste if you want :D )

Phoenix supports `thick` and `thin` connection types:

 - Thick client is faster, but must connect directly to ZooKeeper and HBase RegionServers.
 - Thin client has fewer dependencies and connects through a [Phoenix Query Server](http://phoenix.apache.org/server.html) instance.

Use the appropriate `phoenix.driver` and `phoenix.url` for your connection type.

Then it will be rendered
screen shot 2016-09-20 at 4 17 14 pm

Copy link
Contributor Author

@randerzander randerzander Sep 20, 2016

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Makes sense. I included your suggestion in the latest commit.

#### Properties:
<table class="table-configuration">
<tr>
<th>Name</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>phoenix.driver</td>
<td>org.apache.phoenix.jdbc.PhoenixDriver</td>
<td>'Thick Client', connects directly to Phoenix</td>
</tr>
<tr>
<td>phoenix.driver</td>
<td>org.apache.phoenix.queryserver.client.Driver</td>
<td>'Thin Client', connects via Phoenix Query Server</td>
</tr>
<tr>
<td>phoenix.url</td>
<td>jdbc:phoenix:localhost:2181:/hbase-unsecure</td>
<td>'Thick Client', connects directly to Phoenix</td>
</tr>
<tr>
<td>phoenix.url</td>
<td>jdbc:phoenix:thin:url=http://localhost:8765;serialization=PROTOBUF</td>
<td>'Thin Client', connects via Phoenix Query Server</td>
</tr>
<tr>
<td>phoenix.user</td>
<td>phoenix_user</td>
<td></td>
</tr>
<tr>
<td>phoenix.password</td>
<td>phoenix_password</td>
<td></td>
</tr>
</table>
#### Dependencies
#### Dependencies:

Include the dependency for your connection type (it should be only *one* of the following).

<table class="table-configuration">
<tr>
<th>Artifact</th>
<th>Excludes</th>
<th>Description</th>
</tr>
<tr>
<td>org.apache.phoenix:phoenix-core:4.4.0-HBase-1.0</td>
<td></td>
<td>'Thick Client', connects directly to Phoenix</td>
</tr>
<tr>
<td>org.apache.phoenix:phoenix-server-client:4.7.0-HBase-1.1</td>
<td></td>
<td>'Thin Client' for Phoenix 4.7, connects via Phoenix Query Server</td>
</tr>
<tr>
<td>org.apache.phoenix:phoenix-queryserver-client:4.8.0-HBase-1.2</td>
<td></td>
<td>'Thin Client' for Phoenix 4.8+, connects via Phoenix Query Server</td>
</tr>
</table>

Expand Down