Qubole Hive

Connectivity Summary

An out of the box connector is available for Qubole Hive databases. It provides support for crawling database objects, profiling of sample data and lineage building.

The connectivity to Qubole Hive is via JDBC driver, which is included in the platform. 

The connector currently supports the following versions of Qubole Hive:

Edition: no-awssdk

Version: 1.0x

The drivers used by the connector are given below:

Driver / API: Qubole Hive JDBC Driver

Version: 1.0 (Latest version is 2.0)

Details: Is JDBC 1.0 https://s3.amazonaws.com/Qubole Hive-downloads/drivers/jdbc/1.2.41.1065/Qubole HiveJDBC42-no-awssdk-1.2.41.1065.jar

Connector Capabilities

The connector capabilities are shown below:

Crawling

Please see this article Crawling Data for more details on crawling.  Supported objects and data types for Crawling are:

Supported Objects Supported Data Types
Tables, Table Columns, Views TINYINT, SMALLINT, INT, BIGINT, VARCHAR, CHAR, Timestamp, DATE

Profiling

Please see Profiling Data for more details on profiling.

Feature

Support

Remarks

Table Profiling

Row count, Columns count, View sample data

 

View Profiling

Row count, Columns count, View sample data

View is treated as a table for profiling purposes

Column Profiling

Min, Max, Null count, distinct, top 50 values

 

Full Profiling 

Supported

 

Sample Profiling

Supported

 

Lineage Building

Lineage Entities Details

Table lineage

Supported

Column lineage

Supported

Lineage Sources

Stored procedures, functions, views, query logs

Querying 

Operation 

Details

Select

Supported

Insert

Not supported, by default.

Update

Not supported, by default.

Delete

Not supported, by default.

Joins within database

Supported

Joins outside database

Not supported

Aggregations

Supported

Group By

Supported

Order By

Supported

By default the service account provided for the connector will be used for any query operations. If the service account has write privileges, then Insert / Update / Delete queries can be executed.

Pre-requisites

To use the connector, the following need to be available:

  • Connection details as specified in the following section should be available.
  • Service account with read privileges.
  • JDBC driver is provided by default. In case it needs to be changed, add Qubole Hive client drivers into the OvalEdge Jar path to communicate to the Qubole Hive database. 

Check the Configuration section for further details on how to add the drivers to the jar path.

Connection Details

The following connection settings should be added for connecting to a Qubole Hive database:

  • Database Type: Qubole Hive
  • License Type: Standard
  • Connection Name: Select a Connection name for the Qubole Hive database. The name that you specify is a reference name to easily identify your Qubole Hive database connection in OvalEdge. Example: Qubole Hive Connection1
  • Qubole Endpoint: Qubole endpoint
  • Cluster Label: Name of the database to connect.
  • Driver: com.qubole.jdbc.jdbc41.core.QDriver
  • API Token: Qubole API Token
  • Connection String: Qubole Hive  connection string. Set the Connection string toggle button to automatic, to get the details automatically from the credentials provided. Alternatively, you can manually enter the string.
    Format:jdbc:qubole://hive/{clusterLabel}?endpoint={server}
    Example:jdbc:qubole://hive/default?endpoint=https://us.qubole.com

Once connectivity is established, additional configurations for Crawling and Profiling can be specified.

Property

Details

Crawler configurations

Tables, views columns

By default it is selected true

Crawler rules

Default include tables regex has  regex = (.*) , which can crawl all the tables

Profile Settings

Tables and columns

By default it is selected true

Views and columns

By default it is selected true

Profile Rules

Default include tables regex has  regex = (.*) , which can profile all the tables