Skip to content

Commit 577760a

Browse files
MikeRayMSFTMikeRayMSFT
committed
Merge branch 'patch-22' of https://github.com/JoshGer/sql-docs-pr into 20201103-JoshGer-patch-22
2 parents 55f07ae + 7301fa5 commit 577760a

1 file changed

Lines changed: 55 additions & 28 deletions

File tree

‎docs/reporting-services/report-data/oracle-connection-type-ssrs.md‎

Lines changed: 55 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Oracle Connection Type (SSRS & Power BI Report Server)"
33
description: Use the information in this article about the Oracle connection type to learn how to build a data source.
4-
ms.date: 03/12/2020
4+
ms.date: 10/11/2020
55
ms.prod: reporting-services
66
ms.prod_service: "reporting-services-native"
77
ms.technology: report-data
@@ -19,64 +19,91 @@ To use data from an Oracle database in your report, you must have a dataset that
1919

2020
Use the information in this article to build a data source. For step-by-step instructions, see [Add and Verify a Data Connection (Report Builder and SSRS)](../../reporting-services/report-data/add-and-verify-a-data-connection-report-builder-and-ssrs.md).
2121

22+
> [!IMPORTANT]
23+
> The following commands that use Oracle's OraProvCfg.exe tool to register Oracle's Managed and Unmanaged ODP.NET drivers are provided as examples for use with the above Microsoft products. For the configuration of the ODP.NET drivers specific to your environment, you may need to contact Oracle support or reference Oracle's documentation for [Configuring Oracle Data Provider for .NET](https://docs.oracle.com/en/database/oracle/oracle-database/19/odpnt/InstallConfig.html#GUID-1F689B90-2CC4-4907-B8FE-A5F4EE36F673).
2224
2325
## 64-bit drivers for the report servers
2426

