|Share this article:|
Vertica Integration with Slemma: Connection Guide
Vertica connection guides provide basic information about setting up connections to Vertica from software that our technology partners create. These documents provide guidance using one specific version of Vertica and one specific version of the third party vendor’s software. Other versions of the third-party product may work with Vertica. However, we may not have tested these other versions.
Slemma and Vertica Product Versions
This document provides guidance using the software listed as follows:
Pre-configured by Slemma
Slemma is a SaaS product for business intelligence.
For information about Slemma, visit the Slemma website. On the website, you will find tutorials and other resources to help you start learning about Slemma.
To request a free trial of Slemma on the cloud or on premises, click TRY SLEMMA NOW on the Slemma website.
About the Client Driver
Slemma uses JDBC to connect to Vertica. Slemma provides the Vertica JDBC driver automatically with the product.
Note You do not need to download and install the Vertica JDBC driver to use Slemma with Vertica.
Connect Slemma to Vertica
- Log in to Slemma.
Click the Data sources button, then click the plus sign (+) at the bottom of the page.
- Click Vertica to add it as a new data source.
On the GENERAL tab, provide the connection information for Vertica.
Before clicking the CHECK CONNECTION button, make sure that your database is either on a public network that is accessible from the internet or that your firewall is configured to allow the address 22.214.171.124 to connect to your server.
If your database is on a private network and you do not want it to be accessed from the internet, you can set up an SSH tunnel for the connection to Vertica.
Note If you do not enable an SSH tunnel for your private network, you will see this error when you click CHECK CONNECTION:
For private networks, follow these steps to enable an SSH tunnel:
On the SECURITY tab, check Use SSH tunnel.
- On your Vertica Server machine, open a Linux terminal and execute the SSH tunnel command shown above.
- Return to the Slemma GUI and click the TEST button to verify that you can establish a connection to Vertica.
- On the SECURITY tab, check Use SSH tunnel.
- Click the CHECK CONNECTION button.
In the DATA REFRESH tab, you can schedule automatic data refresh or specify manual refresh.
To refresh manually, change the value of Update rate to Manual.
For details, see Refreshing the Data.
In the ADVANCED Tab, you can set JDBC connection properties for Vertica.
For details, see JDBC Connection Properties in the Vertica documentation.
Click the CONNECT button to create a connection to Vertica.
Note A Vertica connection in Slemma is called a data source or an integration.
Visualize Vertica Data in Slemma
Follow these steps to create a dashboard that present Vertica data in Slemma.
- To create a new dashboard, select Dashboards and click the plus sign (+) at the bottom of the page.
Under Templates, click the plus sign (+) to create a new blank template.
- To create a chart in the dashboard, click Insert, then click Chart.
Select your Vertica data source.
To visualize data from a single table or view, select it from the list under Select a Table or View.
To select data from multiple tables, select Write SQL Query under Create View.
If you select Write SQL Query, the query editor opens.
- Write your query and click Run. If the query does not run properly, correct it and click Run again.
- When the query runs successfully, click Next.
Choose the chart type. In this example, we have selected Simple table.
To configure the table, select Add A FIELD for each field you want to include.
To complete the visualization, click APPLY, then click DONE.
If you want to save the visualization for future use, click the Save button.
For more details about building charts, see How to Build a Chart in the Slemma documentation.
The Slemma engine caches data in cloud storage. When Slemma executes a query through the UI or creates a dataset for a chart, it loads the data as follows:
- Executes the query in the database.
- Stores the resulting dataset in the cache.
- Loads the dataset from the cache to the UI.
Slemma does not refresh the dataset unless you refresh it manually or configure automatic refreshes. The following refresh options are available:
- Manually refresh a dashboard or dataset
- Schedule automatic refresh for a dashboard or a dataset
Manually Refresh a Dashboard
- Right-click the dashboard and select Refresh now.
- On the Confirm dialog box, click OK.
Manually Refresh a Dataset
Right-click the dataset and select Refresh now.
All the charts based on this dataset are updated.
When you configure Slemma to automatically refresh your Vertica data, Slemma performs the refresh at 00.00 local time every 24 hours by default. This behavior applies to all datasets created from a Vertica data source (integration).
Automatically Refresh a Dashboard
- Right-click the dashboard and select Schedule refresh.
A list of all the integrations and datasets used in the dashboard displays.
- Select an integration or dataset.
- To refresh the data immediately, click Refresh now.
To schedule the refresh, click Schedule refresh.
Select the scheduling options.
- Repeat for each integration and dataset that you want to refresh.
Automatically Refresh a Dataset
- Right-click the dataset and select Schedule refresh.
- Change the scheduling settings.
The dynamic filtering feature in Slemma lets you filter data for display based on criteria that you specify.
With dynamic filtering, you can deploy the same dashboards and datasets for different purposes or for different users. For example, you could implement dynamic filtering to display only regional sales figures to individual sales reps, although all the sales data is present in the data source.
To learn how to implement dynamic filtering, see the Slemma documentation.
Slemma supports four basic data types: String, Number, Date, and Geography. Slemma converts Vertica data types as follows:
- Binary, Varbinary, and Long Varbinary are not supported. Slemma converts these data types to String.
- TimeTZ and Time are rounded off by milliseconds.
- Time zone offsets are not supported for TimestampTz.
- Numbers that have more than 16 digits are rounded off. For example:
79228162514264337593543950335is rounded to
7922816251426433759354395.0335is rounded to
- Digits to the right of the decimal point are rounded off to two digits. For example:
‑99999999999999.9999is rounded to
99999.99999is rounded to
- Some decimal values are rounded off. For example:
‑99999999999999.9999is rounded to
99999.99999is rounded to
- Slemma supports the Float data type, but rounds off very large float values. For example:
- 1.797693134862312+308 is displayed as Infinity
Data type conversion in Slemma is summarized as follows:
|Vertica Data Type||Data Type in Slemma|
|Interval Day To Second||String|
|Interval Year To Month||String|