Créer une application Ruby

Pour créer une application Ruby qui accède à une base de données Autonomous Database, vous commencez par configurer votre système de développement afin de prendre en charge l'accès à la base de données qui peut tirer parti de la disponibilité continue et des fonctions haute performance d'Autonomous Database.

Après avoir configuré votre système de développement pour la prise en charge de l'accès à la base de données, vous codez les connexions à la base de données et les énoncés SQL dans votre application afin de tirer parti de ces fonctions.

Rubriques connexes

Configurer votre système de développement Ruby

Pour configurer votre système de développement de sorte que votre application Ruby puisse tirer parti des fonctions de disponibilité continue et de haute performance d'une base de données Autonomous Database, vous devez effectuer ces étapes.

  1. Téléchargez et installez Ruby.
  2. Téléchargez et installez Oracle Instant Client.
  3. Téléchargez et installez ruby-oci8.
  4. Téléchargez les données d'identification du client pour la base de données et mettez-les à la disposition d'Oracle Instant Client.

Étapes préliminaires

Pour pouvoir être configuré, votre système de développement doit répondre à certains critères.

Télécharger et installer Ruby

Pour télécharger et installer Ruby, allez à la page Installation de Ruby sur le site ruby-lang.org et suivez les instructions relatives au système d'exploitation et à l'architecture de votre système.

Télécharger et installer Oracle Instant Client

Téléchargez et installez l'ensemble de base Oracle Instant Client pour le système d'exploitation et l'architecture de votre système :

  • Oracle Linux :

    Exécutez ces commandes pour télécharger et installer l'ensemble de base Oracle Instant Client :

    sudo yum -y install oracle-release-el7
sudo yum -y install oracle-instantclient19.3-basic

    (Pour voir la liste de tous les ensembles Instant Client, accédez à http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html.)

  • Autres architectures et OSes :

    1. Accédez à la page de téléchargements d'Oracle Instant Client et sélectionnez le téléchargement correspondant au système d'exploitation et à l'architecture de votre système.

    2. Dans la page de téléchargement, acceptez le contrat de licence d'Oracle Technology Network, téléchargez la dernière version de l'ensemble de base, puis installez-le en suivant les instructions au bas de la page de téléchargement.

Télécharger et installer ruby-oci8

Pour télécharger et installer l'interface ruby-oci8 dans Oracle Database, suivez les instructions de la page Installation pour Oracle Instant Client.

Télécharger et installer les données d'identification du client pour la base de données

  1. Téléchargez le fichier zip contenant les données d'identification du client pour votre base de données dans un répertoire sécurisé sur votre ordinateur.

    Ce fichier zip est disponible pour téléchargement à partir de la page Détails de la base de données dans la console Oracle Cloud. Si vous avez un compte d'utilisateur Oracle Cloud qui vous permet d'accéder à cette page, téléchargez les données d'identification comme suit. Si vous ne disposez pas d'un tel compte, vous devez obtenir le fichier zip auprès de l'administrateur de la base de données, avec le mot de passe utilisé pour protéger le fichier zip.

    1. Dans votre navigateur Web, connectez-vous à Oracle Cloud et naviguez jusqu'à la page Détails pour Autonomous Database.

    2. Cliquez sur Connexion à la base de données.

    3. Dans la page Connexion à la base de données, cliquez sur Télécharger.

    4. Dans la boîte de dialogue Download Wallet (Télécharger le portefeuille), entrez un mot de passe dans le champ Password (Mot de passe) et confirmez le mot de passe dans le champ Confirmer le mot de passe.

      Le mot de passe doit comporter au moins 8 caractères et doit comprendre au moins 1 lettre et 1 caractère numérique ou 1 caractère spécial.

    5. Cliquez sur Télécharger pour enregistrer le fichier zip des données d'identification du client dans un répertoire sécurisé.

  2. Après avoir téléchargé le fichier zip, procédez de la façon suivante :

    1. Décompressez le fichier zip de données d'identification du client.

    2. Modifiez le fichier sqlnet.ora fourni dans les données d'identification du client, en remplaçant "?/network/admin" par le chemin complet du répertoire où vous avez décompressé les données d'identification du client. Par exemple, modifiez : 

      (DIRECTORY="?/network/admin")

      en :

      (DIRECTORY="/users/jdoe/adbcredentials")

    3. Créez la variable d'environnement TNS_ADMIN et réglez sa valeur au chemin complet du répertoire où vous avez décompressé les données d'identification du client.

Coder les connexions aux bases de données et les énoncés SQL

Après avoir configuré votre système de développement pour prendre en charge la connectivité des applications Ruby à une base de données Autonomous Database, suivez ces directives pour atteindre une haute performance et une disponibilité continue des connexions de votre application à la base de données :

Par exemple :

require 'oci8'
OCI8.properties[:events_mode] = true
cpool = OCI8::ConnectionPool.new(1, 5, 2, username, password, 'tp_tls')
conn1 = OCI8.new(username, password, cpool)

Cet exemple active l'avis rapide des applications en réglant la propriété events_mode à true, crée une réserve de connexions au service de base de données tp_tls, puis acquiert l'une de ces connexions.

Ressources supplémentaires

Pour des informations détaillées sur ruby-oci8, allez à la page Ruby-oci8.