セットアップ、およびメモ（12.2.0.1.0）2017年7月

ダウンロードには次の製品が含まれます。

a) Oracle Developer Tools for Visual Studio (12.2.0.1.0)

b) Oracle Data Provider for .NET 4 (12.2.0.1.0)

c) Oracle Data Provider for .NET 2 (12.2.0.1.0)

d) Oracle Providers for ASP.NET 4 (12.2.0.1.0)

e) Oracle Providers for ASP.NET 2 (12.2.0.1.0)

f) Oracle Data Provider for .NET Oracle TimesTen In-Memory Database（12.2.0.1.0）

g) MTS用のOracle Service（12.2.0.1.0）

h) Oracle Provider for OLE DB（12.2.0.1.0）

i) Oracle ODBC Driver（12.2.0.1.0）

j) Oracle SQL*Plus（12.2.0.1.0）

k) Oracle Call Interface (12.2.0.1.0)

l) Oracle C++ Call Interface (12.2.0.1.0)

m) Oracle Instant Client (12.2.0.1.0)

n) Oracle Universal Installer（12.2.0.1.0）

システム要件

ODACには次のアイテムが必要です。

  • Windows x64オペレーティング・システム
    • Windows 10（Pro、Enterprise、およびEducationエディション）、Windows 8.1およびWindows 8（ProおよびEnterpriseエディション）、Windows 7（Professional、Enterprise、Ultimateエディション）、Windows Server 2016（Standard、Datacenter、およびEssentialsエディション）、Windows Server 2012 R2およびWindows Server 2012（Standard、Datacenter、Essentials、およびFoundationエディション）
  • Oracle Databaseサーバーへのアクセス（Oracle 10gリリース2以降）

要件に関する追加メモ：

  • ODP.NETにはMicrosoft .NET Frameworkが必要です。
    • ODP.NET、マネージドドライバーには.NET Framework 4以降、.NET Framework 4.7が必要です
    • ODP.NET、アンマネージドドライバーには.NET Framework 3.5 SP 1以降から.NET Framework 4.7までが必要です
  • Oracle Developer Tools for Visual StudioにはMicrosoft Visual Studio 2017またはVisual Studio 2015が必要です

注: Visual Studio Express Editionは、Oracle Developerツールではサポートされていません。ただし、ODP.NETはVisual Studio Express Editionでサポートされています。

  • ODP.NETで分散トランザクションを使用する場合、分散トランザクションを使用するようにアプリケーションを構成する方法の詳細は、ODP.NET Developerのガイドをお読みください。

インストール手順

以下の手順は、Oracle Universal Installerを使用したODACのインストールに適用されます。Xcopyのインストール手順は、ダウンロード自体に含まれています。

  1. ODAC zipファイルを一時ディレクトリにダウンロードします。注: このファイルを「TMP」ディレクトリにダウンロードしないでください。
  2. その内容をディレクトリに解凍します。
  3. 同じディレクトリに解凍されたsetup.exeを起動して、Oracle Universal Installer（OUI）を実行します。管理者権限が必要です。
  4. OUIを使用すると、マシンにODACをインストールできます。インストール後、zipファイルと解凍されたフォルダおよびファイルは削除できます。

注: 別のODACベータ版がインストールされている場合は、このODACリリースをインストールする前にアンインストールしてください。

アンインストールの手順

アンインストールするときは、最初にOracle Homeをインストールしたときに使用したインストールタイプ（＃Oracle Universal Installer、xcopy、NuGet、MSIなど）を使用します。別のインストールタイプで作成されたOracle Homeからはアンインストールしないでください。Oracleでは、ODACをインストールしたのと同じバージョンで削除を実行し、Oracle Homeにインストールされている他のOracleコンポーネントよりも先にODACを削除することを強く推奨しています。

