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.)
The components necessary to connect Birst to Salesforce.com are:
Birst <-> JDBC-ODBC Bridge <-> Salesforce.com ODBC Driver <-> Salesforce.com
The components necessary to connect Birst to MongoDB are:
Birst <-> JDBC-ODBC Bridge <-> MongoDB ODBC Driver <-> MongoDB
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:
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.
|User Name||The name of your Salesforce.com user. For example, firstname.lastname@example.org.|
|Password||The password for your Salesforce.com user.|
|Token||The 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
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.
|Description||Easysoft MongoDB ODBC Driver|
|Server||The name or IP address of the host where your MongoDB instance is running.|
|User Name||If you need to supply a user name to access your MongoDB database, enter it here.|
|Password||The password for your MongoDB user name.|
For installation instructions, see the JDBC-ODBC Bridge documentation.
You can now connect Birst to Salesforce.com or MongoDB:
EJOB.jar is installed in the following location on the machine where you installed the JDBC-ODBC Bridge:
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.
|-Djnlp.file||Replace BirstConnect.jnlp with the name of the .jnlp file that you have just generated.|
BirstConnect installto install the BirstConnect Service.
|Database Type||Generic JDBC Database|
The data is now available to Birst for processing.