APEXcomposants APEXexigences de version Exigences relatives à APEX et ORDS Ajouter des APEX options Déverrouillage du compte utilisateur public Configuration des RESTful services Préparation de l'installation ORDS sur un hôte distinct Configuration de ORDS 21 ou d'une version inférieure Configuration de ORDS 22 ou version ultérieure Configuration de l'APEXécouteur Oracle Mise à niveau de la APEX version Suppression de l'option

Oracle Application Express (APEX)

Amazon RDS prend en charge Oracle Application Express (APEX) grâce à l'utilisation des APEX-DEV options APEX et. Vous pouvez déployer Oracle APEX en tant qu'environnement d'exécution ou en tant qu'environnement de développement complet pour les applications Web. Avec OracleAPEX, vous pouvez créer des applications entièrement dans le navigateur Web. Pour plus d'informations, consultez Oracle Application Express dans la documentation d'Oracle.

Rubriques

APEXcomposants
APEXexigences de version
Oracle APEX et ORDS exigences
Ajouter les DEV options APEX et APEX - à votre instance de base de données
Déverrouillage du compte utilisateur public sur votre instance de base de données
Configuration RESTful des services pour Oracle APEX
Préparation de l'installation ORDS sur un hôte distinct
Installation et configuration des ORDS versions 21 et antérieures
Installation et configuration de la version ORDS 22 et des versions ultérieures
Configuration de l'APEXécouteur Oracle
Mise à niveau de la APEX version
Supprimer l'APEXoption

APEXcomposants

Oracle APEX comprend les principaux composants suivants :

Référentiel qui stocke les métadonnées des APEX applications et des composants. Le référentiel comprend des tables, des index et d'autres objets installés dans votre RDS instance de base de données Amazon.
Un écouteur qui gère les HTTP communications avec les APEX clients Oracle. L'écouteur réside sur un hôte distinct tel qu'une EC2 instance Amazon, un serveur local de votre entreprise ou votre ordinateur de bureau. L'écouteur accepte les connexions entrantes provenant des navigateurs Web, les transmet à l'RDSinstance de base de données Amazon pour traitement, puis renvoie les résultats du référentiel aux navigateurs.

RDSfor Oracle prend en charge les types d'écouteurs suivants :
- Pour les APEX versions 5.0 et ultérieures, utilisez Oracle REST Data Services (ORDS) version 19.1 et supérieure. Nous vous recommandons d'utiliser la dernière version prise en charge d'Oracle APEX etORDS. Cette documentation décrit les anciennes versions à des fins de compatibilité descendante uniquement.
- Pour APEX la version 4.1.1, vous pouvez utiliser Oracle APEX Listener version 1.1.4.
- Vous pouvez utiliser le HTTP serveur Oracle et les mod_plsql écouteurs.
  
  Note
  Amazon RDS ne prend pas en charge le HTTP serveur de XML base de données Oracle avec la SQL passerelle PL/ intégrée en tant qu'écouteur pour. APEX En général, Oracle recommande de ne pas utiliser la SQL passerelle PL/ intégrée pour les applications qui s'exécutent sur Internet.
Pour plus d'informations sur ces types d'écouteur, consultez About Choosing a Web Listener dans la documentation Oracle.

Lorsque vous ajoutez les RDS APEX options Amazon à votre instance de base de données RDS pour Oracle, Amazon RDS installe uniquement le APEX référentiel Oracle. Installez votre écouteur sur un hôte distinct.

APEXexigences de version

L'APEXoption utilise le stockage sur la classe d'instance de base de données de votre instance de base de données. Vous trouverez ci-dessous les versions prises en charge et les exigences de stockage approximatives pour OracleAPEX.

