Création d'une application Ruby
Pour créer une application Ruby qui accède à une base de données d'IA autonome, vous devez d'abord configurer votre système de développement pour prendre en charge l'accès à la base de données qui peut tirer parti de la disponibilité continue et des fonctionnalités hautes performances d'Autonomous AI Database.
Après avoir configuré votre système de développement de sorte qu'il prenne en charge l'accès à la base de données, codez les connexions de base de données et les instructions SQL dans votre application pour tirer parti de ces fonctionnalités.
Configuration de 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 fonctionnalités de disponibilité continue et de hautes performances d'une base de données d'IA autonome, procédez comme suit.
-
Téléchargez et installez Ruby.
-
Téléchargez et installez Oracle Instant Client.
-
Téléchargez et installez ruby-oci8.
-
Téléchargez les informations d'identification client de la base de données et rendez-les disponibles pour Oracle Instant Client.
Avant de commencer
Votre système de développement doit répondre à certains critères pour sa configuration.
-
Il doit disposer d'un accès à Internet.
-
Il doit disposer d'un accès réseau à la base de données Autonomous AI.
Reportez-vous à Configuration d'un système de développement pour accéder à la base de données.
Téléchargement et installation de Ruby
Pour télécharger et installer Ruby, accédez à la page d'installation de Ruby sur ruby-lang.org et suivez les instructions relatives au système d'exploitation et à l'architecture de votre système.
Téléchargement et installation d'Oracle Instant Client
Téléchargez et installez le package de base Oracle Instant Client pour le système d'exploitation et l'architecture de votre système :
-
Oracle Linux:
Exécutez les commandes suivantes pour télécharger et installer le package Oracle Instant Client Basic :
sudo yum -y install oracle-release-el7
sudo yum -y install oracle-instantclient19.3-basic
(Pour afficher la liste de tous les packages Instant Client, accédez à la page http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html.)
-
Autres systèmes d'exploitation et architectures :
-
Accédez à la page Téléchargements Oracle Instant Client, et sélectionnez le téléchargement pour le système d'exploitation et l'architecture de votre système.
-
Sur la page du téléchargement, acceptez le Contrat de licence Oracle Technology Network, téléchargez la dernière version du package Basic, puis installez-la en suivant les instructions qui figurent au bas de la page du téléchargement.
-
Téléchargement et installation de ruby-oci8
Pour télécharger et installer l'interface ruby-oci8 sur Oracle Database, suivez les instructions de la page Installation pour Oracle Instant Client.
Téléchargement et installation des informations d'identification client pour la base de données
-
Téléchargez le fichier ZIP contenant les informations d'identification client pour la base de données vers un répertoire sécurisé de l'ordinateur.
Ce fichier ZIP peut être téléchargé à partir de la page Détails de la base de données dans la console Oracle Cloud. Si vous disposez d'un compte utilisateur Oracle Cloud vous permettant d'accéder à cette page, téléchargez les informations d'identification tel que décrit ci-dessous. Si vous ne disposez pas d'un tel compte, vous devez obtenir le fichier ZIP auprès de l'administrateur de la base des données, ainsi que le mot de passe qui protège le fichier ZIP.
-
Dans votre navigateur Web, connectez-vous à Oracle Cloud et accédez à la page Détails de la base de données Autonomous AI.
-
Cliquez sur Connexion de base de données.
-
Sur la page Connexion à la base de donnée, cliquez sur Télécharger.
-
Dans la boîte Télécharger un portefeuille, entrez un mot de passe de portefeuille dans le champ de mot de passe et confirmez le mot de passe dans le champ de confirmer le mot de passe.
Le mot de passe doit comporter au minimum 8 caractères, dont au moins 1 lettre et 1 caractère numérique ou caractère spécial.
-
Cliquez sur Télécharger pour enregistrer le fichier ZIP d'informations d'identification client dans un répertoire sécurisé.
-
-
Après avoir téléchargé le fichier ZIP, procédez comme suit :
-
Décompressez le fichier ZIP d'informations d'identification client.
-
Modifiez le fichier
sqlnet.orafourni dans les informations d'identification client en remplaçant"?/network/admin"par le chemin complet du répertoire dans lequel vous avez décompressé les informations d'identification client. Par exemple, remplacez :(DIRECTORY="?/network/admin")par :
(DIRECTORY="/users/jdoe/adbcredentials") -
Créez la variable d'environnement
TNS_ADMIN, en définissant sa valeur sur le chemin complet du répertoire dans lequel vous avez décompressé les informations d'identification client.
-
Codage des connexions de base de données et des instructions 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 d'IA autonome, suivez les instructions ci-dessous pour obtenir des performances élevées et une disponibilité continue des connexions de votre application à la base de données :
-
Utilisez des pools de connexions.
-
Activez la fonction FAN (Fast Application Notification).
-
Utilisez le service de base de données prédéfini qui correspond le mieux aux opérations que vous allez effectuer. Pour plus d'autres informations sur les services de base de donnée prédéfinis, reportez-vous à Noms de service de base de donnée prédéfinis pour les bases de donnée autonomes AI.
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 la fonction FAN en définissant la propriété events_mode sur true, crée un pool pour les connexions au service de base de données tp_tls et acquiert une connexion à partir du pool.
Contenu connexe
-
Pour obtenir des informations détaillées sur ruby-oci8, accédez à la page Ruby-oci8.