Création d'une application Python
Pour créer une application Python qui accède à une instance Autonomous Database, 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 fonctionnalités hautes performances d'Autonomous Database.
Après avoir configuré votre système de développement, codez les connexions de base de données et les instructions SQL dans votre application pour tirer parti de ces fonctionnalités.
Conseil :
Pour commencer par tester les éléments abordés ensuite, vous pouvez suivre l'exercice 4 sur la création de piles d'applications Python dans l'atelier Oracle Autonomous Database Dedicated pour les développeurs et les utilisateurs de base de données.Rubriques connexes
Configuration de votre système de développement Python
Pour configurer votre système de développement afin que votre application Python puisse tirer parti de la disponibilité continue et des fonctionnalités hautes performances d'une instance Autonomous Database, procédez comme suit.
- Téléchargez et installez Python.
- Téléchargez et installez Oracle Instant Client.
- Téléchargez et installez cx_Oracle.
- 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 à l'instance Autonomous Database.
Pour savoir comment vous assurer que votre système de développement répond à cette exigence, reportez-vous à Configuration d'un système de développement pour accéder à la base de données.
Téléchargement et installation de Python
-
Oracle Linux :
Oracle Linux 7 inclut Python 2.7. Par conséquent, exécutez simplement la commande suivante :
sudo yum -y install oracle-release-el7
-
Autres OSes et architectures :
Accédez à la page Téléchargements de python.org, et téléchargez et installez la dernière version de Python 2.7 ou Python 3.5 (ou ultérieure) pour votre système d'exploitation et votre architecture.
Téléchargement et installation d'Oracle Instant Client
Vous avez besoin des bibliothèques Oracle Instant Client version 19.6 ou ultérieure.
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 OSes 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 de 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 figurant au bas de la page de téléchargement.
-
Téléchargement et installation de cx_Oracle
Utilisez le package pip
de Python pour installer cx_Oracle
à partir de PyPI (Python Package Index) :
-
Oracle Linux :
Exécutez les commandes suivantes pour télécharger le package
pip
, puis utilisez-le pour installercx_Oracle
:sudo yum -y install oracle-release-el7 curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py sudo python get-pip.py python -m pip install cx_Oracle --upgrade
-
Autres OSes et architectures :
Exécutez la commande suivante :
python -m pip install cx_Oracle --upgrade
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 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, 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 l'instance Autonomous Database.
-
Cliquez sur Connexion à une base de données.
-
Sur la page Connexion à la base de données, cliquez sur Télécharger.
-
Dans la boîte de dialogue Download Wallet, entrez un mot de passe de portefeuille dans le champ Password et confirmez-le dans le champ Confirm Password.
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.ora
fourni 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 afin de prendre en charge la connectivité d'application Python à une instance Autonomous Database, suivez les directives suivantes 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'informations sur les services de base de données prédéfinis, reportez-vous à Noms de service de base de données prédéfinis pour les bases de données autonomes.
Exemple :
pool = cx_Oracle.SessionPool("appuser",
SampleEnv.GetMainPassword(),
"tp_tls",
events=True,
threaded=True)
Cet exemple crée un pool pour les connexions au service de base de données tp_tls
, et active la fonction FAN en définissant le paramètre events
sur True
.
Ressources supplémentaires
Pour obtenir des informations détaillées sur cx_Oracle, accédez à la page de documentation cx_Oracle.
Pour obtenir des exemples de code illustrant une grande variété de fonctionnalités cx_Oracle, accédez au dossier python-cx_Oracle samples.