Oracle Application Express (APEX) - Amazon Relational Database Service
APEXKomponentenAPEXVersionsanforderungenAnforderungen für APEX und ORDSAPEXOptionen hinzufügenEntsperren des öffentlichen Benutzerkontos RESTfulDienste konfigurierenDie Installation ORDS auf einem separaten Host wird vorbereitetORDS21 und niedriger einrichtenORDS22 und höher einrichtenAPEXOracle-Listener einrichtenAktualisierung der APEX VersionEntfernen der Option

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Oracle Application Express (APEX)

Amazon RDS unterstützt Oracle Application Express (APEX) mithilfe der APEX-DEV Optionen APEX und. Sie können Oracle APEX als Laufzeitumgebung oder als vollständige Entwicklungsumgebung für webbasierte Anwendungen einsetzen. Mit Oracle APEX können Sie Anwendungen vollständig im Webbrowser erstellen. Weitere Informationen finden Sie unter Oracle Application Express in der Oracle-Dokumentation.

APEXKomponenten

Oracle APEX besteht aus den folgenden Hauptkomponenten:

  • Ein Repository, das die Metadaten für APEX Anwendungen und Komponenten speichert. Das Repository besteht aus Tabellen, Indizes und anderen Objekten, die in Ihrer Amazon RDS DB-Instance installiert sind.

  • Ein Listener, der die HTTP Kommunikation mit APEX Oracle-Clients verwaltet. Der Listener befindet sich auf einem separaten Host, z. B. einer EC2 Amazon-Instance, einem lokalen Server in Ihrem Unternehmen oder Ihrem Desktop-Computer. Der Listener akzeptiert eingehende Verbindungen von Webbrowsern, leitet sie zur Verarbeitung an die RDS Amazon-DB-Instance weiter und sendet dann Ergebnisse aus dem Repository zurück an die Browser.

    RDSfor Oracle unterstützt die folgenden Arten von Listenern:

    • Verwenden Sie für APEX Version 5.0 und höher Oracle REST Data Services (ORDS) Version 19.1 und höher. Wir empfehlen, dass Sie die neueste unterstützte Version von Oracle APEX und ORDS verwenden. Diese Dokumentation beschreibt ältere Versionen nur aus Gründen der Abwärtskompatibilität.

    • Für APEX Version 4.1.1 können Sie Oracle APEX Listener Version 1.1.4 verwenden.

    • Sie können Oracle HTTP Server und Listener verwenden. mod_plsql

      Anmerkung

      Amazon unterstützt den XML HTTP Oracle-DB-Server mit dem eingebetteten SQL PL/-Gateway RDS nicht als Listener für. APEX Im Allgemeinen empfiehlt Oracle, das eingebettete SQL PL/Gateway nicht für Anwendungen zu verwenden, die im Internet ausgeführt werden.

    Weitere Informationen zu diesen Listener-Typen finden Sie unter Auswahl eines Web-Listeners in der Oracle-Dokumentation.

Wenn Sie die RDS APEX Amazon-Optionen zu Ihrer RDS Oracle-DB-Instance hinzufügen, RDS installiert Amazon nur das APEX Oracle-Repository. Installieren Sie Ihren Listener auf einem separaten Host.

APEXVersionsanforderungen

Die APEX Option verwendet Speicher in der DB-Instance-Klasse für Ihre DB-Instance. Im Folgenden sind die unterstützten Versionen und die ungefähren Speicheranforderungen für Oracle aufgeführtAPEX.

APEXVersion Speicheranforderungen Unterstützte Oracle-Database-Versionen Hinweise

APEXOracle-Version 23.2.v1

110 MiB

Alle

Diese Version enthält Patch 35895964: PSE BUNDLE FOR APEX 23.2 (PSESON TOP OF 23.2.0), _ 6. PATCH VERSION

APEXOracle-Version 23.1.v1

106 MiB

Alle

Diese Version enthält Patch 35283657: PSE BUNDLE FOR APEX 23.1 (PSESON TOP OF 23.1.0), _ 2. PATCH VERSION

APEXOracle-Version 22.2.v1

106 MiB

Alle

Diese Version enthält Patch 34628174: PSE BUNDLE FOR APEX 22.2 (PSESON TOP OF 22.2.0), _ 4. PATCH VERSION

APEXOracle-Version 22.1.v1

124 MiB

Alle

Diese Version enthält Patch 34020981: PSE BUNDLE FOR APEX 22.1 (PSESON TOP OF 22.1.0), _ 6. PATCH VERSION

APEXOracle-Version 21.2.v1

125 MiB

Alle

Diese Version enthält Patch 33420059: PSE BUNDLE FOR APEX 21.2 (PSESON TOP OF 21.2.0), _ 8. PATCH VERSION

APEXOracle-Version 21.1.v1

125 MiB

Alle

Diese Version enthält Patch 32598392: PSE BUNDLE FOR APEX 21.1, _ 3. PATCH VERSION

Oracle-Version 20.2.v1 APEX

148 MiB

Alle außer Oracle Database 2.1.c

Diese Version enthält Patch 32006852: PSE BUNDLE FOR APEX 20.2, _ 2020.11.12. PATCH VERSION Sie können die Patch-Nummer und das Datum sehen, indem Sie die folgende Abfrage ausführen:

SELECT PATCH_VERSION, PATCH_NUMBER 
FROM   APEX_PATCHES;

