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 Oracle OCI 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 Oracle OCI Connection Manager and click Add...
- Configure the component as described in the next section.
Alternatively, if you have an existing project and CData Oracle OCI Source or CData Oracle OCI Destination:
- Right-click your CData Oracle OCI 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.
Connecting to Oracle OCI
Oracle OCI supports the following connection types:- Oracle Server
- OracleTNS
- LDAP
Oracle Server
After you have added the appropriate libraries to your PATH (as described in Before You Connect), set these properties:- User: The user Id provided for authentication with the Oracle database.
- Password: The password provided for authentication with the Oracle database.
- Port: The port used to connect to the server hosting the Oracle database.
- ServiceName: The service name of the Oracle database. You can obtain this value by querying global_name (select * from global_name) using the Oracle SQL*PLUS command line.
- Server: The host name or IP address of the server hosting the Oracle database.
OracleTNS
To authenticate via OracleTNS, set these properties:- User: The user Id provided for authentication with the Oracle database.
- Password: The password provided for authentication with the Oracle database.
- DataSource: The connect descriptor (TNS connect string) or a connection name identifies the database you need to connect to. You can find these values in your tnsnames.ora file.
For example,
DataSource='(DESCRIPTION=(ADDRESS=(protocol_address_information))(CONNECT_DATA= (SERVICE_NAME=service_name)))'
LDAP
To authenticate via the LDAP server, set these properties.- User: The user Id of a user account associated with the Oracle database.
- Password: The password associated with the specified user account.
- LDAPUri: The LDAP URI associated with the LDAP server you want to connect to.
- LDAPUser: The name of the user account on the specified LDAP server that you want to use to connect to Oracle OCI data.
- Optional if your system administrator allows anonymous LDAP logins.
- LDAPPassword: The password associated with the specified LDAP user.
- Optional if your system administrator allows anonymous LDAP logins.
Your connection string should look similar to this:
LDAPUri=ldap://myldap.com:389/SERVICE_EXMPL,cn=OracleContext,dc=example,dc=com; User=ORACLEUSER; Password=OracleUserPassword;