APEXversion	Besoins de stockage	Versions de Oracle Database prises en charge	Remarques
APEXVersion 23.2.v1 d'Oracle	110 MiB	Tous	Cette version inclut le correctif 35895964 : PSE BUNDLE FOR APEX 23.2 (PSESON TOP OF 23.2.0), _ 6. PATCH VERSION
APEXVersion 23.1.v1 d'Oracle	106 Mio	Tous	Cette version inclut le correctif 35283657 : PSE BUNDLE FOR APEX 23.1 (PSESON TOP OF 23.1.0), _ 2. PATCH VERSION
APEXVersion 22.2.v1 d'Oracle	106 Mio	Tous	Cette version inclut le correctif 34628174 : PSE BUNDLE FOR APEX 22.2 (PSESON TOP OF 22.2.0), _ 4. PATCH VERSION
APEXVersion 2.2.1 v1 d'Oracle	124 Mio	Tous	Cette version inclut le correctif PSE BUNDLE FOR APEX 34020981:22.1 (PSESON TOP OF 22.1.0), _ 6. PATCH VERSION
APEXVersion 21.2.v1 d'Oracle	125 Mio	Tous	Cette version inclut le correctif 33420059 : PSE BUNDLE FOR APEX 21.2 (PSESON TOP OF 21.2.0), _ 8. PATCH VERSION
APEXVersion 21.1.v1 d'Oracle	125 Mio	Tous	Cette version inclut le correctif 32598392 : PSE BUNDLE FOR APEX 21.1, PATCH _ 3. VERSION
APEXVersion 20.2.v1 d'Oracle	148 Mio	Tous sauf Oracle Database 21c	Cette version inclut le correctif 32006852 : PSE BUNDLE FOR APEX 20.2, _ 2020.11.12. PATCH VERSION Vous pouvez voir le numéro et la date du correctif en exécutant la requête suivante : `SELECT PATCH_VERSION, PATCH_NUMBER FROM APEX_PATCHES;`
APEXVersion 20.1.v1 d'Oracle	173 Mio	Tous sauf Oracle Database 21c	Cette version inclut le correctif 30990551 : PSE BUNDLE FOR APEX 20.1, _ 2020.07.15. PATCH VERSION
APEXVersion 19.2.v1 d'Oracle	149 Mio	Tous sauf Oracle Database 21c
APEXVersion 19.1.v1 d'Oracle	148 Mio	Tous sauf Oracle Database 21c

Pour les fichiers APEX .zip téléchargeables, consultez les archives des versions APEX antérieures d'Oracle sur le site Web d'Oracle.

Oracle APEX et ORDS exigences

Notez les exigences suivantes pour APEX et ORDS :

Votre système doit utiliser l'environnement d'exécution Java (JRE).
Votre installation client Oracle doit comprendre les éléments suivants :
- SQL*Plus ou SQL Developer pour les tâches d'administration
- Oracle Net Services pour configurer les connexions à votre instance RDS de base de données Oracle

Ajouter les DEV options APEX et APEX - à votre instance de base de données

Pour ajouter les APEX-DEV options APEX et à votre instance de base de données RDS pour Oracle, procédez comme suit :

Créer un groupe d'options ou copier ou modifier un groupe existant.
Ajoutez les options APEX et APEX-DEV au groupe d'options.
Associez le groupe d'options à votre instance de base de données.

Lorsque vous ajoutez les RDS APEX options Amazon, une brève interruption se produit pendant le redémarrage automatique de votre instance de base de données.

Note

APEX_MAIL est disponible lorsque l'option APEX est installée. Le privilège d'exécution du APEX_MAIL package est accordé à, de PUBLIC sorte que vous n'avez pas besoin du compte APEX administratif pour l'utiliser.

Pour ajouter les APEX options à une instance de base de données

Déterminez le groupe d'options que vous voulez utiliser. Vous pouvez créer un groupe d'options ou utiliser un groupe d'options existant. Si vous souhaitez utiliser un groupe d'options existant, passez à l'étape suivante. Sinon, créez un groupe d'options DB personnalisé avec les paramètres suivants :
1. Pour Moteur, sélectionnez l'édition d'Oracle que vous voulez utiliser. Les APEX options sont prises en charge sur toutes les éditions.
2. Pour Version majeure du moteur, choisissez la version de votre instance de base de données.
Pour plus d'informations, consultez Création d'un groupe d'options.
Ajouter les options au groupe d'options. Si vous souhaitez déployer uniquement l'environnement APEX d'exécution Oracle, ajoutez uniquement l'APEXoption. Pour déployer l'environnement de développement complet, ajoutez à la fois les APEX-DEV options APEX et.

Pour Version, choisissez la version d'APEX que vous souhaitez utiliser.

Important
Si vous ajoutez les APEX options à un groupe d'options existant déjà attaché à une ou plusieurs instances de base de données, une brève interruption se produit. Pendant cette interruption, toutes les instances de base de données sont automatiquement redémarrées.

Pour plus d'informations sur l'ajout d'options, consultez Ajout d'une option à un groupe d'options.
Appliquez le groupe d'options à une instance de base de données nouvelle ou existante:
- Pour une nouvelle instance de base de données, vous appliquez le groupe d'options lorsque vous lancez l'instance. Pour plus d'informations, consultez Création d'une instance de base de données Amazon RDS.
- Pour une instance de base de données existante, vous appliquez le groupe d'options en modifiant l'instance et en attachant le nouveau groupe d'options. Lorsque vous ajoutez les APEX options à une instance de base de données existante, une brève interruption se produit pendant le redémarrage automatique de votre instance de base de données. Pour de plus amples informations, veuillez consulter Modification d'une instance de base de données Amazon RDS.

Déverrouillage du compte utilisateur public sur votre instance de base de données

Une fois les RDS APEX options Amazon installées sur votre instance de base de données, veillez à effectuer les opérations suivantes :

Modifiez le mot de passe du compte utilisateur APEX public.
Déverrouillez le compte.

Pour ce faire, utilisez l'utilitaire de ligne de commande Oracle SQL *Plus. Connectez-vous à votre instance de base de données en tant qu'utilisateur principal et exécutez les commandes suivantes. Remplacez new_password par un mot de passe de votre choix.


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

Configuration RESTful des services pour Oracle APEX

Pour configurer les RESTful services dans APEX (ce n'est pas nécessaire pour APEX 4.1.1.V1), utilisez SQL *Plus pour vous connecter à votre instance de base de données en tant qu'utilisateur principal. Ensuite, exécutez la procédure stockée rdsadmin.rdsadmin_run_apex_rest_config. Lorsque vous exécutez la procédure stockée, vous fournissez les mots de passe des utilisateurs suivants :

APEX_LISTENER
APEX_REST_PUBLIC_USER

La procédure stockée exécute le script apex_rest_config.sql, qui crée de nouveaux comptes de base de données pour ces utilisateurs.

Note

Aucune configuration n'est requise pour Oracle APEX version 4.1.1.v1. Pour cette APEX version d'Oracle uniquement, il n'est pas nécessaire d'exécuter la procédure stockée.

La commande suivante exécute la procédure stockée.


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

Préparation de l'installation ORDS sur un hôte distinct

Effectuez ORDS l'installation sur un hôte distinct tel qu'une EC2 instance Amazon, un serveur local de votre entreprise ou votre ordinateur de bureau. Les exemples présentés dans cette section supposent que votre hôte exécute Linux et qu'il porte un nommyapexhost.example.com.

Avant de procéder à l'installationORDS, vous devez créer un utilisateur du système d'exploitation non privilégié, puis télécharger et décompresser le fichier APEX d'installation.

Pour préparer l'ORDSinstallation

Connectez-vous à myapexhost.example.com en tant que root.
Créez un utilisateur du système d'exploitation non privilégié qui sera propriétaire de l'installation de l'écouteur. La commande suivante crée un utilisateur nommé apexuser.
```
useradd -d /home/apexuser apexuser
```
La commande suivante affecte un mot de passe au nouvel utilisateur.
```
passwd apexuser;
```
Connectez-vous à myapexhost.example.com as apexuser et téléchargez le fichier APEX d'installation depuis Oracle /home/apexuser dans votre répertoire :
- http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html
- Archives de versions antérieures d'Oracle Application Express
Décompressez le fichier dans le répertoire /home/apexuser.
```
unzip apex_version.zip
```
Une fois le fichier décompressé, un répertoire apex se trouve dans le répertoire /home/apexuser.
Pendant que vous êtes toujours connecté en myapexhost.example.com tant queapexuser, téléchargez le fichier Oracle REST Data Services depuis Oracle /home/apexuser dans votre répertoire : http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html.

Installation et configuration des ORDS versions 21 et antérieures

Vous êtes maintenant prêt à installer et à configurer Oracle Rest Data Services (ORDS) pour une utilisation avec OracleAPEX. Pour les APEX versions 5.0 et ultérieures, utilisez ORDS les versions 19.1 à 21. Pour savoir comment installer la version ORDS 22 ou une version ultérieure, consultezInstallation et configuration de la version ORDS 22 et des versions ultérieures.

Installez l'écouteur sur un hôte distinct tel qu'une EC2 instance Amazon, un serveur local de votre entreprise ou votre ordinateur de bureau. Pour les exemples de cette section, nous supposons que le nom de votre hôte est myapexhost.example.com, et que votre hôte exécute Linux.

Pour installer et configurer les ORDS versions 21 et antérieures pour une utilisation avec Oracle APEX

Accédez aux services de REST données Oracle et examinez le fichier Readme. Assurez-vous que la version requise de Java est installée.
Créez un nouveau répertoire pour votre ORDS installation.
```
mkdir /home/apexuser/ORDS
cd /home/apexuser/ORDS
```
Téléchargez le fichier ords.version.number.zip depuis Oracle REST Data Services.
Décompressez le fichier dans le répertoire /home/apexuser/ORDS.
Si vous effectuez l'installation ORDS dans une base de données mutualisée, ajoutez la ligne suivante au fichier /home/apexuser/ORDS/params/ords_params.properties :
```
pdb.disable.lockdown=false
```

Accordez à l'utilisateur principal les privilèges requis pour effectuer l'installationORDS.

Une fois l'RDSAPEXoption Amazon installée, accordez à l'utilisateur principal les privilèges requis pour installer le ORDS schéma. Pour ce faire, connectez-vous à la base de données et exécutez les commandes suivantes. Remplacez MASTER_USER par le nom en majuscules de votre utilisateur principal.

Important

Lorsque vous entrez le nom d'utilisateur, utilisez des majuscules, sauf si vous avez créé l'utilisateur avec un identifiant sensible à la casse. Par exemple, si vous exécutez CREATE USER myuser ou CREATE USER MYUSER, le dictionnaire de données stocke MYUSER. Toutefois, si vous utilisez des guillemets doubles dans CREATE USER "MyUser", le dictionnaire de données stocke MyUser. Pour de plus amples informations, veuillez consulter Octroi des privilèges SELECT ou EXECUTE aux objets SYS.


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);

