Installer Python et le pilote python-oracledb

Pour vous connecter à Autonomous AI 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 d'autres.

   Note
   
   Oracle vous recommande de rester à jour avec les 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 de 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 populaire.

   Versions du 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

   Vous devriez voir une sortie similaire à la suivante :

   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

   Notes pour l'installation de python-oracledb :

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

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

   • Si vous n'êtes pas autorisé à écrire dans les répertoires de système, incluez l'option --user. Exemple :

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

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

   Voir Installation de python-oracledb pour des options et des conseils supplémentaires.

3. Si vous souhaitez utiliser le pilote python-oracledb en mode Épais, installez le logiciel Oracle Client.

   Par défaut, python-oracledb s'exécute en mode mince qui se connecte directement à Oracle Database. Le mode mince ne nécessite pas de bibliothèques client Oracle. Cependant, certaines fonctionnalités supplémentaires sont disponibles lorsque python-oracledb s'exécute en mode Épais.

   Note
   
   Voir Fonctions Oracle Database prises en charge par python-oracledb pour plus d'informations sur les fonctions prises en charge dans les modes python-oracledb Thin et Thick. Toutes les fonctions affichées dans ce lien ne sont pas disponibles avec Autonomous AI Database.

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

   Lorsque vous installez le logiciel client Oracle, il existe des différences entre les versions minimales requises pour les connexions mTLS et TLS, comme suit :

   • Connexions TLS mutuelles (mTLS) :

     • Si votre base de données se trouve sur un ordinateur distant, téléchargez l'ensemble gratuit "Basic" ou "Basic Light" d'Oracle Instant Client pour 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 version ultérieure) ou 21 (version de base ou version ultérieure).

   • Connexions TLS : Les clients Oracle Call Interface (OCI) prennent en charge l'authentification TLS sans portefeuille si vous utilisez les versions de 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, notamment Full Oracle Database Client 19.14 (ou version ultérieure) et 21.5 (ou version ultérieure).