JDBC, ODBC TUTORIAL

How to Build Tableau Reports on Salesforce Data using the DataDirect Salesforce Drivers

Updated: 19 Jan 2023

Introduction

Progress DataDirect’s Salesforce ODBC and JDBC Drivers offer a high-performing, secure, and reliable connectivity solution, for ODBC and JDBC applications to access Salesforce data. If you want to use our ODBC and JDBC Salesforce Drivers with the Tableau Desktop application, Progress DataDirect has you covered. This tutorial will teach you how to configure the DataDirect Salesforce ODBC and JDBC driver within Tableau Desktop to create reports. These steps can also configure any ODBC and JDBC connection with Tableau.

 

Prerequisites for ODBC

This tutorial assumes that you have ODBC drivers installed and a data source configured. If you have not yet done these steps, please follow these instructions:  

 

  1. 1. Download and install the Progress DataDirect Salesforce ODBC driver for your database using the 15-day trial software. In this tutorial, we are connecting to Salesforce.  

 

  1. 2. Configure a data source for your database. See the DataDirect documentation for assistance with setting up your data source. The sample below uses a data source. 

 

Configure Connection to Salesforce Driver Using the Configuration Manager

1. After the DataDirect Salesforce ODBC driver has been installed, open ODBC Administrator to configure the connection and click on "Add." 

 

 

 

2. Choose the “DataDirect X.X Salesforce” driver and click on “Finish.” 

 

 

 

3. You should now see the ODBC Salesforce Driver Setup pop-up window launched. Add your Data Source Name, hostname, username, and other credentials, and click on “Apply” and then “Test Connect.”If you are connecting to a sandbox instance use “test.salesforce.com” as Host Name. If your instance does not require a security token to connect, leave it blank. 

 

 

 

4. A Logon Dialog will pop up. Enter your username and password and click on “OK.” 

 

 

 

5. A pop-up window will confirm that the connection is established. 

 

 

Connect to an ODBC Datasource

1. Start Tableau and select the “Other Databases (ODBC)” option.  

 

 

 

2. In the pop-up window select the “DSN” radial button and choose the data source previously configured to connect to Salesforce in the dropdown and click on “Connect.”  

 

 

 

3. The Logon Dialog will reappear. Provide hostname, schema map, username, and password again, and click on “OK.”  

 

 

 

4. Enter any additional parameters required to connect to your Salesforce data sources, such as a username and password, and select “Sign In.”  

 

          
 

 

Prerequisites for JDBC

Download and install the Progress DataDirect Salesforce JDBC driver using the 15-day trial software. In this tutorial, we are connecting to Salesforce. 

 

Connecting Tableau to a JDBC Datasource

1. To get started, copy sforce.jar from the Progress install location to Tableau’s driver location.  

 

  • For Windows: copy sforce.jar to C:\Program Files\Tableau\Drivers  
  • For Mac: copy sforce.jar to ~/Library/Tableau/Drivers 

 

2. Open Tableau and create a new data source.   

 

  • Select “Other Databases (JDBC).”  

 

 

  • The pop-up window will appear.  

 

 

  • Enter your Salesforce connection URL in the textbox. The URL will look something like:  
     

jdbc:datadirect:sforce://login.salesforce.com;User=; 
Password=;  

 

  • Enter credentials for username and password, and click on “Sign In.”  

 

Installing the JDBC driver

1. After the driver has been downloaded: 

 

  • If you are on Windows, extract the PROGRESS_DATADIRECT_JDBC_SALESFORCE_WIN.zip and run the PROGRESS_DATADIRECT_JDBC_INSTALL.exeto install the JDBC driver.   
  • If you are on Linux, extract the PROGRESS_DATADIRECT_JDBC_SALESFORCE_WIN.zip and run the PROGRESS_DATADIRECT_JDBC_INSTALL.jarto start the installation.   

 

2. After you have completed the installation, you can find the Progress DataDirect Salesforce jar file.   

 

  • On Windows, you will find it at C:\Program Files\Progress\DataDirect\JDBC_60\lib\sforce.jar   
  • On Linux, you will find it at ~/home/<username>/Progress/DataDirect/JDBC_60/lib/sforce.jar 

 

Building the Report in Tableau

1. Select “Sign In” and the Tableau configuration screen should now appear.