CData Software Blog

クラウド連携のCData Software の技術ブログです。

API Server, Sync でのOracle接続利用方法まとめ (V20対応)

はじめに

API ServerやSyncではOracleへの接続にネイティブのOracleドライバとCData Oracle OCI Driversを利用できます。 以下はAPI Server Windows Editionで接続方法を選択する画面の例です。

f:id:urabe_shintaro:20210402114921p:plain

画面ではOracleの接続方法として「Oracle OCI」、「Managed Oracle」、「Oracle」の3つが選択できることが分かります。 どれも同じくOracleへの接続を行いますが、エディションやライセンスの違いにより使用できる接続方法が異なります。 本記事ではそれぞれの特徴や使用条件、導入方法について説明します。

API ServerとSyncで利用できるOracle接続方法

ここでは「Oracle OCI」、「Managed Oracle」、「Oracle」の各接続方法の概要を説明します。

Oracle

f:id:urabe_shintaro:20210402114634p:plain

API Server, SyncのWindows Editionでは、接続方法に「Oracle」を選択した場合ドライバとしてODP.NET Unmanaged Driverを利用します。 ODP.NET DriverはOracleデータベース用の.NETデータプロバイダで、.NETアプリケーションからOracleに接続するためのドライバです。 Java EditionとAMIではOracle JDBC Driverを利用します。

Managed Oracle

f:id:urabe_shintaro:20210402114625p:plain

API Server Windows Editionでのみ選択できます。 ドライバとしてODP.NET Managed Driverを利用します。 Oracle(ODP.NET Unmanaged Driver)と比べて依存するDLLが少ないためドライバの導入が簡単です。 .NET Framework 4以降でのみ使用できます。

Oracle OCI

f:id:urabe_shintaro:20210402114608p:plain

ドライバとしてCData社のCData Oracle OCI Driverを利用します。 このドライバが使うOCI (Oracle Call Interface) はC言語ベースのインタフェースで性能に優れています。 全エディションで利用できますが、それぞれのエディションに合わせたドライバのインストールが必要です。 お手持ちのライセンスによって使用可否が分かれますが、使用可能なライセンスをお持ちの場合はこの接続方法をお勧めします。

APIServerでのOracle接続利用方法

Oracle接続方法対応状況

API ServerのOralce接続方法別の対応状況を以下に示します。 アプリケーション導入後にOracleを即時使用可能なのはAMIです。 これ以外でOracleを利用するには別途ドライバまたはコネクタをインストールする必要があります。 Oracle OCIはすべてエディションでインストールが必要です。

Edition Oracle Managed Oracle Oracle OCI
Windows
Java
AMI

凡例

  • ―:非対応
  • ◎:コネクタ・ドライバのインストールが不要(即使用可能)
  • ○:コネクタインストール済み・ドライバのインストールが必要
  • ●:コネクタのインストールが必要

上の表で〇、●をクリックするとそれぞれのドライバまたはコネクタのインストール方法へジャンプします。

Oracle接続方法選択フロー

API ServerでOracle接続方法を選択する際の判断基準例を以下に示します。 CData Oracle OCI Driverを利用可能な場合はこの接続方法をお勧めします。 .NET Framework 4以上がインストールされている環境でODP.NETを使う場合は軽量なManaged Oracleをお勧めします。

f:id:urabe_shintaro:20210402123333p:plain

ドライバインストール方法

以下ではアプリケーション、エディション、接続方法別のドライバインストール方法を説明します。

API Server Windows EditionへのODP.NET Unmanaged Driverインストール方法

1. ドライバの入手

Oracleがインストールされている場合は以下のファイルをコピーしてください。

%ORACLE_HOME%\ODP.NET\bin\*\Oracle.DataAccess.dll

Oracleがインストールされていない場合はODACをインストールし、以下のファイルをコピーしてください。

<ODACインストールフォルダ>\odp.net\bin\*\Oracle.DataAccess.dll

(*は.NET Frameworkのバージョン)

2. ドライバの配置

入手したOracle.DataAccess.dllを以下のフォルダに配置してください。

C:\Program Files\CData\CData API Server\www\bin

3. パスの設定

Oracleがインストールされている場合は環境変数Pathに%ORACLE_HOME%\binを追加してください。 通常はOracleインストール時に追加されます。 Oracleがインストールされていない場合はODACをインストールし、環境変数PathにODACインストールフォルダとその下のbinを追加してください。

