Establishing a Connection
Enabling SSIS in Visual Studio 2022
If you're using Visual Studio 2022, you will need to install the SQL Server Integration Services Projects extension to use SSIS.
- Navigate to Extensions > Manage Extensions.
- In the Manage Extensions window's search box, search for "SQL Server Integration Services Projects 2022" and select the extension in the list.
- Click Download.
- Close Visual Studio and run the downloaded Microsoft.DataTools.IntegrationServices.exe installer. Proceed through the installer with default settings.
- Open Visual Studio. There should now be an "Integration Services Project" project template available.
Adding the Cloudant Connection Manager
Create a new connection manager as follows:
- Create a Visual Studio project with the "Integration Services Project" template.
- In the project, right-click within the Connection Managers window and select New Connection from the menu.
- In the Description column, select CData Cloudant Connection Manager and click Add...
- Configure the component as described in the next section.
Alternatively, if you have an existing project and CData Cloudant Source or CData Cloudant Destination:
- Right-click your CData Cloudant source or destination component in your data flow
- Select Edit... to open an editor window.
- Click the New... button next to the Connection manager: dropdown selector to create a connection manager.
- Configure the component as described in the next section.
Authenticating to Cloudant
Cloudant supports two types of authentication:- OAuth: Performs authentication based on the OAuth standard. Set AuthScheme to OAuth and supply the values for the Cloudant instance APIKey and URL.
- Basic: Basic username/password authentication. Set AuthScheme to Basic.
IBM Cloudant Legacy
To connect via IBM Cloudant Legacy, ensure that you have a valid IBM Cloudant service credential.To create an IBM Cloudant service credential:
- Log in to the IBM Cloud dashboard.
- Navigate to the Menu icon > Resource List, and open your IBM Cloudant service instance.
- In the menu, click Service credentials.
- Click New credential. Cloudant displays a Add new credential window.
- Enter a name for the new credential.
- Click Add. Your credentials are added to the Service credentials table.
- Click Actions > View credentials.
- Extract the values for User and Password from the JSON file.
Use the values you just obtained to set the User and Password.
Authenticating to a Local Instance
Cloudant supports authenticating to data in local instances from version 1.1.0 and above.To authenticate to your local instance, set these parameters: