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

Oracle Application Express

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

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

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

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

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

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

  • Oracle APEX バージョン 5.1.2.v1

  • Oracle APEX バージョン 5.0.4.v1

  • Oracle APEX バージョン 4.2.6.v1

 

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

  • Oracle APEX バージョン 5.1.2.v1

  • Oracle APEX バージョン 5.0.4.v1

  • Oracle APEX バージョン 4.2.6.v1

  • Oracle APEX バージョン 4.1.1.v1

 

Oracle APEX および APEX Listener の前提条件

Oracle APEX および APEX Listener を使用するための前提条件は次のとおりです。

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

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

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

    • Oracle APEX Listener から Amazon RDS インスタンスに接続するための Oracle Net Services。

Amazon RDS APEX オプションの追加

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

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

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

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

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

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

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

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

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

    3. [APEX Version] で使用する APEX のバージョンを選択します。バージョンを選択しない場合、11g にはバージョン 4.1.1.v1、12c にはバージョン 4.2.6.v1 がデフォルトとなります。

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

  2. オプショングループにオプションを追加します。Oracle APEX ランタイム環境のみをデプロイする場合には、APEX オプションのみを追加します。完全なデプロイ環境をデプロイする場合は、APEXAPEX-DEV の両方のオプションを追加します。

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

    • Oracle 11g には、最初に [XMLDB] オプションを前提条件として追加し、続いて [APEX] と [APEX-DEV] オプションを追加します。

    重要

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

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

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

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

Amazon RDS 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 で使用するようにインストールして設定する準備ができました。次のいずれかの製品をこの目的で使用できます。

  • APEX バージョン 5.0 以降では、Oracle Rest Data Services (ORDS) を使用します。

  • APEX バージョン 4.1.1 では、Oracle APEX Listener バージョン 1.1.4 を使用します。

  • 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 ファイルを解凍します。

    リスナーのタイプ Instructions

    ORDS

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

    Copy
    unzip ords.<version>.zip

    APEX リスナー

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

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

    リスナーのタイプ Instructions

    ORDS

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

    Copy
    mkdir /home/apexuser/ORDS cd /home/apexuser/ORDS unzip ../ords.<version>.zip

    APEX リスナー

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

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

    リスナーのタイプ Instructions

    ORDS

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

    Copy
    java -jar ords.war setup

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

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

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

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

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

    • データベース SID [xe]

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

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

    APEX リスナー

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

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

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

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

    • APEX Listener Administrator のパスワード。

    • APEX リスナーマネージャのユーザー名。デフォルトは 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
    EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role; grant APEX_ADMINISTRATOR_ROLE to master; @/home/apexuser/apex/apxchpwd.sql

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

  8. ORDS では、APEX リスナーを開始します。以下のコードを実行します。

    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 バージョンを使用している場合、DB インスタンスと同時に APEX バージョンもアップグレードできます。これで DB インスタンスのアップグレードに要する時間を短縮できます。

重要

APEX をアップグレードする前に、DB インスタンスをバックアップします。詳細については、「DB スナップショットの作成」および「アップグレードをテストする」を参照してください。

APEX を DB インスタンスと共にアップグレードするには、以下を実行します。

  • DB インスタンスのアップグレードしたバージョン用に新規のオプショングループを作成します。

  • 新規のオプショングループにアップグレードしたバージョンの APEX と APEX-DEV を追加します。DB インスタンスが使用するそのほかのすべてのオプションを含めるようにします。詳細については、「オプショングループに関する考慮事項」を参照してください。

  • DB インスタンスをアップグレードするときに、アップグレードした DB インスタンスに新規のオプショングループを指定します。

APEX のバージョンをアップグレード後、以前のバージョンの APEX スキーマがデータベースに存在している場合があります。不要な場合には、アップグレード後に古い APEX スキーマをデータベースから削除できます。

APEX オプションの削除

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

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

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

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

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

DB インスタンスから APEX オプションを削除すると、APEX スキーマがデータベースから削除されます。

関連トピック