Installation de Python et du pilote python-oracledb

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 de votre système d'exploitation et de votre matériel côté client. Par exemple, Windows, Linux, macOS et autres.

    Remarque

    Oracle vous recommande de vous tenir au courant des versions des pilotes 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.

    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 se présenter comme 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 sur 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
    • Si 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 binaire n'est disponible pour votre plate-forme, l'exécution de pip téléchargera le package source à la place. La source est compilée et le fichier binaire résultant est installé.

    Reportez-vous à Installation de python-oracledb pour obtenir des options et des conseils supplémentaires.

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

    Par défaut, python-oracledb s'exécute en mode léger qui se connecte directement à Oracle Database. Le mode léger 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.

    Remarque

    Reportez-vous à Fonctionnalités Oracle Database prises en charge par python-oracledb pour plus d'informations sur les fonctionnalités prises en charge en mode python-oracledb léger et épais. Toutes les fonctionnalités présentées dans ce lien ne sont pas disponibles avec Autonomous Database.

    Python-oracledb utilise le mode Épais lorsque vous utilisez les bibliothèques client Oracle Instant 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 diffèrent comme suit :

    • Connexions TLS mutuelles (mTLS) :

      • Si votre base de données se trouve sur un ordinateur distant, téléchargez le package gratuit "Basic" ou "Basic Light" d'Oracle Instant Client pour l'architecture de votre 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 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 Full Oracle Database 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).