4. アプリケーション設定の追加

以下のファイルをテキストエディタで開いてください。

C:\Program Files\CData\CData API Server\www\Web.Config

<configuration><system.data><DbProviderFactories>セクションに以下を追加してください。

<remove invariant="Oracle.DataAccess.Client" />
<add name="Oracle Data Provider for .NET" invariant="Oracle.DataAccess.Client" description="Oracle Data Provider for .NET" type="Oracle.DataAccess.Client.OracleClientFactory, Oracle.DataAccess" />

これでインストールは完了です。

API Server Windows EditionへのODP.NET Managed Driverインストール方法

1. ドライバの配置

Oracleがインストールされている場合は以下のファイルをコピーしてください。

%ORACLE_HOME%\ODP.NET\managed\common\Oracle.ManagedDataAccess.dll

Oracleがインストールされていない場合はODACをインストールし、以下のファイルをコピーしてください。

<ODACインストールフォルダ>\odp.net\managed\common\Oracle.ManagedDataAccess.dll

2. ドライバの配置

入手したOracle.ManagedDataAccess.dllを以下のフォルダに配置してください。

C:\Program Files\CData\CData API Server\www\bin

3. アプリケーション設定の追加

以下のファイルをテキストエディタで開いてください。

C:\Program Files\CData\CData API Server\www\Web.Config

<configuration><system.data><DbProviderFactories>セクションに以下を追加してください。

<remove invariant="Oracle.ManagedDataAccess.Client"/>
<add name="ODP.NET, Managed Driver" invariant="Oracle.ManagedDataAccess.Client" description="Oracle Data Provider for .NET, Managed Driver" type="Oracle.ManagedDataAccess.Client.OracleClientFactory, Oracle.ManagedDataAccess"/>

これでインストールは完了です。

API Server Java EditionへのOracle JDBC Driverインストール方法

1. ドライバの入手

Oracleがインストールされている場合は以下のファイルをコピーしてください。

%ORACLE_HOME%\jdbc\lib\ojdbc<バージョン番号>.jar

Oracleがインストールされていない場合はここからJDBCドライバをダウンロードしてください。

2. ドライバの配置

入手したJDBCドライバを以下のフォルダに配置してください。

C:\Program Files\CData\CData API Server Java Edition\lib

これでインストールは完了です。

API Server Windows EditionへのOracle OCIコネクタインストール方法

ここからCData Oracle ADO.NET Provderのインストーラをダウンロードし、API Serverの実行環境にインストールしてください。 インストールが完了しAPI Serverを再起動すると接続一覧からOracle OCIが選択できるようになります。

API Server Java EditionへのOracle OCIコネクタインストール方法

ここからCData Oracle JDBC Driverのインストーラをダウンロードし、API Serverの実行環境にインストールしてください。

CData Oracle JDBC Driverをインストールするとドライバのインストールフォルダにcdata.jdbc.oracleoci.jarが展開されます。

C:\Program Files\CData\CData JDBC Driver for Oracle OCI 2020J\lib\cdata.jdbc.oracleoci.jar

上記のJDBCドライバを以下のフォルダにコピーしてください。

C:\Program Files\CData\CData API Server Java Edition\lib

API Serverを再起動すると接続一覧からOracle OCIが選択できるようになります。

接続時に「接続エラー:no System.Data.CData.OracleOCIw in java.library.path」が表示される場合はCDataサポートまでお問い合わせください。

API Server AMIへのOracle OCIコネクタインストール方法

ここからCData Oracle JDBC Driverのインストーラをダウンロードします。

AMIのインスタンスにログインし、ダウンロードしたドライバインストーラインスタンス環境に転送してインストールします。 AMIインスタンスにはzipファイルを解凍するunzipが入っていないため、あらかじめ解凍して転送するか、インスタンスにunzipをインストールしてください。

Unzipのインストール

> sudo yum install unzip

ドライバのインストール

> unzip OracleJDBCDriver.zip
> sudo java -jar setup.jar

インストールが完了するとドライバのインストールフォルダのlibにcdata.jdbc.oracleoci.jarが展開されますので、これを以下のフォルダにコピーしてください。

/opt/apiserver/lib/ext

