IBM Cloud Docs
Apache Phoenix

Apache Phoenix

Apache Phoenix is a relational database layer over HBase, enabling SQL-like queries by using JDBC.

Prerequisites to configure the Apache Phoenix data source:

  • Access to Phoenix Query Server (PQS).
  • A running PQS service.
  • Appropriate access credentials.
  • Network connectivity to the PQS endpoint.

Configure the following details for Apache Phoenix data source:

Register data source
Field Description
Display name Enter the data source name to be displayed on the screen.
Hostname Enter the hostname.
Port Enter the port number.
Port is SSL enabled Use the toggle switch to enable or disable SSL connection. If enabled,
i. The Upload SSL certificate (.pem, .crt, .cert or .cer) link is enabled.
ii. Click the Upload SSL certificate (.pem, .crt, .cert or .cer) link.
iii. Browse the SSL certificate and upload.
Associate catalog Select the checkbox to associate a catalog to the data source. This catalog serves as your query interface with the data stored within.
Catalog name Enter the name of the catalog.
Create Click Create to create the data source.

Limitations for SQL statements

  • For data source-based catalogs the CREATE SCHEMA, CREATE TABLE, DROP SCHEMA, DROP TABLE, DELETE, DROP VIEW, ALTER TABLE, and ALTER SCHEMA statements are not available in the Data Manager UI.

Limitations for data types

  • When the fields of data type REAL have 6 digits or more in the decimal part with the digits being predominately zero, the values when queried are rounded off. It is observed that the rounding off occurs differently based on the precision of the values. For example, a decimal number 1.654 when rounded to 3-digits after the decimal point are the same. Another example is 10.890009 and 10.89000. It is noticed that 10.89000 is rounded to 10.89, whereas 10.89009 is not rounded off. This is an inherent issue because of the representational limitations of binary floating point formats. This might have a significant impact when querying involves sorting.