Amazon Relational Database Service
Guide de l'utilisateur

Oracle Application Express

Amazon RDS prend en charge Oracle Application Express (APEX) à l'aide des options APEX et APEX-DEV. Oracle APEX peut être déployé en tant qu'environnement d'exécution ou de développement pour les applications web. A l'aide d'Oracle APEX, les développeurs peuvent créer des applications entièrement dans le navigateur web. Pour plus d'informations, consultez Oracle Application Express dans la documentation d'Oracle.

Oracle APEX comporte deux composants principaux :

  • Un référentiel qui stocke les métadonnées pour les composants et les applications APEX. Le référentiel se compose de tables, d'index et d'autres objets installés dans votre instance de base de données Amazon RDS.

  • Un écouteur qui gère les communications HTTP avec les clients Oracle APEX. L'écouteur accepte les connexions entrantes des navigateurs web et les transmet à l'instance de base de données Amazon RDS pour traitement, puis renvoie les résultats du référentiel vers les navigateurs. APEX Listener a été renommé Oracle Rest Data Services (ORDS) dans Oracle 12c.

Lorsque vous ajoutez les options APEX Amazon RDS à votre instance de base de données, Amazon RDS installe uniquement le référentiel Oracle APEX. Installez Oracle APEX Listener sur un hôte distinct, tel qu'une instance Amazon EC2, un serveur sur site de votre entreprise ou votre ordinateur de bureau.

L'option APEX utilise le stockage dans la classe d'instance de base de données pour votre instance de base de données. Voici les versions prises en charge et les besoins approximatifs en stockage pour Oracle APEX.

Version APEX Exigences de stockage Oracle 18c Oracle 12c version 12.2 Oracle 12c version 12.1 Oracle 11g

Oracle APEX version 19.1.v1

148 Mio

Pris en charge

Pris en charge

Pris en charge

Pris en charge

Oracle APEX version 18.2.v1

146 MIO

Pris en charge

Pris en charge

Pris en charge

Pris en charge

Oracle APEX version 18.1.v1

145 Mio

Pris en charge

Pris en charge

Pris en charge

Pris en charge

Oracle APEX version 5.1.4.v1

220 Mio

Pris en charge

Pris en charge

Pris en charge

Pris en charge

Oracle APEX version 5.1.2.v1

150 Mio

Non pris en charge

Non pris en charge

Pris en charge

Pris en charge

Oracle APEX version 5.0.4.v1

140 Mio

Non pris en charge

Non pris en charge

Pris en charge

Pris en charge

Oracle APEX version 4.2.6.v1

160 Mio

Non pris en charge

Non pris en charge

Pris en charge

Pris en charge

Oracle APEX version 4.1.1.v1

130 Mio

Non pris en charge

Non pris en charge

Non pris en charge

Pris en charge

Note

Oracle APEX 5 pour Oracle 11g n'est pas pris en charge lorsque la classe d'instance de base de données utilisée pour l'instance de base de données dispose uniquement d'un vCPU. Pour plus d'informations sur les classes d'instances de base de données, consultez Choix de la classe d'instance de base de données.

Conditions préalables pour Oracle APEX et APEX Listener

Les conditions suivantes sont requises pour utiliser Oracle APEX et APEX Listener :

  • Disposer de SQL*Plus sur votre instance de base de données pour exécuter les tâches d'administration.

  • Avoir les logiciels suivants installés sur l'ordinateur hôte faisant office d'Oracle APEX Listener :

    • Java Runtime Environment (JRE).

    • Oracle Net Services, pour permettre à Oracle APEX Listener de se connecter à votre instance Amazon RDS.

Ajout des options APEX Amazon RDS

