1. 開発者ガイド
  2. Oracle Data Provider for .NETのインストールおよび構成
  3. Oracle Data Provider for .NET管理対象ドライバのインストール

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

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

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

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

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

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

  • ODP.NET管理対象ドライバ

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

Windowsインストーラを使用している場合: VSIXまたは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 Windowsレジストリ・エントリを追加するためのバッチ・ファイル。

unconfigure.bat

管理対象ODP.NET Windowsレジストリ・エントリを削除するためのバッチ・ファイル。

tnsnames.ora

データソースのエイリアスを定義するサンプル構成ファイル

sqlnet.ora

ネットワーク関連の設定を構成するサンプル構成ファイル

Oracle.ManagedDataAccess.Client.Configuration.Section.xsd

ODP.NET管理対象ドライバの構成セクションを定義するXMLスキーマ・ファイル

Oracle.ManagedDataAccess.EntityFramework.dll

プラットフォームに依存しない(AnyCPU)、Code FirstおよびEntity Framework 6以上用の完全管理アセンブリ

\x64\Oracle.ManagedDataAccessIOP.dll

プラットフォームに依存する(64ビット.NET Framework)、Kerberosサポート用の管理対象アセンブリ

OraProvCfg.exeユーティリティでは、GACingのODP.NETやmachine.configファイル内のODP.NETの構成など、様々な構成タスクを実行できます。このユーティリティの使用方法について学習するには、パラメータを指定せずにコマンドラインでoraprovcfg.exeを実行して、ドキュメントを出力します。

関連項目:

インストール手順については、Microsoft Windows用のOracle Databaseインストレーション・ガイド を参照してください。

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

ODP.NET管理対象ドライバには、プラットフォーム依存のDLLであるOracle.ManagedDataAccessIOP.DLL (64ビット)が1つあります。これは100%マネージド・コードからなりますが、.NET外部のAPIをコールします。それが、プラットフォーム依存である理由です。

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

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

  1. グローバル・アセンブリ・キャッシュ

  2. Webアプリケーションのbinディレクトリ、またはWindowsアプリケーションのEXEディレクトリ

  3. DLLのデフォルトのインストール場所。アプリケーションがAnyCPUの場合は、この方法で依存するアセンブリを検索することをお薦めします。

たとえば、アプリケーションでOracle.ManagedDataAccessIOP.dllを使用する場合は、次の手順に従います:

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

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

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

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

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

.NET Framework 4:

ORACLE_HOME\ODP.NET\nugetディレクトリ

管理対象ODP.NETは、Oracle.ManagedDataAccess.<version>.nupkgファイルに埋め込まれています。このファイルはNuGetパッケージです。ODP.NETユーザーは、NuGet Package ManagerやVisual Studioなどの一般的なMicrosoftツールを使用してこのパッケージをインストールできます。

Oracle Developer Tools for Visual Studioがインストールされている場合、OracleドキュメントはVisual Studio自体にインストールされます。

サンプルがGitHubに提供されています。

https://github.com/oracle/dotnet-db-samples