(SSIS) To Oracle Autonomous Database (ADB) : Certification Matrix 12.2 or Higher
(SSIS) To Oracle Autonomous Database (ADB) : Certification Matrix 12.2 or Higher
Note: ODP.NET, Managed Driver supports Bulk Copy functionality starting with version 20.
1. This document assumes that the Autonomous Data Warehouse (ADW) or Autonomous
Transaction Processing (ATP) has been provisioned and the corresponding credentials.zip
file has been downloaded to the system that has SQL Server Data Tools (SSDT) installed. For
the Oracle documentation to provision ADWC please check here. Also check Downloading
Client Credentials (Wallets).
2. Follow the instructions from the SSIS documentation to install SSDT software on your
machine. As a prerequisite, make sure that you have installed the ODP.NET 12.2 or higher
on the SSDT environment. You can download ODP.NET separately or as part of the Oracle
Database Client for Windows. Note: If you are using unmanaged ODP.NET, you must use 32-
bit Oracle Client installation to match the fact that SSDT is a 32-bit app.
3. All connections to Autonomous Database use certificate-based authentication and
Transport Layer Security/Secure Sockets Layer (TLS/SSL). Copy the client credentials file that
you downloaded in step 1 to the system running SSDT and uncompress it into a secure
folder.
4. We first validate that the Oracle Database Client can communicate with ADB, and since it is
installed on the same system as the SSDT and SSIS, it ensures that SSIS connectivity to
Oracle is also configured correctly.
5. Steps 5, 6 and 7 configure and test the Oracle Database Client. Edit the sqlnet.ora file,
replacing “?/network/admin” with the name of the folder containing the client credentials.
For example:
6. Create the TNS_ADMIN system environment variable and set it to the location of the secure
folder containing the credentials file you saved in Step 3. The tnsnames.ora file provided
with the credentials zip file contains three database service names identifiable
as high, medium and low. The predefined service names provide different levels of
performance and concurrency for ADB.
sqlplus password/\"Password\"@ConnectString
or
sqlplus /nolog
sql> set define off
sql> connect username/password@connectString
8. SSDT and SSIS can use managed or unmanaged ODP.NET to connect to ADB. Transport Layer
Security (TLS) 1.2 support has been included in version 12.2 and higher.
9. Register managed or unmanaged Oracle Data Provider for .NET (ODP.NET) in the Global
Assembly Cache (GAC) so that it is recognized by .NET products, including SSDT. Note
that SSIS is a 32-bit application and we need to configure 32-bit ODP.NET for SSIS.
10. Open a command prompt in Administrator mode. You can do this by right-clicking on the
command prompt, then choosing “Run as administrator”.
11. Navigate to the <Oracle Home>\ODP.NET\managed\x86 directory and execute one of the
following commands.
• For managed ODP.NET:
Below is the output from running the above command with managed ODP.NET 19c. You should
see the following output or similar depending on the ODP.NET version and type you use:
12. Newer Visual Studio versions include SSDT as an installable extra option. Once installed,
SSDT is integrated into Visual Studio. Open Visual Studio and create a new SSIS project.
11. Right click on Connection Managers area at the bottom of the project and click on New
ADO.NET Connection…
12. In the Configure ADO.NET Connection Manager pop-up, click “New…” to create a new
connection.
13. In the .NET Provider tree control, pick “ODP.NET, Managed Driver” or “ODP.NET,
Unmanaged Driver”. Only the ODP.NET providers you have specifically configured with
the OraProvCfg utility will appear. Press OK.
14. Enter in your ADB net service name in Data Source (e.g. stats2_medium), user id (e.g.
admin), and password information into the respective fields.
15. click Test Connection
If you have successfully tested the connection, your SSIS project can connect to ADB.