La procédure générale pour ajouter des options APEX Amazon RDS à une instance de base de données est la suivante :

  1. Créer un groupe d'options ou copier ou modifier un groupe existant.

  2. Ajouter les options au groupe d'options.

  3. Associer un groupe d'options à une instance de base de données.

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

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

  1. 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 options APEX 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 de plus amples informations, veuillez consulter Création d'un groupe d'options.

  2. Ajouter les options au groupe d'options. Si vous souhaitez déployer uniquement l'environnement d'exécution Oracle APEX, ajoutez seulement l'option APEX. Si vous souhaitez déployer l'environnement de développement complet, ajoutez les options APEX et APEX-DEV.

    • Pour Oracle 12c, ajoutez les options APEX et APEX-DEV.

    • Pour Oracle 11g, ajoutez d'abord l'option prérequise XMLDB, puis ajoutez les options APEX et APEX-DEV.

    Pour Version, choisissez la version d'APEX que vous souhaitez utiliser. Si vous ne choisissez pas de version, la version 4.1.1.v1 est utilisée par défaut pour 11g, et la version 4.2.6.v1 est utilisée par défaut pour 12c.

    Important

    Si vous ajoutez les options APEX à un groupe d'options existant qui est déjà attaché à une ou plusieurs instances de base de données, une brève interruption de service a lieu. 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.

  3. Appliquez le groupe d'options à une instance de base de données nouvelle ou existante:

Déverrouillage du compte utilisateur public

Lorsque les options APEX Amazon RDS sont installées, vous devez modifier le mot de passe du compte utilisateur public APEX, puis déverrouiller le compte. Pour cela, vous pouvez utiliser l'utilitaire de ligne de commande SQL*Plus Oracle. 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 des services RESTful pour Oracle APEX

