Amazon Relational Database Service
用户指南 (API Version 2014-10-31)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

Oracle Application Express

Amazon RDS 通过使用 APEXAPEX-DEV 选项支持 Oracle Application Express (APEX)。可以将 Oracle APEX 作为运行时环境或基于 Web 的应用程序的完整开发环境部署。使用 Oracle APEX,开发人员可完全在 Web 浏览器内构建应用程序。有关详细信息,请参阅 Oracle 文档中的 Oracle Application Express

Oracle APEX 包含两个主要组件:

  • 存储 APEX 应用程序和组件元数据的存储库。该存储库包含安装在 Amazon RDS 数据库实例内的表、索引和其他对象。

  • 管理与 Oracle APEX 客户端的 HTTP 通信的侦听器。该侦听器接受来自 Web 浏览器的传入连接并将这些连接转发至 Amazon RDS 数据库实例进行处理,然后将来自存储库的结果发送回浏览器。APEX Listener 在 Oracle 12c 中重命名为 Oracle Rest Data Services (ORDS)。

将 Amazon RDS APEX 选项添加到数据库实例时,Amazon RDS 仅安装 Oracle APEX 存储库。您必须将 Oracle APEX Listener 安装于单独主机上,例如 Amazon EC2 实例、您公司的本地服务器或您的台式计算机。

对于 Oracle 12c,Amazon RDS 支持 Oracle APEX 的以下版本:

  • Oracle APEX 版本 5.1.2.v1

  • Oracle APEX 版本 5.0.4.v1

  • Oracle APEX 版本 4.2.6.v1

 

对于 Oracle 11g,Amazon RDS 支持 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 的先决条件:

  • 您必须使用 SQL*Plus 在数据库实例上执行管理任务。

  • 您必须在充当 Oracle APEX Listener 的主机计算机上安装以下软件:

    • Java 运行时环境 (JRE)。

    • Oracle Net Services,使 Oracle APEX Listener 能够与 Amazon RDS 实例连接。

添加 Amazon RDS APEX 选项

将 Amazon RDS APEX 选项添加到数据库实例的一般过程如下所示:

  1. 创建新的选项组,或者复制或修改现有选项组。

  2. 将选项添加到该选项组。

  3. 将选项组与数据库实例相关联。

如果添加 Amazon RDS APEX 选项,则在您的数据库实例自动重新启动时会出现短暂中断。

将 APEX 选项添加到数据库实例

  1. 确定您想要使用的选项组。您可以创建新的选项组,或使用现有选项组。如果您想使用现有选项组,请跳到下一步。或者,通过以下设置创建自定义数据库选项组:

    1. 对于 Engine,请选择要使用的 Oracle 版本。所有版本均支持 APEX 选项。

    2. 对于 Major Engine Version,请选择 11.212.1

    3. 对于 APEX Version,选择要使用的 APEX 版本。如果您未选择版本,则版本 4.1.1.v1 为 11g 的默认版本,版本 4.2.6.v1 为 12c 的默认版本。

    有关更多信息,请参阅 创建选项组

  2. 将选项添加到该选项组。如果您只希望部署 Oracle APEX 运行时环境,则仅添加 APEX 选项。如果希望部署完整开发环境,则同时添加 APEXAPEX-DEV 选项。

    • 对于 Oracle 12c,请添加 APEXAPEX-DEV 选项。

    • 对于 Oracle 11g,请先添加 XMLDB 选项作为先决条件,然后添加 APEXAPEX-DEV 选项。

    重要

    如果在已挂载到一个或多个数据库实例的现有选项组中添加 APEX 选项,所有数据库实例自动重新启动时都会发生短暂中断。

    有关添加选项的更多信息,请参阅 将选项添加到选项组

  3. 将选项组应用到新的或现有的数据库实例:

解锁公共用户账户

安装 Amazon RDS APEX 选项后,您必须更改 APEX 公共用户账户的密码,然后解锁账户。您可以使用 Oracle SQL*Plus 命令行实用工具执行此操作。以主用户身份连接到数据库实例,并发出以下命令。使用所选密码替换 new_password

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

安装和配置 APEX Listener

现在一切就绪,可以安装和配置用于 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 Listener。对于在 Internet 上运行的应用程序而言,Oracle 一般不建议使用嵌入 PL/SQL 网关。

您必须将 APEX Listener 安装于单独主机上,例如 Amazon EC2 实例、您公司的本地服务器或您的台式计算机。

以下过程介绍了如何安装和配置 APEX Listener。假设您的主机名称为 myapexhost.example.com 且运行 Linux。

