メニュー
Amazon Relational Database Service
ユーザーガイド (API Version 2014-10-31)

Oracle Application Express

Amazon RDS では、APEX および APEX-DEV オプションを使用することによる Oracle Application Express (APEX) がサポートされています。APEX はウェブベースアプリケーション用の開発およびランタイム環境です。APEX を使用して、開発者はウェブブラウザ内でアプリケーション全体を構築できます。詳細については、Oracle ドキュメントの Oracle Application Express を参照してください。

Oracle APEX は、2 個のメインコンポーネントで構成されます。

  • APEX アプリケーションおよびコンポーネントのメタデータを格納するリポジトリ。リポジトリは、テーブル、インデックス、および Amazon RDS DB インスタンスにインストールされている他のオブジェクトで構成されます。

  • APEX クライアントとの HTTP 通信を管理するリスナー。リスナーは、ウェブブラウザからの受信接続を受け入れ、処理するためにそれらを Amazon RDS DB インスタンスに転送した後、リポジトリから結果をブラウザに戻します。APEX Listener は、Oracle 12c で Oracle Rest Data Services (ORDS) という名前に変更されたことに注意してください。

DB インスタンスに APEX オプションを追加すると、Amazon RDS により APEX リポジトリのみインストールされます。APEX リスナーは別個のホストにインストールする必要があります (Amazon EC2 インスタンス、社内のオンプレミスサーバー、またはデスクトップコンピュータ)。

Amazon RDS は Oracle 12c の Oracle APEX の以下のバージョンをサポートします。

  • Oracle APEX バージョン 4.2.6

  • Oracle Rest Data Services (ORDS)、APEX リスナー

 

Amazon RDS は Oracle 11g の Oracle APEX の以下のバージョンをサポートします。

  • Oracle APEX バージョン 4.1.1

  • Oracle APEX Listener 1.1.4

 

APEX および APEX リスナーの前提条件

APEX および APEX リスナーを使用するための前提条件は次のとおりです。

  • DB インスタンスで管理タスクを実行するために SQL*Plus が必要です。

  • APEX リスナーとして機能するホストコンピュータに、次のソフトウェアをインストールする必要があります。

    • Java ランタイム環境 (JRE)。

    • APEX Listener が Amazon RDS インスタンスに接続できるようにする Oracle Net Services。

APEX オプションの追加

DB インスタンスに APEX オプションを追加する一般的な手順は以下のとおりです。

  1. 新しいオプショングループを作成するか、既存のオプショングループをコピーまたは変更します。

  2. オプショングループにオプションを追加します。

  3. オプショングループを DB インスタンスに関連付けます。

APEX オプションを追加する場合、DB インスタンスを自動的に再起動している間に短い停止が発生します。

APEX オプションを DB インスタンスに追加するには

  1. 使用するオプショングループを決定します。新しいオプショングループを作成することも、既存のオプショングループを使用することもできます。既存のオプショングループを使用する場合は、次のステップは飛ばしてください。または、次の設定でカスタム DB オプショングループを作成します。

    1. [Engine] で、使用する Oracle のエディションを選択します。APEX オプションは、すべてのエディションでサポートされます。

    2. [Major Engine Version] で、[11.2] または [12.1] を選択します。

    詳細については、「オプショングループを作成する」を参照してください。

  2. オプショングループに次のオプションを追加します。

    • Oracle 12c では、[APEX] と [APEX-DEV] オプションを追加します。

    • Oracle 11g では、[APEX]、[APEX-DEV]、[XMLDB] オプションを追加します。

    重要

    すでに 1 つ以上の DB インスタンスにアタッチされている既存のオプショングループに APEX オプションを追加すると、すべての DB インスタンスが自動的に再起動する間に短い停止が発生します。

    オプションの追加方法の詳細については、「オプショングループにオプションを追加する」を参照してください。

  3. 新規または既存の DB インスタンスに、DB オプショングループを適用します。

注記

APEX 実行時環境のみデプロイする場合、後で APEX-DEV オプションを削除できます。ただし、インストール時には APEX-DEV オプションを APEX オプションとともに含める必要があります。

パブリックユーザーアカウントのロック解除

APEX オプションのインストール後、APEX パブリックユーザーアカウントのパスワードを変更し、その後アカウントをロック解除する必要があります。Oracle SQL*Plus コマンドラインユーティリティを使用してこれを行うことができます。DB インスタンスにマスターユーザーとして接続し、次のコマンドを発行します。new_password を任意のパスワードに置き換えます。

Copy
alter user APEX_PUBLIC_USER identified by new_password; alter user APEX_PUBLIC_USER account unlock;

APEX リスナーのインストールと設定

これで、リスナーを Oracle APEX で使用するようにインストールして設定する準備ができました。次のいずれかの製品をこの目的で使用できます。

  • Oracle 12c の場合、Oracle Rest Data Services (ORDS)

  • Oracle 11g の場合、Oracle APEX Listener

  • Oracle HTTP Server と mod_plsql

注記

Amazon RDS では、PL/SQL ゲートウェイが埋め込まれた Oracle XML DB HTTP サーバーがサポートされません。これを APEX リスナーとして使用することはできません。一般的に、Oracle では、インターネット上で稼働するアプリケーションで埋め込みの PL/SQL ゲートウェイを使用しないことが推奨されています。

APEX リスナーは別個のホストにインストールする必要があります (Amazon EC2 インスタンス、社内のオンプレミスサーバー、またはデスクトップコンピュータ)。

次の手順は、APEX リスナーをインストールして設定する方法を示しています。ここでは、ホスト名が myapexhost.example.com であり、ホストで Linux が実行されていることが前提です。