APEXOracle-Version 20.1.v1

173 MiB

Alle außer Oracle Database 2.1.c

Diese Version enthält Patch 30990551: PSE BUNDLE FOR APEX 20.1, _ 2020.07.15. PATCH VERSION

APEXOracle-Version 19.2.v1

149 MiB

Alle außer Oracle Database 2.1.c

APEXOracle-Version 19.1.v1

148 MiB

Alle außer Oracle Database 21c

APEXZIP-Dateien zum Herunterladen finden Sie in den Oracle APEX Prior Release-Archiven auf der Oracle-Website.

Oracle APEX und Anforderungen ORDS

Beachten Sie die folgenden Anforderungen für APEX undORDS:

  • Ihr System muss das Java Runtime Environment (JRE) verwenden.

  • Ihre Oracle-Client-Installation muss Folgendes beinhalten:

    • SQL*Plus oder SQL Developer für Verwaltungsaufgaben

    • Oracle Net Services für die Konfiguration von Verbindungen zu Ihrer RDS Oracle-DB-Instance

Hinzufügen der DEV Optionen APEX und APEX — zu Ihrer DB-Instance

Gehen Sie wie folgt vor, um die APEX-DEV Optionen APEX und RDS zu Ihrer Oracle-DB-Instance hinzuzufügen:

  1. Erstellen Sie eine neue Optionsgruppe oder kopieren oder ändern Sie eine bestehende Optionsgruppe.

  2. Fügen Sie der Optionsgruppe die Optionen APEX und APEX-DEV hinzu.

  3. Ordnen Sie die Optionsgruppe Ihrer DB-Instance zu.

Wenn Sie die RDS APEX Amazon-Optionen hinzufügen, kommt es zu einem kurzen Ausfall, während Ihre DB-Instance automatisch neu gestartet wird.

Anmerkung

APEX_MAIL ist verfügbar, wenn die Option APEX installiert ist. Die Ausführungsberechtigung für das APEX_MAIL Paket wird gewährt, PUBLIC sodass Sie kein APEX Administratorkonto benötigen, um es zu verwenden.

Um die APEX Optionen zu einer DB-Instance hinzuzufügen

  1. Bestimmen Sie die Optionsgruppe, die Sie verwenden möchten. Sie können eine Optionsgruppe erstellen oder eine bestehende Optionsgruppe verwenden. Wenn Sie eine bestehende Optionsgruppe verwenden möchten, fahren Sie mit dem nächsten Schritt fort. Erstellen Sie andernfalls eine benutzerdefinierte DB-Optionsgruppe mit folgenden Einstellungen:

    1. Wählen Sie im Feld Engine die Oracle-Edition aus, die Sie verwenden möchten. Die APEX Optionen werden in allen Editionen unterstützt.

    2. Wählen Sie für Major Engine Version (Engine-Hauptversion) die Version Ihrer DB-Instance aus.

    Weitere Informationen finden Sie unter Erstellen einer Optionsgruppe.

  2. Fügen Sie der Optionsgruppe die Optionen hinzu. Wenn Sie nur die APEX Oracle-Laufzeitumgebung bereitstellen möchten, fügen Sie nur die APEX Option hinzu. Um die vollständige Entwicklungsumgebung bereitzustellen, fügen Sie die APEX-DEV Optionen APEX und hinzu.

    Als Version wählen Sie die Version von APEX, die Sie verwenden möchten.

    Wichtig

    Wenn Sie die APEX Optionen zu einer vorhandenen Optionsgruppe hinzufügen, die bereits an eine oder mehrere DB-Instances angehängt ist, kommt es zu einem kurzen Ausfall. Während dieses Ausfalls werden alle DB-Instances automatisch neu gestartet.

    Weitere Informationen über das Hinzufügen von Optionen finden Sie unter Hinzufügen einer Option zu einer Optionsgruppe.

  3. Ordnen Sie die Optionsgruppe einer neuen oder bestehenden DB-Instance zu:

    • Einer neuen DB-Instance wird die Optionsgruppe beim Starten der Instance zugewiesen. Weitere Informationen finden Sie unter Erstellen einer Amazon RDS-DB-Instance.

    • Bei einer bestehenden DB-Instance weisen Sie die Optionsgruppe zu, indem Sie die Instance ändern und die neue Optionsgruppe anhängen. Wenn Sie die APEX Optionen zu einer vorhandenen DB-Instance hinzufügen, kommt es zu einem kurzen Ausfall, während Ihre DB-Instance automatisch neu gestartet wird. Weitere Informationen finden Sie unter Ändern einer Amazon RDS-DB-Instance.

Entsperren des öffentlichen Benutzerkontos auf Ihrer DB-Instance

Nachdem die RDS APEX Amazon-Optionen auf Ihrer DB-Instance installiert wurden, stellen Sie sicher, dass Sie wie folgt vorgehen:

  1. Ändern Sie das Passwort für das APEX öffentliche Benutzerkonto.

  2. Entsperren Sie das Konto.

Sie können dies tun, indem Sie das SQL Oracle*Plus-Befehlszeilenprogramm verwenden. Stellen Sie als Master-Benutzer eine Verbindung zur DB-Instance her und rufen Sie die folgenden Befehle auf. Ersetzen Sie new_password durch ein Passwort Ihrer Wahl. 

ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password;
ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;

RESTfulDienste für Oracle konfigurieren APEX