以下の手順は、Oracle Universal Installerを使用したODACのアンインストールに適用されます。Xcopyのアンインストール手順は、ダウンロード自体に含まれています。

  1. Windowsのスタートメニューに移動し、「Universal Installer」を選択します: （すべてのプログラム -->Oracle - < Oracleのホーム名> -- >Oracleのインストール製品-->Universal Installer）。ユーザーアカウント管理がリクエストされた場合は、特権を付与します。
  2. "製品のアンインストール"ボタンをクリックします。
  3. アンインストールするOracle Home（つまり、Oracle ClientのOracle Data Access Components）をツリーコントロールから選択します。"削除"ボタンをクリックします。ODACに加えて他のコンポーネントを削除する場合は、まず先にODACを削除するようにしてください。
  4. "はい"ボタンをクリックして、Oracle Homeのアンインストールを確認します。

ODACをサイレントアンインストールするには、コマンドラインで次のコマンドを実行します。

1.<Oracle Home Path>\oui\bin\setup.exe -silent -deinstall DEINSTALL_LIST={"oracle.odac.client","12.2.0.1.0"} ORACLE_HOME=<Oracle Home Path>

上記のコマンドは、ODACコンポーネントをアンインストールおよび構成解除します。ただし、このODACのアンインストール方法では、Oracle Clientバイナリとどのユーザー生成ファイルもOracle Homeに残ります。Oracle Home内のすべてのファイルとフォルダを完全に削除するには、最初のコマンドに加えて次のWindowsコマンドを実行します。

2. rmdir <Oracle Home Path>\ /s

注 Oracle Homeのファイルは、いったん削除すると復元できなくなります。上記のコマンドを実行する前に、Oracle Homeから重要なものをすべてバックアップしてください。この同じコマンドをサイレントで実行する場合は、代わりに次のコマンドを実行できます。

3. rmdir <Oracle Home Path>\ /s /q

接続設定のクイックスタート

自動セットアップ

ODACを新しいOracle Homeにインストールすると、同じビットネスを共有している限り（つまり、どちらも32ビットインストールであるか、どちらも64ビットインストールの場合）、OUIはOracleローカルネーミング（tnsnames.ora）、プロファイル（sqlnet.ora）、およびディレクトリ（ldap.ora）パラメータファイルと設定を既存のOracle Homeから新しくインストールされたODACホームに自動的にコピーします。

または、existing *.oraファイルは、最後にアクティブだったホーム以外の既存のOracle Homeから、新しいODAC Oracle Homeにコピーできます。OUIは、これらのファイルが存在する場合、最大3つの既存Oracle Homeからこれらのファイルの場所情報を提供します。新しいOracle Homeが、ファイルのコピー元の以前のOracle Homesとは異なる構成を使用している場合、*.oraファイルをカスタマイズすることができます。

既存のODACまたはRDBMS Oracle Homeにインストールする場合、新しい* .oraファイルはコピーまたは作成されません。

これまでにOracle Homeが存在していないマシンにインストールする場合、OUIはユーザーにデータベース接続エイリアス情報を求めます。次に、OUIが自動的にtnsnames.oraファイルを作成します。エイリアス情報が提供されないと、tnsnames.oraファイルは作成されません。ユーザーがすべてのデータベース接続情報をすぐに利用できない場合でも、Oracleはインストールプロセス中にプレースホルダー値を挿入して、後でtnsnames.oraファイルを実価に変更し、プレースホルダーに置き換えることを推奨しています。

ODP.NET、マネージドドライバのMachine.configへの変更をインストール

ODP.NET、マネージドドライバをインストールする場合、既存のOracle Homeがあり、マシン全体の構成が選択されている場合、OUIがTNS_ADMINおよびLDAP_ADMINエントリを.NET maching.configファイルに自動的にコピーします。

手動設定

