Pour vous connecter à Autonomous Database à partir de votre application Python, installez Python et le pilote python-oracledb.

1. Installez Python 3, s'il n'est pas déjà disponible.

   La version de Python que vous utilisez dépend du système d'exploitation et du matériel côté client. Par exemple, Windows, Linux, macOS et autres.

   Remarque
   
   Oracle vous recommande de vous tenir au courant des versions de pilote Python et python-oracledb.
2. Installez le pilote python-oracledb à partir de PyPI.

   Le pilote python-oracledb est un module d'extension du langage de programmation Python permettant aux programmes Python de se connecter à Oracle Database. Le pilote python-oracledb est la nouvelle version majeure renommée du pilote cx_Oracle.

   Versions de pilote python-oracledb prises en charge : python-oracledb 1.0 (ou version ultérieure)

   Exécutez la commande suivante pour mettre à niveau python :

   python -m pip install oracledb --upgrade

   La sortie doit ressembler à ce qui suit :

   Collecting oracledb
     Downloading oracledb-1.0.3-cp310-cp310-win_amd64.whl (1.0 MB)
        ---------------------------------------- 1.0/1.0 MB 1.8 MB/s eta 0:00:00
   Collecting cryptography>=3.4
     Downloading cryptography-37.0.4-cp36-abi3-win_amd64.whl (2.4 MB)
        ---------------------------------------- 2.4/2.4 MB 3.5 MB/s eta 0:00:00
   Collecting cffi>=1.12
     Downloading cffi-1.15.1-cp310-cp310-win_amd64.whl (179 kB)
        ---------------------------------------- 179.1/179.1 kB 5.4 MB/s eta 0:00:00
   Collecting pycparser
     Downloading pycparser-2.21-py2.py3-none-any.whl (118 kB)
        ---------------------------------------- 118.7/118.7 kB 7.2 MB/s eta 0:00:00
   Installing collected packages: pycparser, cffi, cryptography, oracledb
   Successfully installed cffi-1.15.1 cryptography-37.0.4 oracledb-1.0.3 pycparser-2.21

   Remarques relatives à l'installation de python-oracledb :

   • Si vous êtes derrière un proxy, utilisez l'option --proxy pour ajouter un serveur proxy à la commande. Par exemple :

     python -m pip install oracledb --upgrade --proxy=http://proxy.example.com:80

   • Dans le cas où vous n'êtes pas autorisé à écrire dans les répertoires système, incluez l'option --user. Par exemple :

     python -m pip install oracledb --upgrade --user

   • Si aucun package n'est disponible pour votre plate-forme, l'exécution de pip télécharge le package source à la place. La source est compilée et le fichier binaire résultant est installé.

   Pour des options et des conseils supplémentaires, reportez-vous à Installation de python-oracledb.

3. Si vous voulez utiliser le pilote python-oracledb en mode Lourd, installez le logiciel client Oracle.

   Par défaut, python-oracledb s'exécute en mode Léger, qui se connecte directement à Oracle Database. Le mode Léger ne requiert pas de bibliothèque client Oracle. Toutefois, certaines fonctionnalités supplémentaires sont disponibles lorsque python-oracledb est exécuté en mode Lourd.

   Remarque
   
   Reportez-vous à Caractéristiques Oracle Database prises en charge par python-oracledb pour plus d'informations sur les fonctionnalités prises en charge dans les modes Léger et Lourd de python-oracledb. Toutes les fonctionnalités présentées dans ce lien ne sont pas disponibles avec Autonomous Database.

   Python-oracledb utilise le mode Epais lorsque vous utilisez les bibliothèques Oracle Instant client ou Oracle Database Client et que vous appelez oracledb.init_oracle_client() dans votre code Python.

   Lorsque vous installez le logiciel client Oracle, les versions minimales requises pour les connexions mTLS et TLS présentent les différences suivantes :

   • Connexions TLS mutuelles (mTLS) :

     • Si la base de données se trouve sur un ordinateur distant, téléchargez le package gratuit "Basic" ou "Basic Light" d'Oracle Instant Client correspondant à votre architecture de système d'exploitation. Utilisez une version prise en charge : Oracle Instant Client : 18.19 (ou version ultérieure), 19.2 (ou version ultérieure) ou 21 (version de base ou version ultérieure).

     • Vous pouvez également utiliser les bibliothèques client Oracle Database complètes lorsqu'elles sont disponibles sur votre système (y compris le client Oracle Database complet : client Oracle Database : 18.19 (ou version ultérieure), 19.2 (ou ultérieure) ou 21 (version de base ou ultérieure).

   • Connexions TLS : les clients Oracle Call Interface (OCI) prennent en charge l'authentification TLS sans portefeuille si vous utilisez les versions client suivantes :

     • Oracle Instant Client/Oracle Database Client 19.14 (ou version ultérieure), 21.5 (ou version ultérieure) ou 23.1 (ou version ultérieure)

     • Vous pouvez également utiliser les bibliothèques client Oracle Database complètes lorsqu'elles sont disponibles sur votre système, y compris le client Oracle Database complet 19.14 (ou supérieur) et 21.5 (ou supérieur).