Getting Started with ODBC driver for Salesforce

ODBC is a widely used Application Programming Interface (API) that allows any application on the client computer to access any data source on the server using SQL.

In an ODBC architecture, applications connect to an ODBC driver manager, which in turn uses a specific ODBC driver to connect to a data source. The client part of the driver that works directly with the application must strictly comply with the ODBC standard. The application doesn't care what database management system (DBMS) is installed on the server. The server part of the driver is adapted to a specific database. Due to this architecture, there is no need to configure the application for a specific DBMS.

Advantages of ODBC driver for Salesforce

Native Data Connectivity

Native Data Connectivity

The Salesforce ODBC Driver fully supports standard ODBC API functions and data types and provides easy access to live Salesforce data from anywhere. Also, the driver is compatible with the Salesforce API itself.

Real-Time Data Access

Real-Time Data Access

The driver allows accessing data directly from the ODBC-compliant application in real-time which provides a dynamic workspace that adapts and changes as quickly as your data.

Integration

Integration

The driver is compatible with database management solutions, analytics and reporting tools, programming languages, and IDEs. That allows you to view, update, manage, and edit your data with the tool you are working on.

Platforms Variety

Platforms Variety

You can use the ODBC driver for Salesforce with your 32-bit or 64-bit application on both x32 and x64 Windows, Linux, and macOS. No additional driver or application configurations are required.

Secure Connection

Secure Connection

The driver enables different ODBC-supporting applications to connect to Salesforce directly through HTTPS. If there is no direct access, a connection can be established through the proxy server.

Step 1. Installation Process

The Devart ODBC driver is easy to install. All you need is to download the ODBC driver for Salesforce on your computer and follow the installation wizard instructions below.

Windows

Download the installation executive file of the ODBC driver for Salesforce, open it, and follow the installation wizard instructions step-by-step.

Windows

On the Select Components page, select the needed version of the driver. If you need it, you can also check the box to install Help and Manual.

Windows

In the License Information dialog box, you should select the license type and activate the product. For evaluation, you can also choose Trial if you have no activation key. If you have this, select the Activation Key option and insert it into the edit box.

Windows

Instead, if you have an Activation key file on your computer, you can browse it by clicking the Load Activation key button.

Windows

Then, take just 3 steps: click Next -> Install -> Finish. That’s all.

You can also use a Silent Installation with an OEM license on Windows to install the ODBC driver for Salesforce.

Linux

You can install the ODBC driver for Salesforce on Linux using two installer packages, depending on the distribution you are using.

If you want to install the ODBC driver for Salesforce on Ubuntu, which is a popular open-source Linux distribution based on Debian, then you need to install a .deb package corresponding to the bitness of your operating system. There are also two ways to install the driver either manually or via the command line.

GUI Installation

  1. Download the .deb package of the required bitness from the Devart website.
  2. Navigate to the folder with the downloaded package and double-click it.
  3. In the opened dialog, click the Install button
  4. Ubuntu
  5. If the installation is successfully completed, the Install button changes into the Remove one.

Command-line Installation

  1. After the driver is installed, run the 'Terminal' program.
  2. Navigate to the folder with the downloaded package cd ~/Downloads (if you downloaded the package into another folder, specify the path to this folder as the cd command parameter):
  3. cd ~/Downloads/
  4. To install the devartodbcsalesforce_amd64.deb on a 64-bit system, use the following command:
  5. sudo dpkg -i devartodbcsalesforce_amd64.deb
  6. If the driver is installed successfully, you will receive the following message:
  7. Ubuntu

If you use a CentOS distributive, then you should download the .rpm package and install it via the command line.

  1. Download the RPM package from the Devart website (The package will be downloaded into the ~/Downloads folder by default).
  2. Run the 'Konsole' program.
  3. Navigate to the folder with the downloaded package cd ~/Downloads (If it is another folder, specify the path to it as the cd command parameter):
  4. cd ~/Downloads/
  5. To install the devart-odbc-salesforce.x86_64.rpm on a 64-bit system, use the following command:
  6. sudo rpm -ivh devart-odbc-salesforce.x86_64.rpm
  7. If the driver is installed successfully, you will receive the following message:
  8. CentOS

macOS

  1. Download the PKG file from the Devart website.
  2. Run the downloaded file and follow the instructions in the wizard.
  3. macOS
  4. After reading the license agreement, click Agree to proceed with the installation.
  5. In the License Information dialog box, you should select the license type and activate the product. If you have no activation key, you can select Trial and use the driver for evaluation purposes. If you have an activation key, select the Activation Key option. Copy the activation key from the registration email or your Customer Portal account and paste it into the Activation Key edit box.
  6. macOS
  7. If you have the activation key file, click the Load Activation Key button and browse to it.
  8. Then click Continue > Install.

Configuring ODBC Data Source Name

After the ODBC driver for Salesforce is installed, you should create a Data Source Name (DSN) for your ODBC connection and test whether it succeeds.

Windows

Open the ODBC Data Source Administrator and select the User DSN or System DSN tab. Most applications work with both types, but some require a specific one. Click Add. In the appeared dialog box, select an ODBC driver for Salesforce and click Finish. In the opened driver setup dialog, enter the connection information in the appropriate fields.

There are two types of authentication here: basic and based on the token.

Basic Authentication

If you choose this way, you need to specify your Salesforce username, password, and security token. By default, a security token is required, but you can make it optional by allowing a range of trusted IP addresses. To gain access to your security token, go to Setup in the top right corner, open the drop-down My Personal Information and choose Reset My Security Token.

Basic Authentication

Token-Based Authentication

Here you should Sign In with Salesforce and enter your credentials to log in and generate a refresh token.

Token-Based Authentication

Linux

To configure the ODBC driver for Salesforce on Linux, open the odbc.ini file located in the /etc folder. Find the DEVART_SALESFORCE section and specify the required connection settings:

User ID=< your Salesforce User Name>
Password=< your Salesforce password>
Server=< your Salesforce server address>
Port=< your Salesforce Port>
Database=< your Salesforce database name>

macOS

To configure the ODBC driver for Salesforce on macOS, run the iODBC utility of the required bitness. Find the DEVART_SALESFORCE section and click the Configure button:

macOS configuring

In the appeared dialog, specify the required connection settings and click OK.

macOS configuring

Step 3. Test ODBC Connection

Windows

To test an ODBC connection on Windows, you need just click the Test Connection button in the Configuration dialog. A successful connection message should appear.

Linux

To test the connection with the Salesforce server, run the UnixODBC Test Command utility and test a connection using the following command:.

isql -v DEVART_SALESFORCE

If the connection is successful, you will receive the following message:

Linux ODBC Connection test

macOS

Сlick the Test button to establish a test connection to your data source.

macOS ODBC test connection