Oracleクライアントをデータベースに接続する上で最も一般的な2つの方法は、EZCONNECTとTNSNAMESです。EZCONNECTはセットアップが最も簡単です。TNSNAMESは、長期的に見て非常にメンテナンスがしやすいです。Oracleを初めて使用する場合は、EZCONNECTのご使用を推奨しています。接続するにはどちらか一方を選択するだけです。

これらのクイックスタート手順では、データベースサーバーの有効なユーザー名とパスワードがあることを前提としています。

注: 以下のセットアップ手順では、ORACLE_HOMEは、Oracleクライアントホームがマシンにインストールされたディレクトリを表しています。OUI Oracleクライアントホームの典型的なディレクトリは次のとおりです。
C:\app\client\\product\12.1.0\client_1

続行する前に、このディレクトリの場所を知っておく必要があります。

EZCONNECTのセットアップ

1. 次のディレクトリにあるsqlnet.oraファイルをコピーします。
ORACLE_HOME\Network\Admin\Sample\
to this directory:
ORACLE_HOME\Network\Admin\

このファイルは、Oracleクライアントに、どの方法（EZCONNECTなど）でOracle Databaseサーバーに接続できるかを通知します。

2. Oracleクライアントは、データベースサーバーに接続するのに有効なユーザー名、パスワード、およびデータソースを指定する必要があります。データソースを指定するには、EZCONNECT形式が使用できます。ODP.NETデータソース属性では、次の形式を使用して、クライアントがデータベースサーバーに接続する方法を定義します。
[//]host[:port][/service_name]

  • ホスト =データベースサーバーマシンのホスト名
  • ポート = 着信接続リクエストをリスニングするデータベースサーバーマシンのポート
  • service_name = データベースのグローバル名

たとえば、構文的に有効な接続文字列は次のとおりです。

"user id=hr;password=hr;data source=//sales-server:1521/sales.us.acme.com"

"user id=hr;password=hr;data source=//sales-server/sales.us.acme.com"

"user id=hr;password=hr;data source=sales-server/sales.us.acme.com"

ポート番号が指定されていない場合、デフォルトで1521が使用されます。

TNSNAMESのセットアップ

Oracle Netサービス名を使用すると、Oracleクライアントはシンプルエイリアスを使用してデータベースサーバーに接続できます。エイリアス定義には、データベースサーバーへの接続を作成のに必要なすべての情報が含まれています。エイリアス情報は通常、ORACLE_HOME\Network\Adminディレクトリにあるtnsnames.oraファイルに保存されます。このエイリアスは、接続文字列のデータソース値として使用されます。ODACのインストールではtnsnames.oraファイルは作成されないため、作成する必要があります。次の手順では、新しいtnsnames.oraファイルを作成する必要があると想定しています。

1. 次のディレクトリにあるtnsnames.oraファイルをコピーします。
ORACLE_HOME\Network\Admin\Sample\
to this directory:
ORACLE_HOME\Network\Admin\



<data source alias> = 
          (DESCRIPTION = 
          (ADDRESS = (PROTOCOL = TCP)(HOST = <hostname or IP>)(PORT = <port>)) 
          (CONNECT_DATA = 
          (SERVER = DEDICATED) 
          (SERVICE_NAME = <database service name>)))
  • データソースエイリアス = 接続記述子を識別するために指定されたショートカット名。ODP.NET接続文字列で、開発者は"データソース"属性をデータソースエイリアスに設定します。
  • ホスト名またはIP = データベースサーバーマシンのホスト名またはIPアドレス
  • ポート = 着信接続リクエストをリスニングするデータベースサーバーマシンのポート通常、この値はポート"1521"に設定されます。
  • データサービス名 = データベースのグローバル名

tnsnames.oraのデータソースエイリアス、ホスト名/IP、ポート、およびデータベースサービス名は適切に変更する必要があります。ORACLE_HOME\network\admin\tnsnames.oraファイルのTNSエントリがOracleクライアントで認識されない場合は、テキストエディタを使用してORACLE_HOME\oracle.keyファイルを作成し、次の行を入力します。
SOFTWARE\ORACLE\< home key >

<ホームキー>はODAC Oracle Homeのレジストリキーです。たとえば、デフォルトのOracle Homeの場所がインストール中に使用された場合、oracle.keyファイルの適切なエントリは次のようになります。SOFTWARE\ORACLE\KEY_OraClient12c_home1

マシン全体の構成

ODACには、管理対象および非管理対象のODP.NETをマシン全体または非マシン全体の構成でインストールするオプションがあります。マシン全体の構成には、プロバイダアセンブリをGACに配置して、構成セクションハンドラとDbProviderFactory情報を使ってmachine.configをアップデートすることが含まれます。非マシン全体の構成を選択した場合、これらの変更は行われません。デフォルトでは、ODACのインストールは、新しいOracle Homeのインストールと再インストールに非マシン全体の構成が使用されます。

ODACとODP.NET 12.2.0.1のNuGetインストールを同じマシンにインストールする場合は、ODP.NETを非マシン全体で構成してください。また、これまでにマシン全体に他のODP.NET 12.2.0.1バージョンがインストールされていないことを確認してください。

ユーザーは、同じバージョンのODP.NETが既にインストールされているOracle HomeにODP.NETを再インストールすることにより、ODP.NETをマシン全体の構成から非マシン全体の構成に再構成できます。たとえば、マシン全体でODP.NETをすでに構成している場合は、ODP.NETを同Oracle Homeに再インストールして、非マシン全体の構成オプションを選択することで、再構成できます。

マシン全体に設定されていないバージョンのODP.NETに依存したアプリケーションの場合、A）アプリケーションが依存するODP.NETアセンブリは、アプリケーションディレクトリにコピーする必要があり、B）プロバイダーファクトリやプロバイダ固有の構成を使用するには、適切な.NET構成設定が必要であることに注意してください。詳細については、ODP.NET開発者のガイドをご参照ください。

一般的なインストールとセットアップの問題

ODACは、既存のOracleサーバーホームへのインストールをサポートしていません。12.xリリース以前の最初の2つのメジャーバージョンを共有している場合（つまり、ODAC 12.2はODAC 12.1ホームにインストールできません）、またはOracle 18以降のメジャーバージョンを共有している場合（つまり、Oracle 18はOracle 19ホームにインストールできません）、ODACを既存のOracleクライアントホームにインストールできます。既存のOracleクライアントホームにインストールする場合は、同じインストーラテクノロジーを使用する必要があります。OUI ODACはOUI ODACホームにのみ、MSI ODACからへのMSI ODACホームにのみ、xcopy ODACからxcopy ODAC homeにのみインストールできます。

既存のORACLE_HOMEディレクトリにあるoci.dllがアンインストールプロセス中に削除されたかどうかを確認します。oci.dllが削除されなかった場合は、次の手順に従ってDLLを削除します。

  1. 既知の問題または制限については、最初にリリースノートをご参照ください。
  2. ダウンロードサイズをダウンロードページに記載されているサイズと比較して、Oracle Data Access Componentsが適切にダウンロードされたかどうかを確認します。
  3. 同じマシンに複数のOracle Homeがインストールされている場合（例：Oracle 12cリリース1クライアントとOracle 12cリリース2クライアントなど）、Oracle 12.2クライアントをインストールすると、OUIはこのクライアントをすべての既存アプリケーションが使用するすべてのホームとして確立します。複数のOracle HomeをODP.NETのUnamanged Driverで使用する方法の詳細については、ODP.NETのドキュメントをご覧ください。
  4. ODACを新しいOracle Homeにインストールすることを強く推奨しています。既存のOracle Homeの上にODACをインストールすると、既存のOracle Applicationsが壊れる可能性があります。既存のOracle Home上にインストールする場合は、そのOracle Home（例：OracleMTSRecoveryService）を使用しているすべてのWindowsサービスを停止し、Oracle Client Homeであることを確認してください。

  5. a) oci.dllの名前をoci.dll.deleteに変更します。
    b) マシンを再起動します。
    c) oci.dll.deleteを削除します。再起動後には使用されなくなります。
    d) 新しいODACをインストールします。
  6. 既存のOracle 12.2cホームにODACをインストールする場合、既にインストールされているODACコンポーネントはデフォルトではインストールされません。インストール処理中にインストールするODACコンポーネントを手動で選択する必要があります（つまり、インストールするODACコンポーネントの横にあるチェックボックスをオンにします）。これは、使用するすべてのODACコンポーネント、特にODP.NETに推奨されています。
  7. このインストールにより、既存の10.2および11.1 ODP.NETアプリケーションを現在のODP.NETバージョンにリダイレクトできるポリシー構成ファイルが提供されます。ポリシーファイルは、ORACLE_HOME\odp.net\PublisherPolicy\2.xおよびORACLE_HOME\odp.net\PublisherPolicy\4ディレクトリにあります。ODP.NETをインストールしても、ODP.NETポリシーDLLはGACに配置されません。つまり、既存のアプリケーションは、以前使用していたものと同じODP.NETバージョンを引き続き使用します。
  8. ODP.NETを新しいOracle Homeにインストールすると、以前のインストールのOracleデータソースエイリアスにはアクセスできなくなる可能性があります。これらの既存のデータソース属性を確実に使用するには、ORACLE_HOME\network\adminディレクトリのtnsnames.oraファイルを、以前のOracle Homeインストールから新しいインストールの同じディレクトリにコピーします。または、以下の接続セットアップのクイックスタートに従って先に接続エイリアスを手動で作成することもできます。
  9. Oracle Databaseは、Oracle Databaseのインストール時に指定されたOracle Home Userの使用をサポートします。Oracle Home Userは、Oracle HomeのWindowsサービスの実行に使用されます。Oracle Home Userは、仮想アカウント、標準のWindowsユーザーアカウント（管理者アカウントではない）、またはWindowsビルトインアカウントにすることができます。Oracle Home Userの詳細については、Microsoft Windows用Oracle Databaseプラットフォームガイドをご参照ください。
  10. Visual Studio 12.1.0.2.0（ODAC 12cリリース3の一部）以降のOracle Developerツール（ODT）がマシンにインストールされ、マシンがODT 12.1.0.1.2（ODAC 12cリリース2の一部）以前のバージョンにダウングレードされる場合、古いODTバージョンをインストールする前に、新しいODTバージョンをアンインストールする必要があります。そうしなければ、PL / SQLデバッグなど特定のODT機能が動作しなくなります。
  11. ODAC 12cリリース3より前のODP.NETのアンインストールにより、.NET 2.xアセンブリ参照を持つエントリが.NET 4.0 machine.configに入力される可能性があります。これにより、Oracle.DataAccess.Clientの2.xバージョンを参照する"oracle.unmanageddataaccess.client"構成セクションのエントリを、NET 4.0 machine.configから手動で削除しない限り、サイドバイサイド実行エラーの原因となることがあります。Oracle.DataAccess.ClientのOracle.DataAccess.Clientの2.xバージョンを参照するDbProviderFactoriesエントリも手動で削除することをお勧めします。

ODP.NETドキュメントの表示

PDFおよびHTMLドキュメントは、ORACLE_HOME\ODACDoc\DocumentationLibrary\welcome.htmlページで参照できます。このページを表示するには、スタートメニューから >Oracle- < Oracle Home> - >アプリ開発- >Oracle Data Access Componentsドキュメントに移動します。

また、Oracleのドキュメントは、Visual Studioダイナミックヘルプの一部としてインストールされます。

サポートとバグレポート

バグや問題については、数あるODACのOTNディスカッションフォーラムの1つにご参加いただき学んでいただけます。