Oracle Data Provider for .NET管理対象ドライバのインストール

ODP.NET管理対象ドライバの導入

ODP.NET管理対象ドライバの導入には、Windowsインストーラ、Oracle Universal Installer (OUI)、XCopyまたはNuGetのいずれかを使用します。

OUIを使用する場合: 次のOracle Universal Installer (OUI)のステップに従って、ODP.NET管理対象ドライバをインストールします。

XCopyを使用する場合: インストールを開始するディレクトリにODP.NET管理対象ドライバの.zipファイルをダウンロードします。この.zipファイルには、XCopyのインストール手順を説明したREADMEファイルが含まれています。

次のいずれかのディレクトリにあるconfigure.batスクリプトを実行します。

32ビット.NET Frameworkの場合: OH\odp.net\managed\x86
64ビット.NET Frameworkの場合: OH\odp.net\managed\x64

ODP.NET管理対象ドライバの構成を解除する場合や、マシンから削除する場合のために、各ディレクトリにはunconfigure.batが含まれます。

NuGetを使用している場合: ODP.NET NuGetパッケージをダウンロードし、NuGet Package Managerを使用してインストールします。

次のNuGetパッケージを使用できます。

ODP.NET管理対象ドライバ
Code FirstおよびEntity Framework 6以上用のEntity Frameworkアセンブリは、ODP.NET管理対象ドライバを使用します。

Windowsインストーラを使用している場合: Microsoft Windowsインストーラ(MSI)のステップに従い、ODP.NET管理対象ドライバをインストールします。

ODP.NET管理対象ドライバのファイル

ODP.NET管理対象ドライバには、次のファイルが含まれています。

表2-1 ODP.NET管理対象ドライバのファイルと説明

ファイル	説明
`Oracle.ManagedDataAccess.dll`	プラットフォームに依存しない(AnyCPU)、完全管理のADO.NETプロバイダ
`\Resources\<lang>\Oracle.ManagedDataAccess.resources.dll`	プラットフォームに依存しない(AnyCPU)、完全管理のADO.NETプロバイダのリソースDLL
`OraProvCfg.exe`	ODP.NET管理対象ドライバおよび管理対象外ドライバの構成/構成解除を行うための、プラットフォームに依存しない(AnyCPU)ユーティリティ
`configure.bat`	ODP.NET管理対象ドライバをGACに配置し、構成エントリをmachine.configに追加するためのバッチ・ファイル
`unconfigure.bat`	ODP.NET管理対象ドライバをGACから削除し、構成エントリをmachine.configから削除するためのバッチ・ファイル
`tnsnames.ora`	データソースのエイリアスを定義するサンプル構成ファイル
`sqlnet.ora`	ネットワーク関連の設定を構成するサンプル構成ファイル
`ConfigSchema.xsd`	ODP.NET管理対象ドライバの構成セクションを定義するXMLスキーマ・ファイル
`Oracle.ManagedDataAccess.EntityFramework.dll`	プラットフォームに依存しない(AnyCPU)、Code FirstおよびEntity Framework 6以上用の完全管理アセンブリ
`\x64\Oracle.ManagedDataAccessIOP.dll`	プラットフォームに依存する(64ビット.NET Framework)、Kerberosサポート用の管理対象アセンブリ
`\x86\Oracle.ManagedDataAccessIOP.dll`	プラットフォームに依存する(32ビット.NET Framework)、Kerberosサポート用の管理対象アセンブリ

プラットフォーム依存のアセンブリとその検索順序

ODP.NET管理対象ドライバにはプラットフォーム依存のDLL (Oracle.ManagedDataAccessIOP.dll)が1セットあり、これには32ビット.NETバージョンおよび64ビット.NETバージョンがあります。100%管理コードで構成されていますが、.NET外部のAPIを呼び出すため、プラットフォーム依存です。

Oracle.ManagedDataAccessIOP.dllは、Kerberosをサポートします。アプリケーションでこのアセンブリが必要なのは、Kerberosセキュリティを使用する場合のみです。

これらのアセンブリは、アプリケーションによって直接参照することは想定されていません。暗黙的に参照されます。ODP.NET管理対象ドライバは、次の検索順序でこれらのアセンブリを参照します。

グローバル・アセンブリ・キャッシュ
Webアプリケーションのbinディレクトリ、またはWindowsアプリケーションのEXEディレクトリ
アプリケーションの実行環境が32ビットと64ビットどちらの.NET Frameworkかに応じて、x86またはx64サブディレクトリ。アプリケーションがAnyCPUを使用して作成されている場合、ODP.NETはアセンブリが利用可能なかぎり、適切なビット数のDLLを使用します。アプリケーションがAnyCPUの場合は、この方法で依存するアセンブリを検索することをお薦めします。

たとえば、アプリケーションが64ビット版のOracle.ManagedDataAccessIOP.dllを使用する場合は、次のステップに従います。

Visual Studioプロジェクトを右クリックして、「追加」、「新規フォルダ」の順に選択します。
フォルダに「x64」という名前を付けます。
新しく作成したx64フォルダを右クリックして、「追加」、既存の項目の順に選択します。
DLLがあるフォルダ(通常はORACLE_HOME\odp.net\managed\x64)を参照してそこまで移動し、 Oracle.ManagedDataAccessIOP.dllを選択します。
「追加」をクリックします。
x64フォルダで、今作成したOracle.ManagedDataAccessIOP.dllをクリックします。
プロパティのウィンドウで、「出力ディレクタにコピー」を「常にコピー」に設定します。

x86用アプリケーションの場合は、フォルダ名を「x86」とし、x86ディレクトリからアセンブリを追加します。

Oracle.ManagedDataAccessIOP.dllに依存する場合でもアプリケーションをプラットフォーム非依存にするには、x64とx86の両方のフォルダを作成し、必要なアセンブリをそこに追加します。

インストール後のファイルの場所

Oracle Universal Installerベースのインストールの場合、Oracle.ManagedDataAccess.dllアセンブリは次の場所にインストールされます。

.NET Framework 4:

ORACLE_BASE\ORACLE_HOME\odp.net\managed\commonディレクトリ

ドキュメントおよびreadme.txtファイルには、Oracle Universal Installerを使用して実行されるODACインストールのORACLE_BASE\ORACLE_HOME\ODACDoc\DocumentationLibrary\doc\index.htmからアクセスできます。Oracle Developer Tools for Visual Studioがインストールされている場合、OracleドキュメントはVisual Studio自体にインストールされます。

サンプルは、Oracle Universal Installerを使用して実行されるODACインストールのORACLE_BASE\ORACLE_HOME\ODACsamplesディレクトリ、または通常ODAC MSIインストールのC:\Program Files (x86)にあるOracle Developer Tools for Visual Studioサブディレクトリにあります。