Note

Ces commandes s'appliquent à la ORDS version 19.1 et aux versions ultérieures.

Installez le ORDS schéma à l'aide du fichier ords.war téléchargé.
```
java -jar ords.war install advanced
```
Le programme vous demande les informations suivantes. Les valeurs par défaut sont placées entre crochets. Pour plus d'informations, consultez la section Introduction aux services de REST données Oracle dans la documentation Oracle.
- Entrez l'emplacement de stockage des données de configuration :
  
  Saisissez /home/apexuser/ORDS. Il s'agit de l'emplacement des fichiers ORDS de configuration.
- Spécifiez le type de connexion à la base de données à utiliser. Entrez le numéro pour [1] Basic [2] TNS [3] Custom URL [1] :
  
  Choisissez le type de connexion souhaité.
- Entrez le nom du serveur de base de données [localhost] : DB_instance_endpoint
  
  Choisissez la valeur par défaut ou entrez la valeur correcte.
- Entrez le port de l'écouteur de base de données [1521] : DB_instance_port
  
  Choisissez la valeur par défaut ou entrez la valeur correcte.
- Entrez 1 pour spécifier le nom du service de base de données ou 2 pour spécifier la base de données SID [1] :
  
  Choisissez 2 de spécifier la base de donnéesSID.
- Base de données SID [xe]
  
  Choisissez la valeur par défaut ou entrez la valeur correcte.
- Entrez 1 si vous souhaitez vérifier/installer le schéma Oracle REST Data Services ou 2 pour ignorer cette étape [1] :
  
  Sélectionnez 1. Cette étape crée l'utilisateur proxy Oracle REST Data Services nommé ORDS _ PUBLIC _USER.
- Entrez le mot de passe de base de données pour ORDS PUBLIC _ _ USER :
  
  Entrez le mot de passe, puis confirmez-le.
- Nécessite de se connecter avec des privilèges d'administrateur pour vérifier le schéma Oracle REST Data Services.
  
  Entrez le nom d'utilisateur de l'administrateur : master_user
  
  Entrez le mot de passe de base de données pour master_user: master_user_password
  
  Confirmez le mot de passe : master_user_password
  
  Note
  Spécifiez un mot de passe autre que celui indiqué ici, en tant que bonne pratique de sécurité.
- Entrez le tablespace par défaut pour ORDS _ METADATA []SYSAUX.
  
  Entrez le tablespace temporaire pour ORDS _ METADATA []TEMP.
  
  Entrez le tablespace par défaut pour ORDS _ PUBLIC _ USER []USERS.
  
  Entrez le tablespace temporaire pour ORDS _ PUBLIC _ USER []TEMP.
- Entrez 1 si vous souhaitez utiliser PL/ SQL Gateway ou 2 pour ignorer cette étape. Si vous utilisez Oracle Application Express ou migrez à partir de mod_plsql, vous devez entrer 1 [1].
  
  Choisissez la valeur par défaut.
- Entrez le nom d'utilisateur de la base de données PL/ SQL Gateway [APEX_ PUBLIC _USER]
  
  Choisissez la valeur par défaut.
- Entrez le mot de passe de base de données pour APEX PUBLIC _ _ USER :
  
  Entrez le mot de passe, puis confirmez-le.
