2 インストールとアップグレード

この章では、Oracle C++ Call Interface (OCCI)のインストールとアップグレードの概要を説明します。

2.1 Oracle C++ Call Interfaceのインストールについて

OCCIはOracle Databaseの一部としてインストールされます。追加の構成要件を決定するには、使用しているプラットフォーム専用の『Oracle Databaseインストレーション・ガイド』および『Oracle Database Clientインストレーション・ガイド』を参照してください。

2.2 アップグレードに関する考慮点について

このリリースの新機能を使用するには、Oracleクライアントの以前のリリースからアップグレードする際に、オブジェクト型トランスレータ・ユーティリティで生成されたクラスを含む、すべてのOCCIアプリケーションを再コンパイルし、再リンクする必要があります。

2.3 Oracle Databaseバージョンの決定について

アプリケーションで、サーバー・バージョンまたはクライアント・パッチセットが異なる複数の異なるコード・パスを使用する場合には、コンパイル時および実行時のどちらでもこれらのオプションを検証できます。

2.3.1 コンパイル時のOracleクライアント・バージョンの決定

OCCIヘッダー・ファイルは、OCCI_MAJOR_VERSIONおよびOCCI_MINOR_VERSIONマクロを定義します。例2-1に、これらのマクロの使用方法を示します。

例2-1 クライアントのメジャー・バージョンの決定方法およびパフォーマンス機能の設定方法

#if (OCCI_MAJOR_VERSION > 9)
     env->setCacheSortedFlush(true);  // benefit of performance, if available
#endif

2.3.2 実行時のOracleクライアントおよびサーバーのバージョンの決定について

実行時に、getClientVersion()getServerVersion()およびgetServerVersionUString()メソッドを使用して、現行のConnectionのクライアントおよびサーバーのバージョンを両方チェックできます。

2.4 Oracle Instant ClientおよびOracle Instant Client Basic Light

Oracle Instant Clientによって、アプリケーションは、開発および本番デプロイメントのためにローカルまたはリモートのOracle Databaseに接続できます

  • Oracle Instant Clientについて: Oracle Instant Clientライブラリでは、必要なネットワーク接続に加え、Oracle Call Interface (OCI)、OCCI、ODBCおよびJDBC OCIアプリケーションを作成および実行してOracle Databaseを最大限に活用するためのOracle Databaseのクライアント側ファイルが提供されます。
  • Oracle Instant Client Basic Lightについて: Oracle Instant Client Basic Lightでは、クライアントのインストールに必要なディスク領域がさらに削減されています。

2.5 Microsoft Visual C++でのOCCIの使用について

Oracle Database 12cリリース1 (12.1)には、Microsoft Visual C++バージョン10.0 (.NET 2010 SP1 10.0)、Microsoft Visual C++バージョン11.0 (.NET 2012 11.0)、Microsoft Visual C++バージョン12.0 (.NET 2013 12.0)およびMicrosoft Visual Studio 2010 STLでのIntel 12.1 Cコンパイラでアプリケーションを開発するためのOCCIライブラリが含まれています。Microsoft Visual C++バージョン8.0およびバージョン9.0はサポート対象外となりました。

Microsoft Visual C++バージョン10.0ライブラリは、次のデフォルトの場所にインストールされています。

ORACLE_BASE\ORACLE_HOME\bin\oraocci12.dll
ORACLE_BASE\ORACLE_HOME\oci\lib\msvc\oraocci12.lib

また、これらの2つのファイルのコピーが、次のディレクトリにインストールされています。

ORACLE_BASE\ORACLE_HOME\oci\lib\msvc\vc10

Microsoft Visual C++ 2012 OCCIライブラリは、次のデフォルトの場所にインストールされています。

ORACLE_BASE\ORACLE_HOME\oci\lib\msvc\vc11

MSVC++ 2012でOCCIアプリケーションを開発する場合は、リンクおよび実行のために、OCCIライブラリがこのディレクトリから適切に選択されていることを確認します。

Microsoft Visual C++ 2013 OCCIライブラリは、次のデフォルトの場所にインストールされています。

ORACLE_BASE\ORACLE_HOME\oci\lib\msvc\vc12

MSVC++ 2013でOCCIアプリケーションを開発する場合は、リンクおよび実行のために、OCCIライブラリがこのディレクトリから適切に選択されていることを確認します。

アプリケーションは、適切なOCCIライブラリとリンクする必要があります。対応するDLLがWindowsシステムPATHに置かれていることを確認してください。

MSVCRTD.DLLとリンクされるアプリケーション(Microsoft C-Runtimeのデバッグ・バージョン、/MDdコンパイラ・フラグ)は、これらの特定のOCCIライブラリ(oraocci12d.libおよびoraocci12d.dll)とリンクする必要があります。

すべてのInstant Clientパッケージに、Microsoft Visual C++バージョン10.0互換バージョンのOCCI DLLが含まれています。