Easysoft Data Access

How do I connect Birst to an ODBC Database?

Article:
01085
Last Reviewed:
7th January 2015
Revision:
1

Use the JDBC-ODBC Bridge with an Easysoft ODBC Driver to connect Birst to an ODBC Database, enabling you to analyse data stored in data stores such as MongoDB and Salesforce.com from your Birst dashboard.

Birst is a Java application. To interact with a data source such as Salesforce.com, a Java application uses a JDBC driver. (JDBC is a Java application programming interface (API) that connects Java to relational databases and other tabular data such as spreadsheets and flat files.)

Easysoft ODBC drivers use ODBC to connect to the database for which they provide access. ODBC is another data access technology, the Microsoft implementation of which is included with Windows.

The JDBC-ODBC Bridge allows a Java application using JDBC to access an ODBC driver. The JDBC-ODBC Bridge and ODBC driver do not have to be installed on the same machine.

Example: How to connect Birst to Salesforce.com

The components necessary to connect Birst to Salesforce.com are:

Birst <-> JDBC-ODBC Bridge <-> Salesforce.com ODBC Driver <-> Salesforce.com

Example: How to connect Birst to MongoDB

The components necessary to connect Birst to MongoDB are:

Birst <-> JDBC-ODBC Bridge <-> MongoDB ODBC Driver <-> MongoDB

The JDBC-ODBC Bridge, Salesforce.com ODBC Driver and MongoDB ODBC driver are available to download from the Easysoft web site.

Installing, Licensing and Testing the Easysoft ODBC Driver

  1. Download the Windows Salesforce.com ODBC Driver or Windows MongoDB ODBC Driver as required. (Registration required.)
  2. Install and license the Easysoft ODBC Driver on a Windows machine.

    For installation instructions, see the Salesforce.com ODBC Driver documentation or MongoDB ODBC Driver documentation.

Before you can use the Easysoft ODBC Driver to connect Birst to Salesforce.com or MongoDB, you need to configure a System ODBC data source. An ODBC data source stores the connection details for the target database (e.g. Salesforce.com) and the ODBC driver that is required to connect to it (e.g. the Salesforce.com ODBC driver).

To run ODBC Administrator on 32-bit Windows, open Administrative Tools in Control Panel, and then open Data Sources (ODBC). (On older versions of Windows, the Control Panel applet that launches ODBC Administrator is labelled Data Sources.)

To run ODBC Administrator on 64-bit Windows, in the Windows Run dialog box, type:

%windir%\syswow64\odbcad32.exe

If you are not sure whether your version of Windows is 32-bit or 64-bit, follow the instructions for running ODBC Administrator on 64-bit Windows. If you get an error, follow the instructions for 32-bit Windows instead.

Use ODBC Administrator to create your ODBC Driver data source.

Creating a Salesforce.com ODBC Data Source

  1. Choose the System DSN tab, and then choose Add.
  2. In the Create New Data Source dialog box, choose Easysoft ODBC-Salesforce Driver, and then choose Finish.
  3. Complete the Easysoft ODBC-Salesforce Driver DSN Setup dialog box:
    SettingValue
    DSNSalesforce.com
    User NameThe name of your Salesforce.com user. For example, myuser@mydomain.com.
    PasswordThe password for your Salesforce.com user.
    TokenThe security token for your Salesforce.com user, if required.

    To find out whether you need to supply a security token, choose the Test button. If the connection attempt fails with an error which contains LOGIN_MUST_USE_SECURITY_TOKEN, you need to supply one.

    Salesforce.com emails the security token to the email address associated with your Salesforce.com user account. If you have not received a security token, you can regenerate it. Salesforce.com will then email the new security token to you. To regenerate your security token, log in to Salesforce.com and then choose Setup from the user menu. Search for "security token" in the Quick Find box. Click Reset Security Token in the Reset Security Token page. When you receive the token in your email client, copy it and then paste it into the Token field.

  4. Use the Test button to verify that you can successfully connect to Salesforce.com.

Creating a MongoDB ODBC Data Source

  1. Choose the System DSN tab, and then choose Add.
  2. In the Create New Data Source dialog box, choose Easysoft ODBC-MongoDB Driver, and then choose Finish.
  3. Complete these fields Easysoft ODBC-MongoDB Driver DSN Setup dialog box:
    SettingValue
    DSNMongoDB
    DescriptionEasysoft MongoDB ODBC Driver
    ServerThe name or IP address of the host where your MongoDB instance is running.
    User NameIf you need to supply a user name to access your MongoDB database, enter it here.
    PasswordThe password for your MongoDB user name.
  4. Use the Test button to verify that you can successfully connect to your MongoDB database.

Installing and Licensing the JDBC-ODBC Bridge

  1. Download the JDBC-ODBC Bridge. (Registration required.)
  2. Install and license the JDBC-ODBC Bridge on the machine where the Salesforce.com ODBC driver is installed.

    For installation instructions, see the JDBC-ODBC Bridge documentation.

Connecting Birst to your ODBC Database

You can now connect Birst to Salesforce.com or MongoDB:

  1. Log into birst.com.
  2. Create a new space.
  3. In the Welcome page, choose Use Birst Connect.
  4. Launch the default configuration. Download both BirstConnect.zip and the .jlnp that launching the configuration generates.
  5. On a Windows machine where Java is installed, create a top-level folder named BirstConnect. For example:

    c:\BirstConnect

  6. Copy BirstConnect.zip and the .jlnp file to this new folder.
  7. Extract the contents of BirstConnect.zip.
  8. Copy EJOB.jar to the the <drive>:\BirstConnect\dist\lib folder.

    EJOB.jar is installed in the following location on the machine where you installed the JDBC-ODBC Bridge:

    <easysoft_install>\Jars

    On 32-bit Windows, the default location for <easysoft_install> is <drive>:\Program Files\Easysoft Limited\Easysoft JDBC-ODBC Bridge.

    On 64-bit Windows, the default location for <easysoft_install> is <drive>:\Program Files (x86)\Easysoft Limited\Easysoft JDBC-ODBC Bridge.

  9. In the BirstConnect folder, open BirstConnect.xml in a text editor.
  10. Edit these properties in BirstConnect.xml:
    PropertyValue
    JAVA_HOMEReplace %JAVA_HOME% with the location where Java is installed. For example, C:\Program Files\Java\jdk1.7.0_45.
    BirstConnect_Home<drive>:\BirstConnect
    -Djnlp.fileReplace BirstConnect.jnlp with the name of the .jnlp file that you have just generated.
  11. Open a command prompt and change to the <drive>:\BirstConnect folder.
  12. Type BirstConnect install to install the BirstConnect Service.
  13. In the commandline subfolder, open cmdUI.bat in a text editor. Change the settings in this file to match the ones you have just changed in BirstConnect.xml.
  14. In a command prompt, run cmdUI.bat.
  15. In Birst Connect, choose Add Task.
  16. In the Task Name box, type Easysoft.
  17. In the Sources tab, choose Add Table(s).
  18. Complete the dialog box as follows:
    SettingValue
    Database TypeGeneric JDBC Database
    Driver Nameeasysoft.sql.jobDriver
    Connection Stringjdbc:easysoft://localhost:8831/<my_odbc_system_dsn>:logonuser=<my_windows_user>:logonpassword=<my_windows_password>
  19. Choose the Get Tables button.
  20. Select the table you want and choose OK.
  21. Run your new task.

    The data is now available to Birst for processing.

Applies To

Knowledge Base Feedback

* Did this content help you?
* Please select one option based on your first choice:

(* Required Fields)