APEX リスナーをインストールして設定するには

  1. root として myapexhost.example.com にログインします。

  2. APEX リスナーのインストールを所有する権限を持っていない OS ユーザーを作成します。以下のコマンドでは、apexuser という名前の新規ユーザーを作成します。

    Copy
    useradd -d /home/apexuser apexuser

    以下のコマンドは、新規ユーザーにパスワードを割り当てます。

    Copy
    passwd apexuser;
  3. myapexhost.example.comapexuser としてログインし、APEX および APEX Listener のインストールファイルを Oracle からダウンロードします。

  4. APEX ファイルを解凍します。

    • Oracle 12c の場合、次のコードを実行します。

      Copy
      unzip apex_4.2.6.zip
    • Oracle 11g の場合、次のコードを実行します。

      Copy
      unzip apex_4.1.1.zip
  5. 新しいディレクトリを作成し、APEX Listener ファイルを開きます。

    • Oracle 12c の場合、次のコードを実行します。

      Copy
      mkdir /home/apexuser/ORDS cd /home/apexuser/ORDS unzip ../ords.3.0.0.65.09.31.zip
    • Oracle 11g の場合、次のコードを実行します。

      Copy
      mkdir /home/apexuser/apexlistener cd /home/apexuser/apexlistener unzip ../apex_listener.1.1.4.zip
  6. 前のステップのディレクトリにいる間に、リスナープログラムを実行します。

    Oracle バージョン Instructions

    12c

    以下の コードを実行します。

    Copy
    java -jar ords.war setup

    プログラムが以下の情報のプロンプトを表示します。デフォルト値は角括弧で囲まれています。

    • データベースサーバーの名前 [localhost]

    • データベースリッスンポート [1521]

    • データベースサービス名またはデータベース SID [1]

      データベースサービス名を指定するには 1、データベース SID を指定するには 2 です。

    • データベース SID [xe]

    • データベースユーザー名 [APEX_PUBLIC_USER]

    • データベースパスワード

    11g

    以下のコードを実行します。

    Copy
    java -Dapex.home=./apex -Dapex.images=/home/apexuser/apex/images -Dapex.erase -jar ./apex.war

    プログラムが以下のプロンプトを表示します。

    • APEX Listener Administrator のユーザー名。デフォルト値は adminlistener です。

    • APEX Listener Administrator のパスワード。

    • APEX Listener Manager のユーザー名。デフォルトでは managerlistener です。

    • APEX Listener Administrator のパスワード。

    設定の完了に必要な URL がプログラムによって次のように出力されます。

    Copy
    INFO: Please complete configuration at: http://localhost:8080/apex/listenerConfigure Database is not yet configured

    APEX Listener を実行したままにします。Oracle Application Express を使用するには、実行したままにする必要があります。この設定手順を完了したら、リスナーをバックグラウンドで実行できます。

    ウェブブラウザから、APEX Listener プログラムにより提供される URL にアクセスします。Oracle Application Express Listener の管理ウィンドウが表示されます。以下の情報を入力します。

    • UsernameAPEX_PUBLIC_USER

    • PasswordAPEX_PUBLIC_USER のパスワード。このパスワードは、APEX リポジトリの設定時に前の手順で指定したパスワードです。詳細については、「パブリックユーザーアカウントのロック解除」を参照してください。

    • Connection Type – Basic

    • Hostname – Amazon RDS DB インスタンスのエンドポイント。mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com など。

    • Port – 1521

    • SID – Amazon RDS DB インスタンスのデータベースの名前。mydb など。

    [Apply] を選択します。APEX 管理ウィンドウが表示されます。

  7. APEX admin ユーザーのパスワードを設定する必要があります。これを行うには、SQL*Plus を使用して DB インスタンスにマスターユーザーとして接続し、次のコマンドを発行します。

    Copy
    grant APEX_ADMINISTRATOR_ROLE to master; @/home/apexuser/apex/apxchpwd.sql

    master を自身のマスターユーザー名に置き換えます。apxchpwd.sql スクリプトによってプロンプトが表示されたら、新しい admin パスワードを入力します。

  8. 12c の場合のみ、APEX Listener を起動します。以下の コードを実行します。

    Copy
    java -jar ords.war

    APEX Listener を初めて開始すると、APEX の静的リソースの場所を指定するように求められます。このイメージフォルダは、APEX のインストールディレクトリ内の /apex/images ディレクトリにあります。

  9. ブラウザで APEX 管理ウィンドウに戻り、[Administration] を選択します。次に、[Application Express Internal Administration] を選択します。認証情報の入力を求められたら、以下の情報を入力します。

    • User nameadmin

    • Passwordapxchpwd.sql スクリプトを使用して設定したパスワード。

    [Login] を選択し、その admin ユーザーの新しいパスワードを設定します。

これで、APEX リスナーを使用する準備ができました。

APEX オプションの削除

DB インスタンスから APEX オプションを削除できます。APEX オプションを DB インスタンスから削除するには、次のいずれかを実行します。

  • 複数の DB インスタンスから APEX オプションを削除するには、それらが属しているオプショングループから APEX オプションを削除します。この変更はそのオプショングループを使用するすべての DB インスタンスに影響します。複数の DB インスタンスにアタッチされているオプショングループから APEX オプションを削除すると、すべての DB インスタンスが再起動される間、短時間の停止が発生します。

    詳細については、「オプショングループからオプションを削除する」を参照してください。

  • 1 つの DB インスタンスから APEX オプションを削除するには、DB インスタンスを変更し、APEX オプションを含まない別のオプショングループを指定します。デフォルト (空) のオプショングループや別のカスタムオプショングループを指定できます。APEX オプションを削除する場合、DB インスタンスを自動的に再起動している間に短い停止が発生します。

    詳細については、「Oracle データベースエンジンを実行する DB インスタンスの変更」を参照してください。

関連トピック