25-
Power BI Report Server and SQL Server Reporting Services 2016 and later all use **Managed ODP.NET** for paginated reports. The following steps are only needed when using Oracle ODAC drivers 12.2 and later as they install by default to a non-machine-wide configuration for a new Oracle home installation. These steps assume you've installed the ODAC 18.x files to c:\oracle64 and the file version of your Oracle.ManagedDataAccess.dll and Oracle.DataAccess.dll is 4.122.18.3.
27+
On the Oracle download site, install the [Oracle 64-bit ODAC Oracle Universal Installer (OUI)](https://www.oracle.com/technetwork/topics/dotnet/downloads/odacdeploy-4242173.html). You only need the following steps when using Oracle ODAC drivers 12.2 and later. Otherwise, they install by default to a non-machine-wide configuration for a new Oracle home installation. These steps assume you've installed the ODAC 18.x files to the c:\oracle64 folder.
2628

27-
1. On the Oracle download site, install the [Oracle 64-bit ODAC Oracle Universal Installer (OUI)](https://www.oracle.com/technetwork/topics/dotnet/downloads/odacdeploy-4242173.html).
28-
2. Register ODP.NET Managed Client to GAC:
29+
30+
### Paginated (RDL) Reports use Managed ODP.NET
31+
32+
Power BI Report Server and SQL Server Reporting Services 2016 and later all use **Managed ODP.NET** for paginated (RDL) reports. Follow these steps to register Managed ODP.NET:
33+
34+
1. Register ODP.NET Managed Client to GAC:
35+
```
2936
3037
C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
31-
3. Add ODP.NET Managed Client entries to machine.config:
3238
33-
C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odpm /frameworkversion:v4.0.30319 /productversion:4.122.18.3
39+
```
40+
41+
2. Add ODP.NET Managed Client entries to machine.config:
42+
```
43+
44+
C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odpm /frameworkversion:v4.0.30319 /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
45+
46+
```
3447

3548
### Power BI Reports use Unmanaged ODP.NET
3649

37-
Power BI Reports use **Unmanaged ODP.NET**. Follow these steps to register Unmanaged ODP.NET:
50+
Power BI Report Server uses **Unmanaged ODP.NET** for Power BI reports. Follow these steps to register Unmanaged ODP.NET:
3851

3952
1. Register ODP.NET Unmanaged Client to GAC:
40-
41-
C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\Oracle.DataAccess.dll
53+
```
54+
C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\Oracle.DataAccess.dll
55+
```
4256
2. Add ODP.NET Unmanaged Client entries to machine.config:
57+
```
58+
C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odp /frameworkversion:v4.0.30319 /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\Oracle.DataAccess.dll
59+
```
4360

44-
C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odp /frameworkversion:v4.0.30319 /productversion:4.122.18.3
45-
4661
## 32-bit drivers for Report Builder
4762

48-
Report Builder uses **Managed ODP.NET** for authoring paginated reports. The following steps are only needed when using Oracle ODAC drivers 12.2 and later as they install by default to a non-machine-wide configuration for a new Oracle home installation. These steps assume you've installed the ODAC 18.x files to c:\oracle32 and the file version of your Oracle.ManagedDataAccess.dll is 4.122.18.3.
63+
Report Builder uses **Managed ODP.NET** for authoring paginated (RDL) reports. You only need the following steps when using Oracle ODAC drivers 12.2 and later. Otherwise, they install by default to a non-machine-wide configuration for a new Oracle home installation. These steps assume you've installed the ODAC 18.x files to the c:\oracle32 folder where Report Builder is installed. Follow these steps to register Managed ODP.NET:
64+
4965

5066
1. On the Oracle download site, install the [Oracle 32-bit ODAC Oracle Universal Installer (OUI)](https://www.oracle.com/technetwork/topics/dotnet/downloads/odacdev-4242174.html).
5167
2. Register ODP.NET Managed Client to GAC:
52-
53-
C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle32\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
68+
```
69+
C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle32\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
70+
```
5471
3. Add ODP.NET Managed Client entries to machine.config:
55-
56-
C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odpm /frameworkversion:v4.0.30319 /productversion:4.122.18.3
72+
```
73+
C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odpm /frameworkversion:v4.0.30319 /providerpath:C:\oracle32\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
74+
```
5775

5876
## 64-bit and 32-bit drivers for Power BI Desktop
5977

60-
Power BI Reports use **Unmanaged ODP.NET**. The following steps are only needed when using Oracle ODAC drivers 12.2 and later as they install by default to a non-machine-wide configuration for a new Oracle home installation. These steps assume you've installed the ODAC 18.x files to c:\oracle64 for 64-bit and c:\oracle32 for 32-bit and the file version of your Oracle.DataAccess.dll is 4.122.18.3. Follow these steps to register Unmanaged ODP.NET:
61-
62-
### 64-bit Power BI Desktop
78+
Power BI Desktop uses **Unmanaged ODP.NET** for authoring Power BI reports. You only need the following steps when using Oracle ODAC drivers 12.2 and later. Otherwise, they install by default to a non-machine-wide configuration for a new Oracle home installation. These steps assume you've installed the ODAC 18.x files to the c:\oracle64 folder for 64-bit Power BI Desktop or the c:\oracle32 folder for 32-bit Power BI Desktop. Follow these steps to register Unmanaged ODP.NET:
6379

64-
1. Register ODP.NET Unmanaged Client to GAC:
6580

66-
C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\Oracle.DataAccess.dll
67-
2. Add ODP.NET Unmanaged Client entries to machine.config:
81+
### 64-bit Power BI Desktop
6882

69-
C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odp /frameworkversion:v4.0.30319 /productversion:4.122.18.3
83+
1. On the Oracle download site, install the [Oracle 64-bit ODAC Oracle Universal Installer (OUI)](https://www.oracle.com/technetwork/topics/dotnet/downloads/odacdeploy-4242173.html).
84+
2. Register ODP.NET Unmanaged Client to GAC:
85+
```
86+
C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\Oracle.DataAccess.dll
87+
```
88+
3. Add ODP.NET Unmanaged Client entries to machine.config:
89+
```
90+
C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odp /frameworkversion:v4.0.30319 /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\Oracle.DataAccess.dll
91+
```
7092

7193
### 32-bit Power BI Desktop
7294

73-
1. Register ODP.NET Unmanaged Client to GAC:
95+
1. On the Oracle download site, install the [Oracle 32-bit ODAC Oracle Universal Installer (OUI)](https://www.oracle.com/technetwork/topics/dotnet/downloads/odacdev-4242174.html).
96+
2. Register ODP.NET Unmanaged Client to GAC:
97+
```
98+
C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\Oracle.DataAccess.dll
99+
```
100+
3. Add ODP.NET Unmanaged Client entries to machine.config:
101+
```
102+
C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odp /frameworkversion:v4.0.30319 /providerpath:C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\Oracle.DataAccess.dll
103+
104+
```
74105
75-
C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\Oracle.DataAccess.dll
76-
2. Add ODP.NET Unmanaged Client entries to machine.config:
77106
78-
C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odp /frameworkversion:v4.0.30319 /productversion:4.122.18.3
79-
80107
## <a name="Connection"></a> Connection String
81108
Contact your database administrator for connection information and for the credentials to use to connect to the data source. The following connection string example specifies an Oracle database on the server named "Oracle18" using Unicode. The server name must match what is defined in the Tnsnames.ora configuration file as the Oracle server instance name.
82109

0 commit comments

Comments
 (0)