Share this article:


Vertica Integration with IBM Cognos Analytics: Connection Guide

About Vertica Connection Guides

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 version of Vertica and one 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 those other versions.

Vertica and Cognos Analytics: Versions Tested

Software Version
Partner Product

IBM Cognos 11 Analytics Release 11.1.5

Desktop Platform

Windows Server 2016

Vertica Client

Vertica JDBC 10.0.0-0

Vertica Server

Vertica Database 10.0.0-0

Cognos Analytics Overview

IBM Cognos Analytics is a web-based solution for building applications that perform reporting and analysis. You can use Cognos Analytics on cloud or on-prem.

For details about IBM Cognos Analytics, see the IBM Cognos Analytics documentation.

Installing Cognos Analytics

You can download and install a free trial of Cognos Analytics for cloud deployment. Follow these steps:

  1. Navigate to the Cognos Analytics Support portal.
  2. Check the prerequisites and follow the instructions on the download page.

Installing the Vertica JDBC Driver

IBM Cognos Analytics server uses the Vertica JDBC driver to connect to Vertica. To install the JDBC driver:

  1. Navigate to the Vertica Client Drivers page.
  2. Download the JDBC driver.

    Note For details about client and server compatibility, see Client Driver and Server Version Compatibility in the Vertica documentation.

  3. Place the JDBC .jar file in the Cognos driver directory:


Note If you want to upgrade the JDBC driver version, you must repeat these steps to replace the .jar file.

Connecting Cognos Analytics to Vertica

  1. Open the Cognos Analytics home page:


  2. Click Manage and then click Data server connections.
  3. Click the plus (+) sign to add a data server:

  4. From the list of databases, select Vertica:

  5. Provide the database connection name and JDBC URL, and then click Test.

    When the connection is successful, the Success button turns green:

  6. Click Save.
  7. Click the Schemas tab.
  8. Select the schema and click Load metadata.

  9. Once the tables are loaded, you can see the status and the table count.

  10. Select New and click Data module.

  11. Click Data Servers and Schemas and select Vertica:

  12. Select the schema and click OK.

  13. Click Select tables and click Next.

  14. Select the tables you want to include in your data module and click OK.

  15. The tables appear in your newly created Data module. You may now create reports or dashboards using this module.

Known Limitations


  • For TIME, TIMESTAMP, TIMETZ, and TIMESTAMPTZ data types, milliseconds are not supported.

  • NUMERIC data type is supported up to 40 digits.

For More Information

Share this article: