Manage the Apache Phoenix Connector

This applies to: Visual Data Discovery

The Symphony Apache Phoenix connector lets you access the data available in your Apache Phoenix storage using the Symphony client. The Symphony Apache Phoenix connector supports Apache Phoenix version 4.7 and Apache Phoenix Query Server 4.7. Apache Phoenix v4.5 requires a separate download. To obtain a connector for Apache Phoenix 4.4, contact Technical Support.

Before you can establish a connection from Symphony to Apache Phoenix, a Symphony connector server for it needs to be installed, configured and enabled. See Manage Connectors and Connector Servers for general instructions and Connect to Apache Phoenix for details specific to the Apache Phoenix and Apache Phoenix Query Server connectors.

After the connector has been set up, you can create data source configurations that specify the necessary connection information and identify the data you want to use. See Manage Visual Data Discovery Data Source Configurations for more information. After data sources are configured, they can be used to create dashboards and visuals from your data. See Create Data Discovery Dashboards.

Feature Support

Connector support for specific features is shown in the following table.

Key: Y - Supported; N - Not Supported; N/A - not applicable

Feature	Supported?	Notes
Admin-Defined Functions	Y
Box Plots	N
Custom SQL Queries	Y	If you need to access a BigQuery partition, explicitly include an alias for the built in partition column in your select clause, such as `select *, _PARTITIONTIME as pt from projectId.datasetId.tableId`.
Derived Fields (Row-Level Expressions)	Y	Apache Phoenix and Apache Phoenix Query Server connectors support row-level expressions (derived fields) with the following limitations: The filter IS NULL does not work properly on grouped fields. The LOCATE text row-level function only supports a constant as a argument. A COALESCE conditional row-level function specified with and empty argument does not work properly. If the CASE conditional row-level function returns a null value as a an argument of another function, a NullPointerException may occur. The LPAD and RPAD text row-level functions are not supported.
Distinct Counts	Y
Fast Distinct Values	N/A
Group By Multiple Fields	Y
Group By Time	Y
Group By UNIX Time	Y
Histogram Floating Point Values	Y
Histograms	Y
Kerberos Authentication	Y/N	Apache Phoenix supports Kerberos, but Apache Phoenix Query Server does not. For more information, see Enable Kerberos Authentication for Apache Phoenix Connectors.
Last Value	N
Live Mode and Playback	Y
Multivalued Fields	N/A
Nested Fields	N/A
Partitions	N/A
Pushdown Joins for Fusion Data Sources	N
Schemas	Y
Text Search	N/A
TLS	Y
User Delegation	N
Wildcard Filters	Y
Wildcard Filters, Case-Insensitive Mode	Y
Wildcard Filters, Case-Sensitive Mode	Y

Connect to Apache Phoenix

For Apache Phoenix, specify the JDBC URL in the following format:

jdbc:phoenix:<zk_quorum>:<zk_port>:<zk_hbase_path>

where:

<zk_quorum> is a comma separated list of the ZooKeeper servers
<zk_port> is the ZooKeeper port
<zk_hbase_path> is the path used by HBase to stop information about the instance

For Apache Phoenix Query Server, specify the JDBC URL in the following format:

jdbc:phoenix:thin:url=<scheme>://<server-hostname>:<port>

where:

<scheme> is a transport protocol for communication with the server
<server-hostname> is the name of the host offering the microservice
<port> is the port number on which the host is listening