Um RESTful Dienste in zu konfigurieren APEX (für APEX 4.1.1.V1 nicht erforderlich), verwenden Sie SQL *Plus, um als Master-Benutzer eine Verbindung zu Ihrer DB-Instance herzustellen. Führen Sie anschließend die gespeicherte Prozedur rdsadmin.rdsadmin_run_apex_rest_config aus. Beim Ausführen der gespeicherten Prozedur geben Sie Passwörter für die folgenden Benutzer an:

  • APEX_LISTENER

  • APEX_REST_PUBLIC_USER

Die gespeicherte Prozedur führt das apex_rest_config.sql-Skript aus, mit dem neue Datenbankkonten für diese Benutzer erstellt werden.

Anmerkung

Für APEX Oracle-Version 4.1.1.v1 ist keine Konfiguration erforderlich. Nur für diese APEX Oracle-Version müssen Sie die gespeicherte Prozedur nicht ausführen.

Der folgende Befehl führt die gespeicherte Prozedur aus.

EXEC rdsadmin.rdsadmin_run_apex_rest_config('apex_listener_password', 'apex_rest_public_user_password');

Die Installation ORDS auf einem separaten Host wird vorbereitet

Installieren Sie ORDS auf einem separaten Host, z. B. einer EC2 Amazon-Instance, einem lokalen Server in Ihrem Unternehmen oder Ihrem Desktop-Computer. Bei den Beispielen in diesem Abschnitt wird davon ausgegangen, dass Ihr Host Linux ausführt und benannt myapexhost.example.com ist.

Bevor Sie mit der Installation ORDS beginnen können, müssen Sie einen Betriebssystembenutzer ohne Benutzerrechte erstellen und anschließend die APEX Installationsdatei herunterladen und entpacken.

Um die Installation vorzubereiten ORDS

  1. Melden Sie sich bei myapexhost.example.com als root an.

  2. Erstellen Sie einen Betriebssystembenutzer ohne administrative Rechte für die Listener-Installation. Mit dem folgenden Befehl wird ein neuer Benutzer mit dem Namen apexuser erstellt: 

    useradd -d /home/apexuser apexuser

    Der folgende Befehl weist dem neuen Benutzer ein Passwort zu. 

    passwd apexuser;

  3. Melden Sie sich an myapexhost.example.com als apexuser und laden Sie die APEX Installationsdatei von Oracle in Ihr /home/apexuser Verzeichnis herunter:

  4. Entpacken Sie die Datei im /home/apexuser-Verzeichnis.

    unzip apex_version.zip

    Nachdem Sie die Datei entpackt haben, ist ein apex-Verzeichnis im /home/apexuser-Verzeichnis vorhanden.

  5. Während Sie noch angemeldet myapexhost.example.com sindapexuser, laden Sie die Oracle REST Data Services-Datei von Oracle in Ihr /home/apexuser Verzeichnis herunter: http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html.

Installation und Konfiguration von ORDS Version 2.1 und niedriger

Sie sind jetzt bereit, Oracle Rest Data Services (ORDS) für die Verwendung mit Oracle zu installieren und zu konfigurierenAPEX. Verwenden Sie für APEX Version 5.0 und höher die ORDS Versionen 19.1 bis 21. Informationen zur Installation von Version ORDS 2.2 und höher finden Sie unterInstallation und Konfiguration von ORDS 2.2 und höher.

Installieren Sie den Listener auf einem separaten Host, z. B. einer EC2 Amazon-Instance, einem lokalen Server in Ihrem Unternehmen oder Ihrem Desktop-Computer. Für die Beispiele in diesem Abschnitt gehen wir davon aus, dass der Name Ihres Hosts myapexhost.example.com lautet und dass auf Ihrem Host Linux ausgeführt wird.

Um ORDS 2.1 und niedriger für die Verwendung mit Oracle zu installieren und zu konfigurieren APEX

  1. Gehen Sie zu Oracle REST Data Services und lesen Sie die Readme-Datei. Stellen Sie sicher, dass Sie die erforderliche Version von Java installiert haben.

  2. Erstellen Sie ein neues Verzeichnis für Ihre ORDS Installation.

    mkdir /home/apexuser/ORDS
