Connecting with JDBC

Sisense provides a generic Java Database Connectivity (JDBC) connector that you can configure to import data from JDBC sources such as Postgres or Hive. JDBC is one of the most widely supported Java APIs for connecting to a variety of relational databases.

To import data from a JDBC source, you need a connection string that defines the location of the database and the necessary properties required for accessing the database. See Creating a Connection String for more information.

Keep in mind that each data source has its own requirements for connecting to it via JDBC. You must refer to their documentation for this information.

In addition, you need to extract your JDBC driver into a folder you create in the directory:


For example, if your using JDBC to connect to a Postgres database:


The folder in this example is called postgresqldriver, and it should contain your JAR files.

To import data from a JDBC data source:

  1. In the Data page, open an ElastiCube or create a new ElastiCube.
  2. In the Model Editor, click . The Add Data dialog box is displayed.

  3. Click JDBC to open the JDBC settings.
  4. In Connection String, enter the URL of your JDBC data source. See Creating a Connection String for more information.
  5. In JDBC JARs Folder, enter the name of the directory where the JDBC’s JAR files are located. For example, if you called the directory postgresqldriver, the value of this field would be postgresqldriver. This directory must be located in ...\ProgramData\Sisense\DataConnectors\jdbcdrivers\.
  6. In Driver's Class Name, enter the location of your JDBC driver. This is the name of the class that provides a basic service for managing your JDBC drivers. It should be provided by the provider of your JDBC's driver.
  7. In User Name and Password, enter your credentials to the JDBC data source. These fields are not required if the user name and password were provided in the connection string.

  8. Click Next. A list of tables in the database are displayed. All tables and views associated with the database will appear in a new window.
  9. From the Tables list, select the relevant table or view you want to work with. You can click next to the relevant table or view to see a preview of the data inside it.
  10. (Optional) Click + to customize the data you want to import with SQL. See Importing Data with Custom Queries for more information.
  11. After you have selected all the relevant tables, click Done. The tables are added to your schema.

Creating a Connection String

With JDBC, a database is represented by a connection string, or URL, that defines its location and additional properties.

The connection string required to connect to a JDBC data source varies according to the requirements of that particular provider. You should check the provider’s documentation for details regarding their requirements.

For example, a JDBC connection string to Hive has the form described below:

jdbc:subprotocol://host:port;Property1=Value;Property2= Value;…

For Hive, your connection string should include the following:

After you have created a connection string, it should look something like this:


Another example is Postgres, who also supports connections through JDBC.

A connection string to a Postgres data source has the following form:


For Postgres, your connection string should include the following:

See Postgres’ JDBC documentation for more information.

JDBC Authentication

If you are using any browser-based authentication, for example, OAuth, while connecting to your data source with the JDBC connector, the JDBC configuration file needs to be updated.

In the description.json file located in the following directory: 

C:\Program Files\Sisense\DataConnectors\JVMContainer\Connectors\GenericJDBC\

the value "startAsUser" should be set to true and the JVM service must be restarted.

"provider": "GenericJDBC",
"displayName": "Generic JDBC",
"version": "1.1.0",
"category": "Database",
"isAccumulativeSupported": true,
"isLiveSupported": false,
"isCountableSupported": true,
"isWebECMSupported": true,
"startAsUser": true, 
"jdbcDriversPath": "C:\\ProgramData\\Sisense\\DataConnectors\\jdbcdrivers",
"jdbcDriversPathLinux": "/opt/sisense/storage/jdbcdrivers"

This value uses the credentials of the user trying to authenticate instead of the Sisense system user.