インスタンスを再起動すると接続一覧からOracle OCIが選択できるようになります。

接続時に「接続エラー:no System.Data.CData.OracleOCIw in java.library.path」が表示される場合はCDataサポートまでお問い合わせください。

SyncでのOracle接続利用方法

Oracle接続方法対応状況

SyncのOralce接続方法別の対応状況を以下に示します。 データソースはOracle OCI、同期先はOracleしか選択肢がありません。 AMIは同期先であればOracleを即時使用可能です。

役割 Edition Oracle Oracle OCI
データソース 全エディション
同期先 Windows
同期先 Java
同期先 AMI

凡例

  • ―:非対応
  • ◎:コネクタ・ドライバのインストールが不要(即使用可能)
  • ○:コネクタインストール済み・ドライバのインストールが必要
  • ●:コネクタのインストールが必要

上の表で〇、●をクリックするとそれぞれのドライバまたはコネクタのインストール方法へジャンプします。

ドライバインストール方法

Sync Windows EditionへのODP.NET Unmanaged Driverインストール方法

1. ドライバの入手

Oracleがインストールされている場合は以下のファイルをコピーしてください。

%ORACLE_HOME%\ODP.NET\bin\*\Oracle.DataAccess.dll

Oracleがインストールされていない場合はODACをインストールし、以下のファイルをコピーしてください。

<ODACインストールフォルダ>\odp.net\bin\*\Oracle.DataAccess.dll

(*は.NET Frameworkのバージョン)

2. ドライバの配置

入手したOracle.DataAccess.dllを以下のフォルダに配置してください。

C:\Program Files\CData\CData Sync 2020J\www\bin

3. パスの設定

Oracleがインストールされている場合は環境変数Pathに%ORACLE_HOME%\binを追加してください。 通常はOracleインストール時に追加されます。 Oracleがインストールされていない場合はODACをインストールし、環境変数PathにODACインストールフォルダとその下のbinを追加してください。

4. アプリケーション設定の追加

以下のファイルをテキストエディタで開いてください。

C:\Program Files\CData\CData API Server\www\Web.Config

<configuration><system.data><DbProviderFactories>セクションに以下を追加してください。

<remove invariant="Oracle.DataAccess.Client" />
<add name="Oracle Data Provider for .NET" invariant="Oracle.DataAccess.Client" description="Oracle Data Provider for .NET" type="Oracle.DataAccess.Client.OracleClientFactory, Oracle.DataAccess" />

これでインストールは完了です。

Sync Java EditionへのOracle JDBC Driverインストール方法

1. ドライバの入手

Oracleがインストールされている場合は以下のファイルをコピーしてください。

%ORACLE_HOME%\jdbc\lib\ojdbc<バージョン番号>.jar

Oracleがインストールされていない場合はここからJDBCドライバをダウンロードしてください。

2. ドライバの配置

入手したJDBCドライバを以下のフォルダに配置してください。

C:\Program Files\CData\CData Sync Java Edition\tmp\webapp\libs

これでインストールは完了です。

SyncへのOracle OCIコネクタインストール方法

Sync画面を開き、[接続]メニューを開きます。 [データソース]タブの[Add More]をクリックします。

f:id:urabe_shintaro:20210402132152p:plain

コネクタ一覧から「Oracle OCI」を選択し、インストールしてください。

f:id:urabe_shintaro:20210402132524p:plain

Syncに再ログインするとデータソース一覧からOracle OCIが選択できるようになります。

Java Editionでの接続時「接続エラー:no System.Data.CData.OracleOCIw in java.library.path」が表示される場合はCDataサポートまでお問い合わせください。

ODACのインストール方法

以下リンクから最新のODAC(Oracle Data Access Components)のインストーラをダウンロードします。

https://www.oracle.com/database/technologies/dotnet-odacdeploy-downloads.html

インストーラを起動し、手順に従ってインストールしてください。 ODP.NETを利用する場合、インストールコンポーネントを選択する画面で「Oracle Data Provider for .NET」をチェックします。

f:id:urabe_shintaro:20210401194743p:plain

インストールが完了すると、インストールフォルダとその下のbinが環境変数Pathに追加されます。

例:

  • C:\app\client\Administrator\product\19.0.0\client_1
  • C:\app\client\Administrator\product\19.0.0\client_1\bin