Skip to content

Commit 59f4988

Browse files
v-shilsv-shils
authored
Merge pull request #17771 from MikeRayMSFT/20201103-JoshGer-patch-22
Incorporate recent updates
2 parents 5d4ead0 + 4e298d2 commit 59f4988

1 file changed

Lines changed: 81 additions & 47 deletions

File tree

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

Lines changed: 81 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,10 @@
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: 11/03/2020
55
ms.prod: reporting-services
66
ms.prod_service: "reporting-services-native"
77
ms.technology: report-data
8-
9-
108
ms.topic: conceptual
119
ms.assetid: 9db86dd2-beda-42d8-8af7-2629d58a8e3d
1210
author: maggiesMSFT
@@ -19,118 +17,154 @@ To use data from an Oracle database in your report, you must have a dataset that
1917

2018
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).
2119

20+
> [!IMPORTANT]
21+
> 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).
2222
2323
## 64-bit drivers for the report servers
2424

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.
25+
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.
2626

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:
2927

30-
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:
28+
### Paginated (RDL) Reports use Managed ODP.NET
29+
30+
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:
3231

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
32+
1. Register ODP.NET Managed Client to GAC:
33+
34+
```
35+
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
36+
```
37+
38+
2. Add ODP.NET Managed Client entries to machine.config:
39+
40+
```
41+
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
42+
```
3443

3544
### Power BI Reports use Unmanaged ODP.NET
3645

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

3948
1. Register ODP.NET Unmanaged Client to GAC:
4049

50+
```
4151
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
52+
```
4253
2. Add ODP.NET Unmanaged Client entries to machine.config:
4354

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-
55+
```
56+
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
57+
```
58+
4659
## 32-bit drivers for Report Builder
4760

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.
61+
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:
4962

5063
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).
64+
5165
2. Register ODP.NET Managed Client to GAC:
5266

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
67+
```
68+
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
69+
```
70+
5471
3. Add ODP.NET Managed Client entries to machine.config:
5572

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
73+
```
74+
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
75+
```
5776

5877
## 64-bit and 32-bit drivers for Power BI Desktop
5978

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:
79+
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:
6180

6281
### 64-bit Power BI Desktop
6382

64-
1. Register ODP.NET Unmanaged Client to GAC:
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:
6585

86+
```
6687
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:
88+
```
6889

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
90+
3. Add ODP.NET Unmanaged Client entries to machine.config:
91+
92+
```
93+
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
94+
```
7095

7196
### 32-bit Power BI Desktop
7297

73-
1. Register ODP.NET Unmanaged Client to GAC:
98+
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).
99+
100+
2. Register ODP.NET Unmanaged Client to GAC:
74101

102+
```
75103
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:
104+
```
105+
106+
3. Add ODP.NET Unmanaged Client entries to machine.config:
107+
108+
```
109+
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
110+
```
77111

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-
80112
## <a name="Connection"></a> Connection String
81-
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.
113+
114+
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.
82115

83116
```
84117
Data Source="Oracle"; Unicode="True"
85118
```
86119

87-
For more connection string examples, see [Create data connection strings - Report Builder & SSRS](../../reporting-services/report-data/data-connections-data-sources-and-connection-strings-report-builder-and-ssrs.md).
120+
For more connection string examples, see [Create data connection strings - Report Builder & SSRS](../../reporting-services/report-data/data-connections-data-sources-and-connection-strings-report-builder-and-ssrs.md).
88121

89122
## <a name="Credentials"></a> Credentials
90-
Credentials are required to run queries, to preview the report locally, and to preview the report from the report server.
91-
92-
After you publish your report, you may need to change the credentials for the data source so that when the report runs on the report server, the permissions to retrieve the data are valid.
123+
Credentials are required to run queries, to preview the report locally, and to preview the report from the report server.
93124

94-
For more information, see [Specify Credential and Connection Information for Report Data Sources](specify-credential-and-connection-information-for-report-data-sources.md).
125+
After you publish your report, you may need to change the credentials for the data source so that when the report runs on the report server, the permissions to retrieve the data are valid.
95126

127+
For more information, see [Specify Credential and Connection Information for Report Data Sources](specify-credential-and-connection-information-for-report-data-sources.md).
96128

97129
## <a name="Query"></a> Queries
98-
To create a dataset, you can either select a stored procedure from a drop-down list or create an SQL query. To build a query, you must use the text-based query designer. For more information, see [Text-based Query Designer User Interface &#40;Report Builder&#41;](../../reporting-services/report-data/text-based-query-designer-user-interface-report-builder.md).
130+
To create a dataset, you can either select a stored procedure from a drop-down list or create an SQL query. To build a query, you must use the text-based query designer. For more information, see [Text-based Query Designer User Interface &#40;Report Builder&#41;](../../reporting-services/report-data/text-based-query-designer-user-interface-report-builder.md).
99131

100-
You can specify stored procedures that return only one result set. Using cursor-based queries aren't supported.
132+
You can specify stored procedures that return only one result set. Using cursor-based queries aren't supported.
101133

102134
## <a name="Parameters"></a> Parameters
103-
If the query includes query variables, corresponding report parameters are automatically generated. Named parameters are supported by this extension. For Oracle version 9 or later, multivalue parameters are supported.
135+
136+
If the query includes query variables, corresponding report parameters are automatically generated. Named parameters are supported by this extension. For Oracle version 9 or later, multivalue parameters are supported.
104137

105138
Report parameters are created with default property values that you might need to modify. For example, each report parameter is data type **Text**. After the report parameters are created, you might have to change default values. For more information, see [Report Parameters &#40;Report Builder and Report Designer&#41;](../../reporting-services/report-design/report-parameters-report-builder-and-report-designer.md).
106139

107-
108140
## <a name="Remarks"></a> Remarks
109-
Before you can connect an Oracle data source, the system administrator must have installed the version of the .NET Data Provider for Oracle that supports retrieving data from the Oracle database. This data provider must be installed on the same computer as Report Builder and also on the report server.
141+
142+
Before you can connect an Oracle data source, the system administrator must have installed the version of the .NET Data Provider for Oracle that supports retrieving data from the Oracle database. This data provider must be installed on the same computer as Report Builder and also on the report server.
110143

111-
For more information, see the following articles:
144+
For more information, see the following articles:
112145

113-
- [How to use Reporting Services to configure and to access an Oracle data source](/archive/blogs/dataaccesstechnologies/configure-oracle-data-source-for-sql-server-reporting-services-ssdt-and-report-server)
114-
- [How to add permissions for the NETWORK SERVICE security principal](https://support.microsoft.com/kb/870668)
146+
- [How to use Reporting Services to configure and to access an Oracle data source](/archive/blogs/dataaccesstechnologies/configure-oracle-data-source-for-sql-server-reporting-services-ssdt-and-report-server)
147+
- [How to add permissions for the NETWORK SERVICE security principal](https://support.microsoft.com/kb/870668)
115148

116149
### Alternate Data Extensions
117-
118-
You can also retrieve data from an Oracle database by using an OLE DB data source type. For more information, see [OLE DB Connection Type &#40;SSRS&#41;](../../reporting-services/report-data/ole-db-connection-type-ssrs.md).
150+
151+
You can also retrieve data from an Oracle database by using an OLE DB data source type. For more information, see [OLE DB Connection Type &#40;SSRS&#41;](../../reporting-services/report-data/ole-db-connection-type-ssrs.md).
119152

120153
::: moniker range=">=sql-server-2017||=sqlallproducts-allversions"
121-
### Report Models
154+
155+
### Report Models
122156

123157
You can also create models based on an Oracle database.
124158
::: moniker-end
125-
159+
126160
### Platform and Version Information
127161

128-
For more information about platform and version support, see [Data Sources Supported by Reporting Services &#40;SSRS&#41;](../../reporting-services/report-data/data-sources-supported-by-reporting-services-ssrs.md).
162+
For more information about platform and version support, see [Data Sources Supported by Reporting Services &#40;SSRS&#41;](../../reporting-services/report-data/data-sources-supported-by-reporting-services-ssrs.md).
129163

130-
131164
## See Also
132165

133-
[Report Parameters &#40;Report Builder and Report Designer&#41;](../../reporting-services/report-design/report-parameters-report-builder-and-report-designer.md)
134-
[Filter, Group, and Sort Data &#40;Report Builder and SSRS&#41;](../../reporting-services/report-design/filter-group-and-sort-data-report-builder-and-ssrs.md)
135-
[Expressions &#40;Report Builder and SSRS&#41;](../../reporting-services/report-design/expressions-report-builder-and-ssrs.md)
136-
166+
[Report Parameters &#40;Report Builder and Report Designer&#41;](../../reporting-services/report-design/report-parameters-report-builder-and-report-designer.md)
167+
168+
[Filter, Group, and Sort Data &#40;Report Builder and SSRS&#41;](../../reporting-services/report-design/filter-group-and-sort-data-report-builder-and-ssrs.md)
169+
170+
[Expressions &#40;Report Builder and SSRS&#41;](../../reporting-services/report-design/expressions-report-builder-and-ssrs.md)

0 commit comments

Comments
 (0)