- Entrez 1 pour spécifier les mots de passe des utilisateurs de la base de données Application Express RESTful Services (APEXAPEXREST_LISTENER, PUBLIC _ _ _USER) ou 2 pour ignorer cette étape [1] :
  
  Choisissez 2 la APEX version 4.1.1.V1 ; choisissez toutes 1 les autres APEX versions.
- [Non nécessaire pour APEX 4.1.1.v1] Mot de passe de base de données pour _ APEX LISTENER
  
  Entrez le mot de passe (si nécessaire), puis confirmez-le.
- [Non nécessaire pour APEX 4.1.1.v1] Mot de passe de base de données pour APEX _ _ _ REST PUBLIC USER
  
  Entrez le mot de passe (si nécessaire), puis confirmez-le.
- Entrez un nombre pour sélectionner une fonction à activer :
  
  Entrez 1 pour activer toutes les fonctionnalités : SQL Developer WebSQL, REST Enabled et DatabaseAPI.
- Entrez 1 si vous souhaitez démarrer en mode autonome ou 2 pour quitter [1] :
  
  Saisissez 1.
- Entrez l'emplacement des ressources APEX statiques :
  
  Si vous avez décompressé les fichiers APEX d'installation/home/apexuser, entrez. /home/apexuser/apex/images Dans le cas contraire, entrezunzip_path/apex/images, où unzip_path est le répertoire dans lequel vous avez décompressé le fichier.
- Entrez 1 si vous utilisez HTTP ou 2 si vous utilisez HTTPS [1] :
  
  Si vous entrez1, spécifiez le HTTP port. Si vous entrez2, spécifiez le HTTPS port et le nom SSL d'hôte. L'HTTPSoption vous invite à spécifier comment vous allez fournir le certificat :
  - Entrez 1 pour utiliser le certificat auto-signé.
  - Entrez 2 pour fournir votre propre certificat. Si vous entrez2, spécifiez le chemin du SSL certificat et le chemin de la clé privée du SSL certificat.
Définissez un mot de passe pour l'APEXadminutilisateur. Pour ce faire, utilisez SQL *Plus pour vous connecter à votre instance de base de données en tant qu'utilisateur principal, puis exécutez les commandes suivantes.
```
EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
grant APEX_ADMINISTRATOR_ROLE to master;
@/home/apexuser/apex/apxchpwd.sql
```
Remplacez master par votre identifiant principal. Lorsque le script apxchpwd.sql vous y invite, entrez un nouveau mot de passe admin.
Démarrez l'ORDSécouteur. Exécutez le code suivant.
```
java -jar ords.war
```
La première fois que vous démarrezORDS, vous êtes invité à indiquer l'emplacement des ressources APEX statiques. Ce dossier d'images se trouve dans le /apex/images répertoire du répertoire d'installation deAPEX.
Retournez dans la fenêtre d'APEXadministration de votre navigateur et choisissez Administration. Ensuite, choisissez Application Express Internal Administration. Lorsque vous êtes invité à saisir les informations d'identification, entrez les informations suivantes :
- Nom d'utilisateur – admin
- Mot de passe – Mot de passe que vous avez défini en utilisant le script apxchpwd.sql.
ChoisissezLogin, puis définissez un nouveau mot de passe pour l'utilisateur admin.

L'écouteur est maintenant prêt à être utilisé.

Installation et configuration de la version ORDS 22 et des versions ultérieures

Vous êtes maintenant prêt à installer et à configurer Oracle Rest Data Services (ORDS) pour une utilisation avec OracleAPEX. Pour les exemples présentés dans cette section, nous partons du principe que le nom de votre hôte distinct est et que celui-ci exécute Linux. myapexhost.example.com Les instructions pour ORDS 22 sont différentes de celles des versions précédentes.

Pour installer et configurer la ORDS version 22 ou supérieure pour une utilisation avec Oracle APEX

Accédez aux services de REST données Oracle et examinez le fichier Readme correspondant à la ORDS version que vous souhaitez télécharger. Assurez-vous que la version requise de Java est installée.
Créez un nouveau répertoire pour votre ORDS installation.
```
mkdir /home/apexuser/ORDS
cd /home/apexuser/ORDS
```
Téléchargez le fichier ords.version.number.zip ou ords-latest.zip depuis les services de REST données Oracle.
Décompressez le fichier dans le répertoire /home/apexuser/ORDS.

Accordez à l'utilisateur principal les privilèges requis pour effectuer l'installationORDS.

