-
Notifications
You must be signed in to change notification settings - Fork 3.1k
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.
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
HBase Connection Registry usage with Phoenix JDBC url #24869
base: master
Are you sure you want to change the base?
Conversation
I have run Edit: updated test to use new format for ZK ConnectionRegistry. RPC Registry for test is facing errors because in docker env, clients can exhaust master with RPC threadpool while it is already running in-house chores. |
2cfd35e
to
9f24500
Compare
Looks good. +1 |
Thanks @lhofhansl! FYI @stoty if you would also like to take a look. |
LGTM. Note that in most cases the default jdbc:phoenix URL should be used, as the cluster can be determined from the hbase / hadoop config files that must be present on the classpath anyway for for correct operation. |
@@ -79,7 +79,6 @@ private TestingPhoenixServer() | |||
try { | |||
MiniZooKeeperCluster zkCluster = this.hbaseTestingUtility.startMiniZKCluster(); | |||
port = zkCluster.getClientPort(); | |||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
revert
(phoenix-connection-url)= | ||
### `phoenix.connection-url` | ||
|
||
phoenix.connection-url supports multiple formats: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@mosabua ptal for wording
(phoenix-connection-url)= | ||
### `phoenix.connection-url` | ||
|
||
phoenix.connection-url supports multiple formats: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The connection URL for Phoenix set with phoenix.connection-url
supports multiple formats:
| `phoenix.config.resources` | No | Comma-separated list of configuration files (e.g. `hbase-site.xml`) to use for connection properties. These files must exist on the machines running Trino. | | ||
| `phoenix.max-scans-per-split` | No | Maximum number of HBase scans that will be performed in a single split. Default is 20. Lower values will lead to more splits in Trino. Can also be set via session propery `max_scans_per_split`. For details see: [https://phoenix.apache.org/update_statistics.html](https://phoenix.apache.org/update_statistics.html). (This setting has no effect when guideposts are disabled in Phoenix.) | | ||
| `phoenix.server-scan-page-timeout` | No | The time limit on the amount of work single RPC request can do before it times out. Type: [](prop-type-duration). | | ||
|
||
(phoenix-connection-url)= | ||
### `phoenix.connection-url` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Connection URL:
### `phoenix.connection-url` | |
### Connection URL: |
### `phoenix.connection-url` | ||
|
||
phoenix.connection-url supports multiple formats: | ||
1. `jdbc:phoenix[:zk_quorum][:zk_port][:zk_hbase_path][:principal][:keytab][;options]`. Connection uses HBase Zookeeper Registry. The `zk_quorum` is a comma separated list of ZooKeeper servers. The `zk_port` is the ZooKeeper port. The `zk_hbase_path` is the HBase root znode path, that is configurable using `hbase-site.xml`. By default the location is `/hbase`. Principal, Keytab and Options are optional. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Change this whole list into an item list and wrap at 80 char width so we can actually review wording.
Like
* `jdbc:phoenix[:zk_quorum][:zk_port][:zk_hbase_path][:principal][:keytab][;options]`:
Connection uses HBase Zookeeper Registry. The `zk_quorum` is a comma separated
list of ZooKeeper servers. The `zk_port` is the ZooKeeper port. The
`zk_hbase_path` is the HBase root znode path, that is configurable using
`hbase-site.xml`. By default the location is `/hbase`. Principal, Keytab and
Options are optional.
* `jdbc:phoenix+zk[:host1\:port1][,:host2\:port2]...[,:hostN\:portN][:zk_hbase_path][:principal][:keytab][;options]`:
Uses same Connection as above, however host:port pairs are separated by comma.
...
@@ -47,11 +47,22 @@ The following Phoenix-specific configuration properties are available: | |||
|
|||
| Property name | Required | Description | | |||
|------------------------------------| -------- |--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | |||
| `phoenix.connection-url` | Yes | `jdbc:phoenix[:zk_quorum][:zk_port][:zk_hbase_path]`. The `zk_quorum` is a comma separated list of ZooKeeper servers. The `zk_port` is the ZooKeeper port. The `zk_hbase_path` is the HBase root znode path, that is configurable using `hbase-site.xml`. By default the location is `/hbase` | | |||
| `phoenix.connection-url` | Yes | Detailed description: [](phoenix-connection-url). | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| `phoenix.connection-url` | Yes | Detailed description: [](phoenix-connection-url). | | |
| `phoenix.connection-url` | Yes | See [](phoenix-connection-url). | |
@@ -47,11 +47,22 @@ The following Phoenix-specific configuration properties are available: | |||
|
|||
| Property name | Required | Description | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ideally we change this whole list into a list-table .. but that could be a separate commit before or after .. or even a separate PR
9024a1a
to
d09425c
Compare
Host names refers to HMaster server names, port refers to HMaster port. | ||
Principal, Keytab and Options are optional. | ||
|
||
PHOENIX-6523 introduced support for various Connection Registries. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Remove this line
Description
Use various HBase Connection Registries with Phoenix JDBC url formats. Document with recommendations and use in test.
Additional context and related issues
Release notes
( ) This is not user-visible or is docs only, and no release notes are required.
( ) Release notes are required. Please propose a release note for me.
( ) Release notes are required, with the following suggested text: