SSRS と Power BI レポート サーバーを使用して Oracle 接続の種類を設定する

適用対象: SQL Server 2016 (13.x) Reporting Services 以降 Power BI Report Builder Power BI Report Server

Oracle データベースのデータをレポート内で使用するには、種類が Oracle のレポート データ ソースに基づいたデータセットが必要です。 このビルトイン データ ソースの種類は、Oracle Data Provider を直接使用し、Oracle クライアント ソフトウェア コンポーネントが必要です。 この記事では、Reporting Services、Power BI Report Server、レポート ビルダー、Power BI Desktop のドライバーをダウンロードしてインストールする方法について説明します。

この記事の情報を使用して、データ ソースを構築してください。 ステップ バイ ステップの手順については、「データ接続を追加および確認する (レポート ビルダーおよび SSRS)」を参照してください。

重要

Oracle の Managed および Unmanaged ODP.NET ドライバーの登録に Oracle の OraProvCfg.exe ツールを使用する次のコマンドは、上記の Microsoft 製品で使用する例として提供しています。 お使いの環境に固有の ODP.NET ドライバーの構成については、Oracle のサポートに問い合わせるか、.NET 用の Oracle Data Provider の構成 に関する Oracle のドキュメントを参照する必要があります。

レポート サーバー用の 64 ビット ドライバー

Oracle ダウンロード サイトで、Oracle 64-bit ODAC Oracle Universal Installer (OUI) をインストールします。 Oracle Data Access Components (ODAC) ドライバー 12.2 以降を使用している場合は、次の手順のみが必要です。 それ以外の場合、新しい Oracle ホームのコンピューター全体ではない構成に既定でインストールされます。

前提条件: ODAC 18.x ファイルを c:\oracle64 フォルダーにインストールされていること。

マネージド ODP.NET を使用するページ分割された (RDL) レポート

Power BI Report Server と SQL Server Reporting Services 2016 以降では、ページ分割された (RDL) レポートに対していずれも Managed ODP.NET を使用します。

マネージド ODP.NET の登録:

  1. マネージド クライアント ODP.NET グローバル アセンブリ キャッシュ (GAC) に登録します。

    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
    
  2. ODP.NET Managed Client エントリを machine.config に追加します。

    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
    

Power BI レポートにアンマネージドの ODP.NET を使用する

Power BI Report Server は、Power BI のレポートに Unmanaged ODP.NET を使用します。

アンマネージドの ODP.NET を登録します:

  1. ODP.NET Unmanaged Client を GAC に登録します。

    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
    
  2. ODP.NET Unmanaged Client エントリを machine.config に追加します。

    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
    

Microsoft レポート ビルダー用の 32 ビット ドライバー

Microsoft Report Builder は、ページ分割された (RDL) レポートの作成に、Managed ODP.NET を使用します。 Oracle ODAC ドライバー 12.2 以降の次の手順のみが必要です。 それ以外の場合、新しい Oracle ホームのコンピューター全体ではない構成に既定でインストールされます。

前提条件: Microsoft レポート ビルダーがインストールされている c:\oracle32 フォルダーに ODAC 18.x ファイルがインストールされていること。

マネージド ODP.NET の登録:

  1. Oracle ダウンロード サイトで、Oracle "ODAC with Oracle Developer Tools for Visual Studio - OUI" (32 ビット) をインストールします。

  2. ODP.NET Managed Client を GAC に登録します。

    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
    
  3. ODP.NET Managed Client エントリを machine.config に追加します。

    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
    

Power BI レポート ビルダー用の 64 ビット ドライバー

Note

次の手順は、Power BI レポート ビルダー バージョン 15.7.01678.0001 以降に適用されます。 15.7.01678.0001 より前のバージョンについては、Microsoft レポート ビルダー用 32 ビット ドライバー の指示に従ってください。

Power BI Report Builder は、ページ分割された (RDL) レポートの作成に、Managed ODP.NET を使用します。 Oracle ODAC ドライバー 12.2 以降の次の手順のみが必要です。 それ以外の場合、新しい Oracle ホームのコンピューター全体ではない構成に既定でインストールされます。

前提条件: Power BI Report Builder がインストールされている c:\oracle64 フォルダーに ODAC 18.x ファイルがインストールされていること。

マネージド ODP.NET の登録:

  1. Oracle ダウンロード サイトで、Oracle 64-bit ODAC Oracle Universal Installer (OUI) をインストールします。

  2. ODP.NET Managed Client を GAC に登録します。

    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
    
  3. ODP.NET Managed Client エントリを machine.config に追加します。

    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
    

Power BI Desktop 用の 64 ビットと 32 ビットのドライバー

Power BI Desktop は、Power BI のレポートの作成に Unmanaged ODP.NET を使用します。 Oracle ODAC ドライバー 12.2 以降の次の手順のみが必要です。 それ以外の場合、新しい Oracle ホームのコンピューター全体ではない構成に既定でインストールされます。

前提条件: 64 ビットの Power BI Desktop には c:\oracle64 フォルダーに、32 ビットの Power BI Desktop には c:\oracle32 フォルダーに、ODAC 18.x ファイルがインストールされていること。

アンマネージドの ODP.NET を登録します:

64 ビット Power BI Desktop

  1. Oracle ダウンロード サイトで、Oracle 64-bit ODAC Oracle Universal Installer (OUI) をインストールします。

  2. ODP.NET Unmanaged Client を GAC に登録します。

    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
    
  3. ODP.NET Unmanaged Client エントリを machine.config に追加します。

    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
    

32 ビット Power BI Desktop

  1. Oracle ダウンロード サイトで、Oracle "ODAC with Oracle Developer Tools for Visual Studio - OUI" (32 ビット) をインストールします。

  2. ODP.NET Unmanaged Client を GAC に登録します。

    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
    
  3. ODP.NET Unmanaged Client エントリを machine.config に追加します。

    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
    

接続文字列

データ ソースへの接続するための接続情報および認証情報については、データベース管理者に問い合わせてください。 次に示す接続文字列の例では、Unicode を使用して Oracle18 というサーバー上の Oracle データベースを指定しています。 このサーバー名は、Tnsnames.ora 構成ファイルで Oracle サーバー インスタンス名として定義されたものと一致する必要があります:

Data Source="Oracle18"; Unicode="True"  

接続文字列の例の詳細については、「Report Builder でデータ接続文字列を作成する」を参照してください。

資格情報

クエリの実行、ローカルでのレポートのプレビュー、およびレポート サーバーからのレポートのプレビューには、認証情報が必要です。

レポートをパブリッシュした後、レポートをレポート サーバーで実行するときに、データを取得するための権限が有効な状態になるように、データ ソースの資格情報を変更する必要が生じる場合があります。

詳細については、「レポート データ ソースに関する認証情報と接続情報を指定する」をご覧ください。

クエリ

データセットを作成するには、ボックスの一覧からストアド プロシージャを選択するか、SQL クエリを作成します。 クエリを作成するには、テキストベースのクエリ デザイナーを使用する必要があります。 詳細については、「テキスト ベースのクエリ デザイナーのユーザー インターフェイス (Report Builder)」を参照してください。

結果セットを 1 つだけ返すストアド プロシージャを指定できます。 カーソル ベースのクエリはサポートされていません。

パラメーター

クエリにクエリ変数が含まれている場合は、対応するレポート パラメーターが自動的に生成されます。 この拡張機能では、名前付きパラメーターがサポートされています。 Oracle バージョン 9 以降では、複数値パラメーターがサポートされています。

レポート パラメーターは、既定のプロパティ値を使用して作成されます。この既定のプロパティ値は、変更が必要になることがあります。 たとえば、各レポート パラメーターのデータ型は Textです。 レポート パラメーターを作成した後に、既定値の変更が必要になる場合があります。 詳細については、「Report Builder のページ割り付けレポートのパラメーター」を参照してください。

解説

Oracle データ ソースに接続するには、システム管理者が、Oracle データベースからのデータの取得をサポートするバージョンの .NET Data Provider for Oracle をインストールする必要があります。 データ プロバイダを Report Builder と同じコンピュータにインストールし、レポート サーバーにもインストールする必要があります。

詳細については、次の記事をご覧ください。

代替データ拡張機能

OLE DB のデータ ソースの種類を使用して、Oracle データベースからデータを取得できます。 詳細については、「OLE DB の接続の種類 (SSRS)」を参照してください。

レポート モデル

Oracle データベースに基づくモデルを作成できます。

プラットフォームおよびバージョン情報

プラットフォームとバージョンのサポートについて詳しくは、「Reporting Services でサポートされるデータ ソース (SSRS)」をご覧ください。