Connecting to IBM Cloudant

IBM Cloudant is a distributed database based on open source Apache CouchDB. You can use the IBM Cloudant data connector to import your organization's IBM Cloudant data.

Before you start

Before you start the connection process, review the Windows DSN Configuration section in the CData documentation, and gather any connection prerequisites such as user name, password, token, or key values.

For help gathering the connection prerequisites, contact the IBM Cloudant administrator in your organization. If your administrator cannot help you, you or your administrator should contact IBM Cloudant Support.

Connection properties

Beyond basic connectivity and authentication, you can configure additional properties of the connection to the data source. For more information, see Connection Properties in the CData documentation.

Create an IBM Cloudant connection

1. From the Analytics main menu, select Import > Database and application.
2. From the New Connections tab, in the ACL DSN Connectors (Bundled) section, select IBM Cloudant.

   Tip

   You can filter the list of available connectors by entering a search string in the Filter connections box. Connectors are listed alphabetically.

   The DSN Configuration dialog box appears.

3. In the DSN Configuration dialog box, click Show Required or Basic.
4. Provide values for the required or basic fields, if any.
5. Click Test Connection.

   Note

   When you click the Test Connection button, it validates whether the connection and authentication details provided are correct. If you click OK without clicking Test Connection, the connection details are saved without any validation and may not work later if the values provided are incorrect.

6. If a log-in page appears, provide the required connection or authentication details.

   When the connection is successful, a dialog box opens displaying a success message.

7. Click OK in the dialog box that appears.

   The connection to IBM Cloudant is established successfully.

8. In the DSN Configuration dialog box, click OK.

The connection for IBM Cloudant is saved to the Existing Connections tab. In the future, you can reconnect to IBM Cloudant from the saved connection.

Once the connection is established, the Data Access window opens to the Staging Area and you can begin importing data. For help importing data from IBM Cloudant, see Working with the Data Access window.

Rename the connection

When you create the IBM Cloudant data connector, you cannot provide a Connection name of your choice and the connection is saved to the Existing Connections tab with the same name as your data source. If you want to rename it, navigate to the Existing Connections tab, expand the ACL DSN Connectors section, click the ellipsis icon corresponding to IBM Cloudant and select Rename connection.