Une fois l'RDSAPEXoption Amazon installée, accordez à l'utilisateur principal les privilèges requis pour installer le ORDS schéma. Vous pouvez le faire en vous connectant à la base de données et en exécutant les commandes suivantes. Remplacez MASTER_USER par le nom en majuscules de votre utilisateur principal.

Important


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);

Note

Les commandes précédentes s'appliquent aux versions ORDS 22 et ultérieures.

Installez le ORDS schéma à l'aide du ords script téléchargé. Spécifiez les répertoires qui contiendront les fichiers de configuration et les fichiers journaux. Oracle Corporation recommande de ne pas placer ces répertoires dans le répertoire contenant le logiciel ORDS du produit.
```
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
```
Pour les instances de base de données exécutant l'architecture de base de données conteneur (CDB), utilisez ORDS 23.2 ou version ultérieure et transmettez l'--pdb-skip-disable-lockdownargument lors de l'installationORDS.
```
/home/apexuser/ORDS/bin/ords \
  --config /home/apexuser/ords_config \
  install --interactive --log-folder /home/apexuser/ords_logs --pdb-skip-disable-lockdown
```
Le programme vous demande les informations suivantes. Les valeurs par défaut sont placées entre crochets. Pour plus d'informations, consultez la section Introduction aux services de REST données Oracle dans la documentation Oracle.
- Choose the type of installation:
  
  Choisissez 2 d'installer des ORDS schémas dans la base de données et de créer un pool de connexions à la base de données dans les fichiers ORDS de configuration locaux.
- Specify the database connection type to use. Enter number for [1] Basic [2] TNS [3] Custom URL:
  
  Choisissez le type de connexion souhaité. Cet exemple part du principe que vous choisissez1.
- Enter the name of the database server [localhost]: DB_instance_endpoint
  
  Choisissez la valeur par défaut ou entrez la valeur correcte.
- Enter the database listener port [1521]: DB_instance_port
  
  Choisissez la valeur par défaut 1521 ou entrez la valeur correcte.
- Enter the database service name [orcl]:
  
  Entrez le nom de base de données utilisé par votre instance de base de données RDS for Oracle.
- Provide database user name with administrator privileges
  
  Entrez le nom d'utilisateur principal pour votre instance de base de données RDS pour Oracle.
- Enter the database password for [username]:
  
  Entrez le mot de passe de l'utilisateur principal RDS pour votre instance de base de données Oracle.
- 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]:
  
  Choisissez 2 de ne pas démarrer ORDS immédiatement en mode autonome.
- Enter a number to select the protocol [1] HTTP
- Enter the HTTP port [8080]:
- Enter the APEX static resources location:
  
  Entrez le chemin d'accès aux fichiers APEX d'installation (/home/apexuser/apex/images).