Pour configurer les services RESTful dans APEX (non 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 version d'Oracle APEX uniquement, vous n'avez pas besoin 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');

Installation et configuration de l'écouteur à utiliser avec Oracle APEX

Vous êtes maintenant prêt à installer et configurer l'écouteur à utiliser avec Oracle APEX. Vous pouvez à cet effet utiliser l'un de ces produits :

  • Pour APEX version 5.0 et ultérieure, utilisez Oracle Rest Data Services (ORDS) version 19.1 et supérieure.

  • Pour APEX version 4.1.1, utilisez Oracle APEX Listener version 1.1.4

  • Oracle HTTP Server et mod_plsql

Pour plus d’informations sur ces types d'écouteur, consultez About Choosing a Web Listener dans la documentation Oracle.

Note

Amazon RDS ne prend pas en charge le serveur HTTP Oracle XML DB avec la passerelle PL/SQL incorporée ; vous ne pouvez pas l'utiliser en tant qu'écouteur pour APEX. En général, Oracle recommande de ne pas utiliser la passerelle PL/SQL incorporée pour les applications qui s'exécutent sur Internet.

Installez l'écouteur sur un hôte distinct : une instance Amazon EC2, un serveur sur site de votre entreprise ou votre ordinateur de bureau.

La procédure suivante explique comment installer et configurer ORDS ou APEX Listener. Nous partons du principe que le nom de votre hôte est myapexhost.example.com et qu'il exécute Linux.

Pour préparer l'installation de l'écouteur

  1. Connectez-vous à myapexhost.example.com en tant que root.

  2. 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;
  3. Connectez-vous à myapexhost.example.com en tant qu'apexuser et téléchargez le fichier d'installation d'APEX à partir d'Oracle dans le répertoire /home/apexuser :

  4. 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.

  5. Alors que vous êtes toujours connecté à myapexhost.example.com en tant qu'apexuser, téléchargez le fichier APEX Listener à partir d'Oracle dans votre répertoire /home/apexuser : http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html

Dans le répertoire de la procédure précédente, où vous vous trouvez encore, installez et exécutez le programme d'écouteur choisi, comme indiqué dans une des procédures suivantes :

Pour installer et configurer ORDS en vue d'une utilisation avec Oracle APEX

  1. Créez un répertoire basé sur ORDS et ouvrez le fichier de l'écouteur.

    Exécutez le code suivant :

    mkdir /home/apexuser/ORDS cd /home/apexuser/ORDS unzip ../ords.<version>.zip
  2. Téléchargez le fichier ords.version.number.zip à partir de la page Oracle REST Data Services.

  3. Décompressez le fichier dans le répertoire /home/apexuser/ORDS.

  4. Accordez à l'utilisateur principal les privilèges nécessaires à l'installation d'ORDS.

    Une fois l'option Amazon RDS APEX installée, octroyez à l'utilisateur principal les privilèges nécessaires à l'installation du schéma ORDS. Pour ce faire, connectez-vous à la base de données et exécutez les commandes suivantes. Remplacez master_user par le nom de votre utilisateur principal.

    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 à ORDS versions 19.1 et 19.2.

  5. Installez le schéma ORDS à l'aide du fichier téléchargé ords.war.

    java -jar ords.war setup

    Le programme vous demande les informations suivantes. Les valeurs par défaut sont placées entre crochets.

    • Emplacement de stockage des données de configuration.

      Entrez /home/apexuser/ORDS.

    • Nom du serveur de base de données [localhost]:DB_instance_endpoint

      Choisissez la valeur par défaut ou entrez la valeur correcte.

    • Port d'écoute de la base de données [1521] : DB_instance_port

      Choisissez la valeur par défaut ou entrez la valeur correcte.

    • Nom du service de base de données ou SID de base de données [1]

      Choisissez 1 pour spécifier le nom du service de base de données ou 2 pour spécifier le SID de base de données.

    • SID de base de données [xe]

      Choisissez la valeur par défaut ou entrez la valeur correcte.

    • Vérifiez ou installez le schéma Oracle REST Data Services ou passez cette étape [1]

      Choisissez 1.

    • Entrez le mot de passe de base de données pour ORDS_PUBLIC_USER, puis confirmez ce mot de passe.

    • Connectez-vous 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 la base de données pour master_user : master_user_password

      Confirmez le mot de passe : master_user_password

    • Entrez l'espace de table par défaut pour ORDS_METADATA [SYSAUX].

      Entrez l'espace de table temporaire pour ORDS_METADATA [TEMP].

      Entrez l'espace de table par défaut pour ORDS_PUBLIC_USER [USERS].

      Entrez l'espace de table temporaire pour ORDS_PUBLIC_USER [TEMP].

    • Entrez 1 si vous voulez utiliser PL/SQL Gateway ou 2 pour passer 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.

    • Nom d'utilisateur de la base de données de la passerelle PL/SQL [APEX_PUBLIC_USER]

      Choisissez la valeur par défaut.

    • Mot de passe de base de données pour APEX_PUBLIC_USER

      Entrez le mot de passe.

    • Indiquez les mots de passe des utilisateurs de base de données des services Application Express RESTful (APEX_LISTENER, APEX_REST_PUBLIC_USER) ou omettez cette étape [1]

      Choisissez 2 pour APEX 4.1.1.V1 ou 1 pour toutes les autres versions d'APEX.

    • [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).

    • [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).

Une fois ORDS installé, configurez-le en suivant les instructions fournies dans Pour configurer l'écouteur.

Pour installer APEX Listener en vue d'une utilisation avec Oracle APEX

  1. Créez un répertoire basé sur Apex Listener et ouvrez le fichier de l'écouteur.

    Exécutez le code suivant :

    language="bash">mkdir /home/apexuser/apexlistener cd /home/apexuser/apexlistener unzip ../apex_listener.<version>.zip
  2. Exécutez le code suivant.

    java -Dapex.home=./apex -Dapex.images=/home/apexuser/apex/images -Dapex.erase -jar ./apex.war
  3. Entrez les informations suivantes à l'invitation du programme :

    • Nom d'utilisateur de l'administrateur APEX Listener. Le paramètre par défaut est adminlistener.

    • Un mot de passe pour l'administrateur APEX Listener.

    • Nom d'utilisateur du gestionnaire APEX Listener. La valeur par défaut est managerlistener.

    • Un mot de passe pour l'administrateur APEX Listener.

    Le programme imprime une URL dont vous avez besoin pour terminer la configuration, comme ci-dessous.

    INFO: Please complete configuration at: http://localhost:8080/apex/listenerConfigure Database is not yet configured
  4. Laissez APEX Listener s'exécuter 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.

  5. Depuis votre navigateur web, accédez à l'URL fournie par le programme APEX Listener. La fenêtre d'administration d'Oracle Application Express Listener s'affiche. Entrez les informations suivantes :

    • Nom d'utilisateurAPEX_PUBLIC_USER

    • Mot de passe – le mot de passe pour APEX_PUBLIC_USER. Il s'agit du mot de passe que vous avez spécifié précédemment, lorsque vous avez configuré le référentiel APEX. Pour plus d'informations, consultez Déverrouillage du compte utilisateur public.

    • Type de connexion – Basic

    • Nom d'hôte – le point de terminaison de votre instance de base de données Amazon RDS, par exemple mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com.

    • Port – 1521

    • SID – le nom de la base de données sur votre instance de base de données Amazon RDS, tel que mydb.

  6. Choisissez Apply. La fenêtre d'administration APEX s'affiche.

Après avoir installé APEX Listener, configurez-le comme indiqué ci-dessous.

Pour configurer l'écouteur

  1. Définissez un mot de passe pour l'utilisateur admin APEX. 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.

  2. Pour ORDS, démarrez APEX Listener. Exécutez le code suivant.

    java -jar ords.war

    La première fois que vous démarrez APEX Listener, vous devez fournir l'emplacement des ressources statiques APEX. Ce dossier d'images se trouve dans le répertoire /apex/images du répertoire d'installation d'APEX.

  3. Revenez à la fenêtre d'administration APEX 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'utilisateuradmin

    • 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 version d'APEX

Important

Faites une sauvegarde de votre instance de base de données avant de mettre à niveau APEX. Pour plus d'informations, consultez Création d'un instantané de base de données et Test d'une mise à niveau.

Pour mettre à niveau APEX et 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 mises à niveau d'APEX et d'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.

Une fois la mise à niveau de votre version d'APEX terminée, il est possible que le schéma APEX de la version précédente existe toujours dans votre base de données. Si vous n'en avez plus besoin, vous pouvez supprimer l'ancien schéma APEX de votre base de données après avoir procédé à la mise à niveau.

Si vous effectuez une mise à niveau de la version d'APEX et que les services RESTful n'ont pas été configurés dans la version antérieure d'APEX, nous vous recommandons de les configurer. Pour plus d'informations, consultez Configuration des services RESTful pour Oracle APEX.

Dans certains cas, lorsque vous planifiez d’effectuer une mise à niveau de version majeure de votre instance de base de données, vous pouvez vous rendre compte que vous utilisez une version d’APEX qui n’est pas compatible avec votre version de base de données cible. Dans ce cas, vous pouvez mettre à niveau votre version d’APEX avant de mettre à niveau votre instance de base de données. La mise à niveau préalable d'APEX permet de réduire le temps nécessaire à la mise à niveau de votre instance de base de données.

Note

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

Suppression de l'option APEX

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

  • Pour supprimer les options APEX de plusieurs instances de base de données, supprimez l'option APEX 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 options APEX d'un groupe d'options qui est attaché à plusieurs instances de base de données, une brève interruption de service a lieu pendant le redémarrage de toutes les instances de base de données.

    Pour plus d'informations, consultez Suppression d'une option d'un groupe d'options.

  • Pour supprimer les options APEX 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 options APEX. 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 options APEX, une brève interruption de service se produit pendant le redémarrage automatique de votre instance de base de données.

    Pour plus d'informations, consultez Modification d'une instance de base de données exécutant le moteur de base de données Oracle.

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