Oracle REST Data Servicesのダウンロードとインストール

6.4 Oracle REST Data Servicesのダウンロードとインストール

Oracle REST Data Servicesのダウンロードとインストールについて学習します。

Oracle APEXアーキテクチャでは、WebブラウザとAPEXエンジン間でリクエストをプロキシするWebサーバーが必要です。Oracle REST Data Servicesは要件を満たしていますが、Oracle APEXの範囲を超えて使用されています。Oracle REST Data Servicesでは、埋込のJDBCドライバを使用して接続が提供され、Oracleホームが必要ないため、デプロイ・プロセスが単純です。

Oracle REST Data Servicesのダウンロード
Oracle REST Data Servicesをダウンロードする方法を学習します。
リバース・プロキシやロード・バランサの内側にあるOracle REST Data Servicesの構成について
Oracle APEXがリバース・プロキシまたはロード・バランサの背後で実行されている場合、ユーザーのブラウザが認識した元のHTTPホスト名とプロトコルをOracle APEXエンジンに通信することが重要です。
Web Server HTTP POSTのリクエスト制限
Web Server HTTP POSTのリクエスト制限について理解します。

参照:

『Oracle REST Data Services開発者ガイド』のOracle REST Data Servicesの概要に関する項
Oracle REST Data Servicesインストレーションおよび構成ガイドのOracle REST Data Servicesのインストールおよび構成に関する項

親トピック: Oracle APEXおよびOracle REST Data Servicesのインストールと構成

6.4.1 Oracle REST Data Servicesのダウンロード

Oracle REST Data Servicesをダウンロードする方法を学習します。

ヒント:

デフォルトで、Oracle REST Data Servicesを介してOracle APEXにアクセスするためのコンテキスト・ルートは/ordsです。Oracle APEXにアクセスするために/apexのコンテキスト・ルートを持つ場合、Oracle REST Data Servicesをインストールする前に、ords.warファイルの名前をapex.warに変更します。Oracle REST Data Servicesインストレーションおよび構成ガイドのOracle REST Data Servicesのデプロイおよび監視に関する項を参照してください。

Oracle REST Data Servicesをダウンロードするには:

Oracle REST Data Servicesのダウンロード・ページから、Oracle REST Data Servicesの最新リリースをダウンロードします。
ダウンロードしたZIPファイルを任意のディレクトリ(フォルダ)に解凍します。
- UNIXおよびLinuxの場合: ords.version.number.zipを解凍します。
- Windowsの場合: Windowsエクスプローラでords.version.number.zipファイルをダブルクリックします。
imagesディレクトリapex/imagesを、Oracle APEXソフトウェアZIPからOracle REST Data Servicesがインストールされているファイル・システム上の場所にコピーします。
Oracle REST Data Servicesインストレーションおよび構成ガイドのOracle REST Data Servicesのインストールおよび構成に関する項に記載されているすべてのインストールおよび構成ステップに従ってください。
Oracle Database 12c以降のマルチテナント・アーキテクチャの場合は、アクセスする特定のプラガブル・データベース(PDB)のサービス名を使用して接続を構成していることを確認してください。URLでPDBを指定するようにOracle REST Data Servicesを構成している場合を除き、CDB$ROOTのサービス名は使用できません。詳細は、Oracle REST Data Servicesインストレーションおよび構成ガイドのOracle REST Data Servicesでのマルチテナント・アーキテクチャの使用に関する項を参照してください。

親トピック: Oracle REST Data Servicesのダウンロードとインストール

6.4.2 リバース・プロキシやロード・バランサの内側にあるOracle REST Data Servicesの構成について

Oracle APEXがリバース・プロキシまたはロード・バランサの背後で実行されている場合、ユーザーのブラウザが認識した元のHTTPホスト名とプロトコルをOracle APEXエンジンに通信することが重要です。

Oracle APEXエンジンはこの情報を使用して、HTMLレスポンスおよびHTTPリダイレクト内に、ユーザーのブラウザが正常に追随できる有効なURLを生成します。正確な構成ステップは、Java EEアプリケーション・サーバーにより異なります。たとえば、Oracle WebLogic Serverの場合、これはOracle WebLogic Server Proxy Plug-Inを使用して実行されます。さらに学習するには、Java EEアプリケーション・サーバーのドキュメントを参照してください。

親トピック: Oracle REST Data Servicesのダウンロードとインストール

6.4.3 Web Server HTTP POSTのリクエスト制限

Web Server HTTP POSTのリクエスト制限について学習します。

スタンドアロン・モードまたはTomcat Java Container内でOracle REST Data Services (ORDS)を実行している場合、ファイル・アップロード以外のPOSTリクエストにはサイズ制限があります。Oracle APEXユーザーは、SQL Workshopでコピーと貼付けを使用してデータをアップロードする場合や、スプレッドシートからアプリケーションを作成する場合に、これらの制限に直面します。

Oracle REST Data Servicesをスタンドアロン・モードで実行する場合、デフォルトの制限は、ORDS 19.4.6以前では200 KBです。次のようにして制限を増やすことをお薦めします。

Javaシステム・プロパティ org.eclipse.jetty.server.Request.maxFormContentSizeを、より大きい値(単位はバイト)に設定します。このプロパティはOracle REST Data Servicesの起動時に設定できます。次に例を示します。java -Dorg.eclipse.jetty.server.Request.maxFormContentSize=3000000 -jar ords.war
Apache Tomcat上で実行している場合、デフォルトの制限は2㎆です。制限を変更するには、Apache TomcatのmaxPostSizeパラメータを調整します。

参照:

詳細は、http://tomcat.apache.org/を参照してください。

親トピック: Oracle REST Data Servicesのダウンロードとインストール