Définissez un mot de passe pour l'APEXadminutilisateur. Pour ce faire, utilisez SQL *Plus pour vous connecter à votre instance de base de données en tant qu'utilisateur principal, puis exécutez les commandes suivantes.
```
EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
grant APEX_ADMINISTRATOR_ROLE to master;
@/home/apexuser/apex/apxchpwd.sql
```
Remplacez master par votre identifiant principal. Lorsque le script apxchpwd.sql vous y invite, entrez un nouveau mot de passe admin.
Exécutez ORDS en mode autonome à l'aide du ords script associé à la serve commande. Pour les déploiements de production, pensez à utiliser des serveurs d'applications Java EE compatibles tels qu'Apache Tomcat ou Oracle WebLogic Server. Pour plus d'informations, consultez la section Déploiement et surveillance d'Oracle REST Data Services dans la documentation de la base de données Oracle.
```
/home/apexuser/ORDS/bin/ords \
  --config /home/apexuser/ords_config serve \
  --port 8193 \
  --apex-images /home/apexuser/apex/images
```
Si elle ORDS est en cours d'exécution mais que vous ne parvenez pas à accéder à l'APEXinstallation, l'erreur suivante peut s'afficher, en particulier pour CDB les non-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.
```
Pour corriger cette erreur, modifiez la fonction de validation des demandes utilisée ORDS en exécutant le ords script avec la config commande. Par défaut, ORDS utilise la ords_util.authorize_plsql_gateway procédure, qui n'est prise en charge que sur les CDB instances. Pour les CDB non-instances, vous pouvez modifier cette procédure pour le wwv_flow_epg_include_modules.authorize package. Consultez la documentation de la base de données Oracle et le support Oracle pour connaître les meilleures pratiques relatives à la configuration de la fonction de validation des demandes adaptée à votre cas d'utilisation.
Retournez dans la fenêtre d'APEXadministration de votre navigateur et choisissez Administration. Ensuite, choisissez Application Express Internal Administration. Lorsque vous êtes invité à saisir les informations d'identification, entrez les informations suivantes :
- Nom d'utilisateur – admin
- Mot de passe – Mot de passe que vous avez défini en utilisant le script apxchpwd.sql.
ChoisissezLogin, puis définissez un nouveau mot de passe pour l'utilisateur admin.

L'écouteur est maintenant prêt à être utilisé.

Configuration de l'APEXécouteur Oracle

Note

Oracle APEX Listener est obsolète.

Amazon RDS pour Oracle continue de prendre en charge APEX la version 4.1.1 et la version 1.1.4 d'Oracle APEX Listener. Nous vous recommandons d'utiliser les dernières versions prises en charge d'Oracle APEX etORDS.

Installez Oracle APEX Listener sur un hôte distinct tel qu'une EC2 instance Amazon, un serveur local de votre entreprise ou votre ordinateur de bureau. Nous partons du principe que le nom de votre hôte est myapexhost.example.com et qu'il exécute Linux.

Préparation à l'installation d'Oracle APEX Listener

Avant d'installer Oracle APEX Listener, vous devez créer un utilisateur du système d'exploitation non privilégié, puis télécharger et décompresser le APEX fichier d'installation.

Pour préparer l'installation d'Oracle APEX Listener

Connectez-vous à myapexhost.example.com en tant que root.
Créez un utilisateur du système d'exploitation non privilégié qui sera propriétaire de l'installation de l'écouteur. La commande suivante crée un utilisateur nommé apexuser.
```
useradd -d /home/apexuser apexuser
```
La commande suivante affecte un mot de passe au nouvel utilisateur.
```
passwd apexuser;
```
Connectez-vous à myapexhost.example.com as apexuser et téléchargez le fichier APEX d'installation depuis Oracle /home/apexuser dans votre répertoire :
- http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html
- Archives de versions antérieures d'Oracle Application Express
Décompressez le fichier dans le répertoire /home/apexuser.
```
unzip apex_<version>.zip                
```
Une fois le fichier décompressé, un répertoire apex se trouve dans le répertoire /home/apexuser.
Pendant que vous êtes toujours connecté en myapexhost.example.com tant queapexuser, téléchargez le fichier Oracle APEX Listener depuis Oracle /home/apexuser dans votre répertoire.

Installation et configuration d'Oracle APEX Listener

Avant de pouvoir l'utiliserAPEX, vous devez télécharger le fichier apex.war, utiliser Java pour installer Oracle APEX Listener, puis démarrer l'écouteur.

Pour installer et configurer Oracle APEX Listener

Créez un nouveau répertoire basé sur Oracle APEX Listener et ouvrez le fichier Listener.

Exécutez le code suivant :
```
mkdir /home/apexuser/apexlistener
cd /home/apexuser/apexlistener 
unzip ../apex_listener.version.zip
```

Exécutez le code suivant.


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

Entrez les informations suivantes à l'invitation du programme :
- Nom d'utilisateur de l'administrateur du APEX récepteur. Le paramètre par défaut est adminlistener.
- Un mot de passe pour l'administrateur du APEX récepteur.
- Le nom d'utilisateur du APEX Listener Manager. La valeur par défaut est managerlistener.
- Un mot de passe pour l'administrateur du APEX récepteur.
Le programme imprime le URL fichier dont vous avez besoin pour terminer la configuration, comme suit.
```
INFO: Please complete configuration at: http://localhost:8080/apex/listenerConfigure
Database is not yet configured 
```
Laissez Oracle APEX Listener actif pour pouvoir utiliser Oracle Application Express. Lorsque vous avez terminé la procédure de configuration, vous pouvez exécuter l'écouteur à l'arrière-plan.
Depuis votre navigateur Web, accédez au programme URL fourni par le APEX Listener. La fenêtre d'administration d'Oracle Application Express Listener s'affiche. Entrez les informations suivantes :
- Nom d'utilisateur – APEX_PUBLIC_USER
- Mot de passe — le mot de passe pour APEXPUBLIC_ _ USER. Ce mot de passe est celui que vous avez spécifié précédemment lors de la configuration du APEX référentiel. Pour de plus amples informations, veuillez consulter Déverrouillage du compte utilisateur public sur votre instance de base de données.
- Type de connexion – Basic
- Nom d'hôte : point de terminaison de votre RDS instance de base de données Amazon, tel quemydb.f9rbfa893tft.us-east-1.rds.amazonaws.com.
- Port – 1521
- SID— le nom de la base de données sur votre RDS instance de base de données Amazon, tel quemydb.
Choisissez Appliquer. La fenêtre APEX d'administration apparaît.
Définissez un mot de passe pour l'APEXadminutilisateur. Pour ce faire, utilisez SQL *Plus pour vous connecter à votre instance de base de données en tant qu'utilisateur principal, puis exécutez les commandes suivantes.
```
EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
grant APEX_ADMINISTRATOR_ROLE to master;
@/home/apexuser/apex/apxchpwd.sql
```
Remplacez master par votre identifiant principal. Lorsque le script apxchpwd.sql vous y invite, entrez un nouveau mot de passe admin.
Retournez dans la fenêtre d'APEXadministration de votre navigateur et choisissez Administration. Ensuite, choisissez Application Express Internal Administration. Lorsque vous êtes invité à saisir les informations d'identification, entrez les informations suivantes :
- Nom d'utilisateur – admin
- Mot de passe – Mot de passe que vous avez défini en utilisant le script apxchpwd.sql.
ChoisissezLogin, puis définissez un nouveau mot de passe pour l'utilisateur admin.

L'écouteur est maintenant prêt à être utilisé.

Mise à niveau de la APEX version

Important

Sauvegardez votre instance de base de données avant de procéder à la mise à niveauAPEX. Pour plus d’informations, consultez Création d'un instantané de base de données pour une instance de base de données mono-AZ et Test d'une mise à niveau de base de données Oracle.

Pour effectuer APEX une mise à niveau avec votre instance de base de données, procédez comme suit :

Créez un nouveau groupe d'options pour la version mise à niveau de votre instance de base de données.
Ajoutez les versions améliorées de APEX et APEX - DEV au nouveau groupe d'options. Assurez-vous d'ajouter toutes les autres options utilisées par votre instance de base de données. Pour plus d'informations, consultez Considérations relatives au groupe d'options.
Lorsque vous mettez à niveau votre instance de base de données, spécifiez le nouveau groupe d'options pour l'instance de base de données mise à niveau.

Après la mise à niveau de votre version deAPEX, le APEX schéma de la version précédente peut toujours exister dans votre base de données. Si vous n'en avez plus besoin, vous pouvez supprimer l'ancien APEX schéma de votre base de données après la mise à niveau.

Si vous mettez à niveau la APEX version et que les RESTful services n'étaient pas configurés dans la APEX version précédente, nous vous recommandons de configurer les RESTful services. Pour de plus amples informations, veuillez consulter Configuration RESTful des services pour Oracle APEX.

Dans certains cas, lorsque vous prévoyez d'effectuer une mise à niveau de version majeure de votre instance de base de données, vous constaterez peut-être que vous utilisez une APEX version qui n'est pas compatible avec la version de votre base de données cible. Dans ces cas, vous pouvez mettre à niveau votre version de APEX avant de mettre à niveau votre instance de base de données. La mise à niveau APEX initiale peut réduire le temps nécessaire à la mise à niveau de votre instance de base de données.

Note

Après la mise à niveauAPEX, installez et configurez un écouteur à utiliser avec la version mise à niveau. Pour obtenir des instructions, consultez Configuration de l'APEXécouteur Oracle.

Supprimer l'APEXoption

Vous pouvez supprimer les RDS APEX options Amazon d'une instance de base de données. Pour supprimer les APEX options d'une instance de base de données, effectuez l'une des opérations suivantes :

Pour supprimer les APEX options de plusieurs instances de base de données, APEX supprimez-les du groupe d'options auquel elles appartiennent. Ce changement affecte toutes les instances de bases de données qui utilisent le groupe d'options. Lorsque vous supprimez les APEX options d'un groupe d'options attaché à plusieurs instances de base de données, une brève interruption se produit pendant le redémarrage de toutes les instances de base de données.

Pour de plus amples informations, veuillez consulter Suppression d'une option d'un groupe d'options.
Pour supprimer les APEX options d'une seule instance de base de données, modifiez l'instance de base de données et spécifiez un autre groupe d'options qui n'inclut pas les APEX options. Vous pouvez spécifier le groupe d'options (vide) par défaut, ou un groupe d'options personnalisées différent. Lorsque vous supprimez les APEX options, une brève interruption se produit pendant le redémarrage automatique de votre instance de base de données.

Pour de plus amples informations, veuillez consulter Modification d'une instance de base de données Amazon RDS.

Lorsque vous supprimez les APEX options d'une instance de base de données, le APEX schéma est supprimé de votre base de données.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Intégration Amazon S3

Intégration Amazon EFS