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

Oracle REST Data Services (ORDS)のダウンロードとインストールについて説明します。

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

参照:

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をダウンロードするには:

  1. Oracle REST Data Servicesのダウンロード・ページから、Oracle REST Data Servicesの最新リリースをダウンロードします。
  2. ダウンロードしたZIPファイルを任意のディレクトリ(フォルダ)に解凍します。
    • UNIXおよびLinuxの場合: ords.version.number.zipを解凍します。
    • Windowsの場合: Windowsエクスプローラでords.version.number.zipファイルをダブルクリックします。
  3. imagesディレクトリapex/imagesAPEXソフトウェアZIPからファイル・システム上のOracle REST Data Servicesのインストール先にコピーします。

    ノート:

    CDNのAPEX静的リソースを使用する場合、このステップはオプションです。詳細は、静的リソース(イメージ)の管理を参照してください。
  4. Oracle REST Data Servicesインストレーションおよび構成ガイドOracle REST Data Servicesのインストールおよび構成に関する項に記載されているすべてのインストールおよび構成ステップに従ってください。
  5. Oracle Database 12c以降のマルチテナント・アーキテクチャの場合は、アクセスする特定のプラガブル・データベース(PDB)のサービス名を使用して接続を構成していることを確認してください。URLでPDBを指定するようにOracle REST Data Servicesを構成している場合を除き、CDB$ROOTのサービス名は使用できません。詳細は、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アプリケーション・サーバーのドキュメントを参照してください。

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/を参照してください。