cd /home/apexuser/ORDS

  3. Laden Sie die Datei ords.version.number.zip von Oracle REST Data Services herunter.

  4. Entpacken Sie die Datei im Verzeichnis /home/apexuser/ORDS.

  5. Wenn Sie ORDS in einer Multitenant-Datenbank installieren, fügen Sie der Datei /home/apexuser/ORDS/params/ords_params.properties die folgende Zeile hinzu:

    pdb.disable.lockdown=false

  6. Erteilen Sie dem Masterbenutzer die erforderlichen Rechte für die InstallationORDS.

    Nachdem die RDS APEX Amazon-Option installiert ist, geben Sie dem Master-Benutzer die erforderlichen Rechte, um das ORDS Schema zu installieren. Sie können dies tun, indem Sie sich mit der Datenbank verbinden und die folgenden Befehle ausführen. Ersetzen Sie MASTER_USER durch den Großbuchstaben Ihres Hauptbenutzers.

    Wichtig

    Verwenden Sie bei der Eingabe des Benutzernamens Großbuchstaben, es sei denn, Sie haben den Benutzer mit einer Kennung mit Groß- und Kleinschreibung erstellt. Wenn Sie z. B. CREATE USER myuser oder CREATE USER MYUSER ausführen , wird im Datenwörterbuch MYUSER gespeichert. Wenn Sie jedoch doppelte Anführungszeichen in CREATE USER "MyUser" verwenden, speichert das Datenwörterbuch MyUser. Weitere Informationen finden Sie unter Erteilen von SELECT- oder EXECUTE-Berechtigungen für SYS-Objekte.

    exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_ROLE_PRIVS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONS_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONSTRAINTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_OBJECTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_PROCEDURES', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TABLES', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_VIEWS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('WPIUTL', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SESSION', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_UTILITY', 'MASTER_USER', 'EXECUTE', true);
    Anmerkung

    Diese Befehle gelten für ORDS Version 19.1 und höher.

  7. Installieren Sie das ORDS Schema mithilfe der heruntergeladenen ords.war-Datei.

    java -jar ords.war install advanced

    Das Programm fordert Sie zur Eingabe der folgenden Informationen auf. Die Standardwerte stehen in eckigen Klammern. Weitere Informationen finden Sie in der Oracle-Dokumentation unter Einführung in Oracle REST Data Services.

    • Geben Sie den Speicherort für die Konfigurationsdaten ein:

      Enter /home/apexuser/ORDS. Dies ist der Speicherort der ORDS Konfigurationsdateien.

    • Geben Sie den zu verwendenden Datenbankverbindungstyp an. Geben Sie die Nummer für [1] Basic [2] TNS [3] Custom URL [1] ein:

      Wählen Sie den gewünschten Verbindungstyp.

    • Geben Sie den Namen des Datenbankservers [localhost] ein: DB_instance_endpoint

      Wählen Sie den Standardwert aus oder geben Sie einen passenden Wert ein.

    • Geben Sie den Datenbank-Listener-Port [1521] ein: DB_instance_port

      Wählen Sie den Standardwert aus oder geben Sie einen passenden Wert ein.

    • Geben Sie 1 ein, um den Namen des Datenbankdienstes anzugeben, oder 2, um die Datenbank SID [1] anzugeben:

      Wählen Sie2, ob Sie die Datenbank angeben möchtenSID.

    • Datenbank SID [xe]

      Wählen Sie den Standardwert aus oder geben Sie einen passenden Wert ein.

    • Geben Sie 1 ein, wenn Sie das Oracle REST Data Services-Schema überprüfen/installieren möchten, oder 2, um diesen Schritt zu überspringen [1]:

      Wählen Sie 1. In diesem Schritt wird der Oracle REST Data Services-Proxybenutzer mit dem Namen ORDS _ _ erstellt. PUBLIC USER

    • Geben Sie das Datenbankkennwort für ORDS _ PUBLIC _ einUSER:

      Geben Sie das Passwort ein und bestätigen Sie es.

    • Erfordert die Anmeldung mit Administratorrechten, um das Oracle REST Data Services-Schema zu überprüfen.

      Geben Sie den Administrator-Benutzernamen ein: master_user

      Geben Sie das Datenbankkennwort für ein master_user: master_user_password

      Bestätigen Sie das Passwort: master_user_password

      Anmerkung

      Geben Sie aus Sicherheitsgründen ein anderes Passwort als hier angegeben an.

    • Geben Sie den Standard-Tablespace für ORDS _ METADATA [SYSAUX] ein.

      Geben Sie den temporären Tablespace für ORDS _ METADATA [] TEMP ein.

      Geben Sie den Standard-Tablespace für ORDS _ PUBLIC _ USER [] USERS ein.

      Geben Sie den temporären Tablespace für ORDS _ PUBLIC _ USER [] TEMP ein.

    • Geben Sie 1 ein, wenn Sie SQL PL/Gateway verwenden möchten, oder 2, um diesen Schritt zu überspringen. Wenn Sie Oracle Application Express verwenden oder von mod_plsql migrieren, müssen Sie 1 [1] eingeben.

      Wählen Sie den Standardwert aus.

    • Geben Sie den SQL PL/Gateway-Datenbankbenutzernamen [APEX_ _PUBLIC] ein USER

      Wählen Sie den Standardwert aus.

    • Geben Sie das Datenbankkennwort für APEX _ PUBLIC _ USER ein:

      Geben Sie das Passwort ein und bestätigen Sie es.

    • Geben Sie 1 ein, um Passwörter für Application Express RESTful Services-Datenbankbenutzer (APEX_LISTENER, APEX _ REST PUBLIC _USER) anzugeben, oder 2, um diesen Schritt zu überspringen [1]:

      Wählen Sie 2 APEX 4.1.1.V1; wählen Sie 1 für alle anderen APEX Versionen.

    • [Nicht erforderlich für APEX 4.1.1.v1] Datenbank-Passwort für _ APEX LISTENER

      Geben Sie das Passwort ein (falls erforderlich) und bestätigen Sie es.

    • [Nicht erforderlich für APEX 4.1.1.v1] Datenbankpasswort für _ _ _ APEX REST PUBLIC USER

      Geben Sie das Passwort ein (falls erforderlich) und bestätigen Sie es.

    • Geben Sie eine Zahl ein, um eine Funktion auszuwählen, die aktiviert werden soll:

      Geben Sie ein1, um alle Funktionen zu aktivieren: SQL Developer WebSQL, REST Enabled und Database. API

    • Geben Sie 1 ein, wenn Sie im Standalone-Modus starten möchten, oder 2, um [1] zu beenden:

      Geben Sie ei 1.

    • Geben Sie den Speicherort der APEX statischen Ressourcen ein:

      Wenn Sie die APEX Installationsdateien entpackt haben/home/apexuser, geben Sie ein. /home/apexuser/apex/images Andernfalls geben Sie ein, wo unzip_path/apex/images unzip_path ist das Verzeichnis, in das Sie die Datei entpackt haben.

    • Geben Sie 1 ein, wenn Sie [1] verwenden, HTTP oder 2, wenn Sie HTTPS [1] verwenden:

      Wenn Sie eingeben1, geben Sie den HTTP Port an. Wenn Sie eingeben2, geben Sie den HTTPS Port und den SSL Hostnamen an. Die HTTPS Option fordert Sie auf, anzugeben, wie Sie das Zertifikat bereitstellen möchten:

      • Geben Sie 1 ein, um das selbstsignierte Zertifikat zu verwenden.

      • Geben Sie 2 ein, um Ihr eigenes Zertifikat vorzulegen. Wenn Sie eingeben2, geben Sie den Pfad für das SSL Zertifikat und den Pfad für den privaten Schlüssel des SSL Zertifikats an.

  8. Legen Sie ein Passwort für den APEX admin Benutzer fest. Verwenden Sie dazu SQL *Plus, um als Master-Benutzer eine Verbindung zu Ihrer DB-Instance herzustellen, und führen Sie dann die folgenden Befehle aus.

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

    Ersetzen Sie master durch den Masterbenutzernamen. Wenn Sie vom Skript apxchpwd.sql aufgefordert werden, geben Sie ein neues admin-Passwort ein.

  9. Starten Sie den ORDS Listener. Führen Sie folgenden Code aus.

    java -jar ords.war

    Beim ersten Start werden Sie aufgefordertORDS, den Speicherort der APEX statischen Ressourcen anzugeben. Dieser Bilderordner befindet sich in dem /apex/images Verzeichnis im Installationsverzeichnis fürAPEX.

  10. Kehren Sie zum APEX Administrationsfenster Ihres Browsers zurück und wählen Sie Administration. Wählen Sie anschließend Application Express Internal Administration. Wenn Sie zur Eingabe von Anmeldeinformationen aufgefordert werden, geben Sie die folgenden Informationen ein:

    • Benutzername – admin

    • Passwort: Das mit dem Skript apxchpwd.sql festgelegte Passwort

    Wählen Sie Anmeldung und legen Sie dann ein neues Passwort für den Benutzer admin fest.