安装和配置 APEX Listener

  1. root 的身份登录到 myapexhost.example.com

  2. 创建一个非特权操作系统用户,以控制 APEX Listener 安装。以下命令会创建一个名为 apexuser 的新用户。

    useradd -d /home/apexuser apexuser

    以下命令会为新用户分配密码。

    passwd apexuser;
  3. myapexhost.example.com 登录 apexuser,从 Oracle 上下载 APEX 和 APEX Listener 安装文件:

  4. 解压缩 APEX 文件:

    侦听器类型 说明

    ORDS

    运行以下代码:

    unzip ords.<version>.zip

    APEX Listener

    运行以下代码:

    unzip apex_<version>.zip
  5. 创建新目录,打开 APEX Listener 文件:

    侦听器类型 说明

    ORDS

    运行以下代码:

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

    APEX Listener

    运行以下代码:

    mkdir /home/apexuser/apexlistener cd /home/apexuser/apexlistener unzip ../apex_listener.<version>.zip
  6. 请在上个步骤的目录中运行侦听器程序。

    侦听器类型 说明

    ORDS

    运行以下代码:

    java -jar ords.war setup

    程序会提示您输入以下信息。括号中为默认值。

    • 数据库服务器的名称 [localhost]

    • 数据库侦听端口 [1521]

    • 数据库服务名称或数据库 SID [1]

      1 指定数据库服务名称,2 指定数据库 SID

    • 数据库 SID [xe]

    • 数据库用户名 [APEX_PUBLIC_USER]

    • 数据库密码

    APEX Listener

    运行以下代码:

    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 以完成配置,如下所示:

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

    使 APEX Listener 处于运行状态。此程序需要持续运行,以便于您使用 Oracle Application Express。完成此配置过程后,可在后台运行侦听器。

    从 Web 浏览器内转到 APEX Listener 程序提供的 URL。显示 Oracle Application Express Listener 管理窗口。键入以下信息:

    • 用户名APEX_PUBLIC_USER

    • 密码APEX_PUBLIC_USER 的密码。这是您先前配置 APEX 存储库时指定的密码。有关更多信息,请参阅 解锁公共用户账户

    • 连接类型 – 基本

    • 主机名 – 您的 Amazon RDS 数据库实例的终端节点,例如 mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com

    • 端口 – 1521

    • SID – Amazon RDS 数据库实例上的数据库名称,例如 mydb

    选择 Apply。显示 APEX 管理窗口。

  7. 您必须为 APEX admin 用户设置密码。要执行此操作,请使用 SQL*Plus 以主用户身份连接到数据库实例,并发出以下命令:

    EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role; grant APEX_ADMINISTRATOR_ROLE to master; @/home/apexuser/apex/apxchpwd.sql

    使用主用户名替换 masterapxchpwd.sql 脚本提示时键入新的 admin 密码。

  8. 对于 ORDS,启动 APEX Listener。运行以下代码:

    java -jar ords.war

    首次启动 APEX Listener 时,系统会提示您提供 APEX 静态资源的位置。此映像文件夹位于 APEX 安装目录下的 /apex/images 目录中。

  9. 返回浏览器内的 APEX 管理窗口,然后选择 Administration。接下来选择 Application Express Internal Administration。当系统提示您提供凭证时,输入以下信息:

    • 用户名admin

    • 密码 – 使用 apxchpwd.sql 脚本设置的密码

    选择 Login,然后设置 admin 用户的新密码。

APEX Listener 现在已可以使用。

升级 APEX 版本

如果您计划对数据库实例进行主要版本升级,并且您正在使用与您的目标数据库版本不兼容的 APEX 版本,则可以在升级数据库实例的同时升级 APEX 版本。这可以减少升级数据库实例所需的时间。

重要

在升级 APEX 之前,请对数据库实例进行备份。有关更多信息,请参阅 创建数据库快照测试升级

要将 APEX 与数据库实例一起升级,请执行以下操作:

  • 为数据库实例的升级后版本创建一个新的选项组。

  • 将 APEX 和 APEX-DEV 的升级后版本添加到该新选项组。确保包括数据库实例使用的任何其他选项。有关更多信息,请参阅 选项组注意事项

  • 在升级数据库实例时,请为升级后的数据库实例指定该新选项组。

在升级 APEX 版本后,早期版本的 APEX 架构可能仍在您的数据库中。如果您不再需要旧的 APEX 架构,可在升级后从数据库中将其删除。

删除 APEX 选项

可以从数据库实例中删除 Amazon RDS APEX 选项。要从数据库实例中删除 APEX 选项,请执行下列操作之一:

  • 要从多个数据库实例中删除 APEX 选项,请从其所属的选项组中删除 APEX 选项。此更改会影响使用该选项组的所有数据库实例。如果从已挂载到多个数据库实例的选项组中删除 APEX 选项,所有数据库实例重新启动时都会发生短暂中断。

    有关更多信息,请参阅 从选项组中移除选项

  • 要从单个数据库实例中删除 APEX 选项,请修改该数据库实例,并指定另一个不包含 APEX 选项的选项组。您可以指定默认 (空) 选项组,或指定其他自定义选项组。如果删除 APEX 选项,您的数据库实例在自动重新启动时会出现短暂中断。

    有关更多信息,请参阅 修改运行 Oracle 数据库引擎的数据库实例

在从数据库实例中删除 APEX 选项时,将从数据库中删除 APEX 架构。

相关主题