Ihr Listener ist nun einsatzbereit.

Installation und Konfiguration von ORDS 2.2 und höher

Sie sind jetzt bereit, Oracle Rest Data Services (ORDS) für die Verwendung mit Oracle zu installieren und zu konfigurierenAPEX. Für die Beispiele in diesem Abschnitt gehen wir davon aus, dass der Name Ihres separaten Hosts lautet myapexhost.example.com und dass auf Ihrem Host Linux ausgeführt wird. Die Anweisungen für ORDS 22 unterscheiden sich von den Anweisungen für frühere Versionen.

Um ORDS 22 und höher für die Verwendung mit Oracle zu installieren und zu konfigurieren APEX

  1. Gehen Sie zu Oracle REST Data Services und suchen Sie in der Readme-Datei nach der ORDS Version, die Sie herunterladen möchten. Stellen Sie sicher, dass Sie die erforderliche Version von Java installiert haben.

  2. Erstellen Sie ein neues Verzeichnis für Ihre ORDS Installation.

    mkdir /home/apexuser/ORDS
cd /home/apexuser/ORDS

  3. Laden Sie die Datei ords.version.number.zip oder ords-latest.zip von Oracle REST Data Services herunter.

  4. Entpacken Sie die Datei im Verzeichnis /home/apexuser/ORDS.

  5. Erteilen Sie dem Master-Benutzer die erforderlichen Rechte für die InstallationORDS.

    Nachdem die RDS APEX Amazon-Option installiert ist, geben Sie dem Master-Benutzer die erforderlichen Rechte, um das ORDS Schema zu installieren. Sie können dies tun, indem Sie sich bei der Datenbank anmelden und die folgenden Befehle ausführen. Ersetzen Sie MASTER_USER durch den Großbuchstaben Ihres Hauptbenutzers.

    Wichtig

    Verwenden Sie bei der Eingabe des Benutzernamens Großbuchstaben, es sei denn, Sie haben den Benutzer mit einer Kennung mit Groß- und Kleinschreibung erstellt. Wenn Sie z. B. CREATE USER myuser oder CREATE USER MYUSER ausführen , wird im Datenwörterbuch MYUSER gespeichert. Wenn Sie jedoch doppelte Anführungszeichen in CREATE USER "MyUser" verwenden, speichert das Datenwörterbuch MyUser. Weitere Informationen finden Sie unter Erteilen von SELECT- oder EXECUTE-Berechtigungen für SYS-Objekte.

    exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_ROLE_PRIVS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONS_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONSTRAINTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_OBJECTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_PROCEDURES', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TABLES', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_VIEWS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('WPIUTL', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SESSION', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_UTILITY', 'MASTER_USER', 'EXECUTE', true);

exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_LOB', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_ASSERT', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_OUTPUT', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SCHEDULER', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('HTP', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('OWA', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('WPG_DOCLOAD', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_CRYPTO', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_METADATA', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SQL', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('UTL_SMTP', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_NETWORK_ACL_ADMIN', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('SESSION_PRIVS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_USERS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_NETWORK_ACL_PRIVILEGES', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_NETWORK_ACLS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_REGISTRY', 'MASTER_USER', 'SELECT', true);
    Anmerkung

    Die obigen Befehle gelten für Version ORDS 2.2 und höher.

  6. Installieren Sie das ORDS Schema mithilfe des heruntergeladenen ords Skripts. Geben Sie Verzeichnisse an, die Konfigurationsdateien und Protokolldateien enthalten sollen. Die Oracle Corporation empfiehlt, diese Verzeichnisse nicht in dem Verzeichnis zu platzieren, das die ORDS Produktsoftware enthält.

    mkdir -p /home/apexuser/ords_config /home/apexuser/ords_logs

/home/apexuser/ORDS/bin/ords \
  --config /home/apexuser/ords_config \
  install --interactive --log-folder /home/apexuser/ords_logs

    Verwenden Sie für DB-Instances, auf denen die Container-Database (CDB) -Architektur ausgeführt wird, ORDS 23.2 und höher und übergeben Sie das --pdb-skip-disable-lockdown Argument bei der InstallationORDS.

    /home/apexuser/ORDS/bin/ords \
  --config /home/apexuser/ords_config \
  install --interactive --log-folder /home/apexuser/ords_logs --pdb-skip-disable-lockdown

    Das Programm fordert Sie zur Eingabe der folgenden Informationen auf. Die Standardwerte stehen in eckigen Klammern. Weitere Informationen finden Sie in der Oracle-Dokumentation unter Einführung in Oracle REST Data Services.

    • Choose the type of installation:

      Wählen 2 Sie, ob ORDS Schemas in der Datenbank installiert und in den lokalen ORDS Konfigurationsdateien ein Datenbankverbindungspool erstellt werden soll.

    • Specify the database connection type to use. Enter number for [1] Basic [2] TNS [3] Custom URL:

      Wählen Sie den gewünschten Verbindungstyp. In diesem Beispiel wird davon ausgegangen, dass Sie wählen1.

    • Enter the name of the database server [localhost]: DB_instance_endpoint

      Wählen Sie den Standardwert aus oder geben Sie einen passenden Wert ein.

    • Enter the database listener port [1521]: DB_instance_port

      Wählen Sie die Standardeinstellung 1521 oder geben Sie den richtigen Wert ein.

    • Enter the database service name [orcl]:

      Geben Sie den Datenbanknamen ein, den Ihre RDS Oracle-DB-Instance verwendet.

    • Provide database user name with administrator privileges

      Geben Sie den Master-Benutzernamen RDS für Ihre Oracle-DB-Instance ein.

    • Enter the database password for [username]:

      Geben Sie das Master-Benutzerpasswort RDS für Ihre Oracle-DB-Instance ein.

    • Enter the default tablespace for ORDS_METADATA and ORDS_PUBLIC_USER [SYSAUX]:

    • Enter the temporary tablespace for ORDS_METADATA [TEMP]. Enter the default tablespace for ORDS_PUBLIC_USER [USERS]. Enter the temporary tablespace for ORDS_PUBLIC_USER [TEMP].

    • Enter a number to select additional feature(s) to enable [1]:

    • Enter a number to configure and start ORDS in standalone mode [1]:

      Wählen Sie2, ob der ORDS sofortige Start im Standalone-Modus übersprungen werden soll.

    • Enter a number to select the protocol [1] HTTP

    • Enter the HTTP port [8080]:

    • Enter the APEX static resources location:

      Geben Sie den Pfad zu den APEX Installationsdateien ein (/home/apexuser/apex/images).

  7. Legen Sie ein Passwort für den APEX admin Benutzer fest. Verwenden Sie dazu SQL *Plus, um als Master-Benutzer eine Verbindung zu Ihrer DB-Instance herzustellen, und führen Sie dann die folgenden Befehle aus.

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

    Ersetzen Sie master durch den Masterbenutzernamen. Wenn Sie vom Skript apxchpwd.sql aufgefordert werden, geben Sie ein neues admin-Passwort ein.

  8. Führen Sie es ORDS im Standalone-Modus mit dem ords Skript mit dem serve Befehl aus. Für Produktionsbereitstellungen sollten Sie die Verwendung unterstützter Java EE-Anwendungsserver wie Apache Tomcat oder Oracle WebLogic Server in Betracht ziehen. Weitere Informationen finden Sie unter Deployment and Monitoring Oracle REST Data Services in der Oracle Database-Dokumentation.

    /home/apexuser/ORDS/bin/ords \
  --config /home/apexuser/ords_config serve \
  --port 8193 \
  --apex-images /home/apexuser/apex/images

    Wenn ausgeführt ORDS wird, aber nicht auf die APEX Installation zugegriffen werden kann, wird möglicherweise der folgende Fehler angezeigt, insbesondere bei CDB Nicht-Instances. 

    The procedure named apex_admin could not be accessed, it may not be declared, or the user executing this request may not have been granted execute privilege on the procedure, or a function specified by security.requestValidationFunction configuration property has prevented access.

    Um diesen Fehler zu beheben, ändern Sie die von verwendete Anforderungsvalidierungsfunktion, ORDS indem Sie das ords Skript mit dem config Befehl ausführen. ORDSVerwendet standardmäßig das ords_util.authorize_plsql_gateway Verfahren, das nur auf CDB Instanzen unterstützt wird. Für CDB Nicht-Instances können Sie dieses Verfahren auf das wwv_flow_epg_include_modules.authorize Paket übertragen. Bewährte Methoden zur Konfiguration der richtigen Anforderungsvalidierungsfunktion für Ihren Anwendungsfall finden Sie in der Oracle Database-Dokumentation und im Oracle-Support.

  9. Kehren Sie zum APEX Administrationsfenster Ihres Browsers zurück und wählen Sie Administration. Wählen Sie anschließend Application Express Internal Administration. Wenn Sie zur Eingabe von Anmeldeinformationen aufgefordert werden, geben Sie die folgenden Informationen ein:

    • Benutzername – admin

    • Passwort: Das mit dem Skript apxchpwd.sql festgelegte Passwort

    Wählen Sie Anmeldung und legen Sie dann ein neues Passwort für den Benutzer admin fest.

Ihr Listener ist nun einsatzbereit.

APEXOracle-Listener einrichten

Anmerkung

Oracle APEX Listener ist veraltet.

Amazon RDS for Oracle unterstützt weiterhin APEX Version 4.1.1 und Oracle APEX Listener Version 1.1.4. Wir empfehlen Ihnen, die neuesten unterstützten Versionen von Oracle und zu verwenden. APEX ORDS

Installieren Sie Oracle APEX Listener auf einem separaten Host, z. B. einer EC2 Amazon-Instance, einem lokalen Server in Ihrem Unternehmen oder Ihrem Desktop-Computer. Wir unterstellen myapexhost.example.com als Namen des Hosts, auf dem außerdem Linux ausgeführt wird.

Die Installation von Oracle Listener wird vorbereitet APEX

Bevor Sie Oracle APEX Listener installieren können, müssen Sie einen Betriebssystembenutzer ohne Zugriffsrechte erstellen und dann die Installationsdatei herunterladen und entpacken. APEX

Um die Installation des Oracle Listeners vorzubereiten APEX

  1. Melden Sie sich bei myapexhost.example.com als root an.

  2. Erstellen Sie einen Betriebssystembenutzer ohne administrative Rechte für die Listener-Installation. Mit dem folgenden Befehl wird ein neuer Benutzer mit dem Namen apexuser erstellt: 

    useradd -d /home/apexuser apexuser

    Der folgende Befehl weist dem neuen Benutzer ein Passwort zu. 

    passwd apexuser;

  3. Melden Sie sich an myapexhost.example.com als apexuser und laden Sie die APEX Installationsdatei von Oracle in Ihr /home/apexuser Verzeichnis herunter:

  4. Entpacken Sie die Datei im /home/apexuser-Verzeichnis.

    unzip apex_<version>.zip

    Nachdem Sie die Datei entpackt haben, ist ein apex-Verzeichnis im /home/apexuser-Verzeichnis vorhanden.

  5. Während Sie noch angemeldet myapexhost.example.com sindapexuser, laden Sie die Oracle APEX Listener-Datei von Oracle in Ihr /home/apexuser Verzeichnis herunter.

Oracle APEX Listener installieren und konfigurieren

Bevor Sie es verwenden könnenAPEX, müssen Sie die apex.war-Datei herunterladen, Oracle APEX Listener mit Java installieren und dann den Listener starten.

Um den Oracle Listener zu installieren und zu konfigurieren APEX

  1. Erstellen Sie ein neues Verzeichnis, das auf Oracle APEX Listener basiert, und öffnen Sie die Listener-Datei.

    Führen Sie folgenden Code aus:

    mkdir /home/apexuser/apexlistener
cd /home/apexuser/apexlistener 
unzip ../apex_listener.version.zip

  2. Führen Sie folgenden Code aus.

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

  3. Geben Sie folgende Informationen in der Eingabeaufforderung des Programms ein:

    • Der Benutzername des APEX Listener-Administrators. Der Standardwert ist adminlistener.

    • Ein Passwort für den APEX Listener-Administrator.

    • Der APEX Listener Manager-Benutzername. Der Standardwert ist managerlistener.

    • Ein Passwort für den APEX Listener-Administrator.

    Das Programm druckt eineURL, die Sie zum Abschließen der Konfiguration benötigen, wie folgt aus.

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

  4. Lassen Sie Oracle APEX Listener laufen, damit Sie Oracle Application Express verwenden können. Nachdem Sie dieses Konfigurationsverfahren abgeschlossen haben, können Sie den Listener im Hintergrund ausführen lassen.

  5. Rufen Sie in Ihrem Webbrowser das vom APEX Listener URL bereitgestellte Programm auf. Das Oracle Application Express Listener-Administrationsfenster wird angezeigt. Geben Sie die folgenden Informationen ein:

    • Benutzername – APEX_PUBLIC_USER

    • Passwort — das Passwort für APEX_ PUBLIC _ USER. Dieses Passwort haben Sie zuvor bei der Konfiguration des APEX Repositorys angegeben. Weitere Informationen finden Sie unter Entsperren des öffentlichen Benutzerkontos auf Ihrer DB-Instance.

    • Connection type (Verbindungstyp) – Basic (Einfach)

    • Hostname — der Endpunkt Ihrer Amazon RDS DB-Instance, z. B. mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com

    • Port – 1521

    • SID— der Name der Datenbank auf Ihrer Amazon RDS DB-Instance, z. mydb B.

  6. Wählen Sie Apply (Anwenden) aus. Das APEX Administrationsfenster wird angezeigt.

  7. Legen Sie ein Passwort für den APEX admin Benutzer fest. Verwenden Sie dazu SQL *Plus, um als Master-Benutzer eine Verbindung zu Ihrer DB-Instance herzustellen, und führen Sie dann die folgenden Befehle aus.

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

    Ersetzen Sie master durch den Masterbenutzernamen. Wenn Sie vom Skript apxchpwd.sql aufgefordert werden, geben Sie ein neues admin-Passwort ein.

  8. Kehren Sie zum APEX Administrationsfenster Ihres Browsers zurück und wählen Sie Administration. Wählen Sie anschließend Application Express Internal Administration. Wenn Sie zur Eingabe von Anmeldeinformationen aufgefordert werden, geben Sie die folgenden Informationen ein:

    • Benutzername – admin

    • Passwort: Das mit dem Skript apxchpwd.sql festgelegte Passwort

    Wählen Sie Anmeldung und legen Sie dann ein neues Passwort für den Benutzer admin fest.

Ihr Listener ist nun einsatzbereit.

Aktualisierung der APEX Version

Wichtig

Erstellen Sie vor dem Upgrade eine Sicherungskopie Ihrer DB-InstanceAPEX. Weitere Informationen erhalten Sie unter Erstellen eines DB-Snapshots für eine Single-AZ-DB-Instance und Testen eines Oracle DB-Upgrades.

Gehen Sie wie folgt vor, um ein Upgrade APEX mit Ihrer DB-Instance durchzuführen:

  • Erstellen Sie eine neue Optionsgruppe für die aktualisierte Version Ihrer DB-Instance.

  • Fügen Sie die aktualisierten Versionen von APEX und APEX - DEV zur neuen Optionsgruppe hinzu. Achten Sie darauf, alle anderen Optionen aufzunehmen, die Ihre DB-Instance verwendet. Weitere Informationen finden Sie unter Überlegungen zu Optionsgruppen.

  • Geben Sie beim Aktualisieren der DB-Instance die neue Optionsgruppe für Ihre aktualisierte DB-Instance an.

Nach dem Upgrade Ihrer Version von APEX ist das APEX Schema für die vorherige Version möglicherweise noch in Ihrer Datenbank vorhanden. Wenn Sie es nicht mehr benötigen, können Sie das alte APEX Schema nach dem Upgrade aus Ihrer Datenbank löschen.

Wenn Sie die APEX Version aktualisieren und RESTful Dienste in der vorherigen APEX Version nicht konfiguriert wurden, empfehlen wir Ihnen, RESTful Dienste zu konfigurieren. Weitere Informationen finden Sie unter RESTfulDienste für Oracle konfigurieren APEX.

In einigen Fällen, wenn Sie ein Upgrade der Hauptversion Ihrer DB-Instance planen, stellen Sie möglicherweise fest, dass Sie eine APEX Version verwenden, die nicht mit Ihrer Zieldatenbankversion kompatibel ist. In diesen Fällen können Sie Ihre Version von aktualisieren, APEX bevor Sie Ihre DB-Instance aktualisieren. Wenn Sie APEX zuerst ein Upgrade durchführen, kann dies die Zeit reduzieren, die für das Upgrade Ihrer DB-Instance benötigt wird.

Anmerkung

Installieren und konfigurieren Sie nach dem Upgrade APEX einen Listener für die Verwendung mit der aktualisierten Version. Detaillierte Anweisungen finden Sie unter APEXOracle-Listener einrichten.

Die Option wird APEX entfernt

Sie können die RDS APEX Amazon-Optionen aus einer DB-Instance entfernen. Gehen Sie wie folgt vor, um die APEX Optionen aus einer DB-Instance zu entfernen:

  • Um die APEX Optionen aus mehreren DB-Instances zu entfernen, entfernen Sie die APEX Optionen aus der Optionsgruppe, zu der sie gehören. Diese Änderung wirkt sich auf alle DB-Instances aus, welche die betreffende Optionsgruppe verwenden. Wenn Sie die APEX Optionen aus einer Optionsgruppe entfernen, die an mehrere DB-Instances angehängt ist, kommt es zu einem kurzen Ausfall, während alle DB-Instances neu gestartet werden.

    Weitere Informationen finden Sie unter Entfernen einer Option aus einer Optionsgruppe.

  • Um die APEX Optionen aus einer einzelnen DB-Instance zu entfernen, ändern Sie die DB-Instance und geben Sie eine andere Optionsgruppe an, die die Optionen nicht enthält. APEX Sie können die (leere) Standardoptionsgruppe oder eine andere benutzerdefinierte Optionsgruppe angeben. Wenn Sie die APEX Optionen entfernen, kommt es zu einem kurzen Ausfall, während Ihre DB-Instance automatisch neu gestartet wird.

    Weitere Informationen finden Sie unter Ändern einer Amazon RDS-DB-Instance.

Wenn Sie die APEX Optionen aus einer DB-Instance entfernen, wird das APEX Schema aus Ihrer Datenbank entfernt.