Per connettersi ad Autonomous Database dall'applicazione Python, installare Python e il driver python-oracledb.

1. Installare Python 3, se non è già disponibile.

   La versione di Python utilizzata dipende dal sistema operativo e dall'hardware lato client. Ad esempio, Windows, Linux, macOS e altri.

   Nota
   
   Oracle consiglia di rimanere aggiornato sulle release dei driver Python e python-oracledb.
2. Installare il driver python-oracledb da PyPI.

   Il driver python-oracledb è un modulo di estensione del linguaggio di programmazione Python che consente ai programmi Python di connettersi a Oracle Database. Il driver python-oracledb è la nuova release principale rinominata del popolare driver cx_Oracle.

   Versioni del driver python-oracledb supportate: python-oracledb 1.0 (o versioni successive)

   Eseguire il comando seguente per aggiornare python:

   python -m pip install oracledb --upgrade

   Dovrebbe essere visualizzato un output simile al seguente:

   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

   Note per l'installazione di python-oracledb:

   • Se si è dietro un proxy, utilizzare l'opzione --proxy per aggiungere un server proxy al comando. Ad esempio:

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

   • Se non si dispone dell'autorizzazione per scrivere nelle directory di sistema, includere l'opzione --user. Ad esempio:

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

   • Se un pacchetto binario non è disponibile per la piattaforma in uso, l'esecuzione di pip comporta il download del pacchetto di origine. L'origine viene compilata e il file binario risultante viene installato.

   Per ulteriori opzioni e suggerimenti, vedere Installazione di python-oracledb.

3. Se si desidera utilizzare il driver python-oracledb in modalità Spessa, installare il software Oracle Client.

   Per impostazione predefinita, python-oracledb viene eseguito in modalità Thin che si connette direttamente a Oracle Database. La modalità Thin non richiede le librerie client Oracle. Tuttavia, alcune funzionalità aggiuntive sono disponibili quando python-oracledb viene eseguito in modalità Spessa.

   Nota
   
   Per informazioni sulle funzioni supportate nelle modalità Thin e Thick di python-oracledb, vedere Oracle Database Features Supported by python-oracledb. Non tutte le funzioni mostrate in questo collegamento sono disponibili con Autonomous Database.

   Python-oracledb utilizza la modalità Spessa quando si utilizzano le librerie client Oracle Instant o le librerie client Oracle Database e si chiama oracledb.init_oracle_client() nel codice Python.

   Quando si installa Oracle Client Software, le versioni minime richieste per le connessioni mTLS e TLS sono diverse, come descritto di seguito.

   • Connessioni mTLS (Mutual TLS):

     • Se il database si trova su un computer remoto, scaricare il pacchetto gratuito Oracle Instant Client "Basic" o "Basic Light" per l'architettura del sistema operativo. Utilizzare una versione supportata: Oracle Instant Client: 18.19 (o versioni successive), 19.2 (o versioni successive) o 21 (release di base o successive).

     • In alternativa, è possibile utilizzare le librerie client Oracle Database complete quando sono disponibili nel sistema (incluso Full Oracle Database Client: Oracle Database Client: 18.19 (o successivo), 19.2 (o successivo) o 21 (release base o successiva).

   • Connessioni TLS: i client Oracle Call Interface (OCI) supportano l'autenticazione TLS senza un wallet se si utilizzano le seguenti versioni client:

     • Oracle Instant Client/Oracle Database Client 19.14 (o versioni successive) e 21.5 (o versioni successive): solo su Linux x64 e Windows

     • In alternativa, è possibile utilizzare le librerie client Oracle Database complete quando sono disponibili nel sistema, inclusi Full Oracle Database Client 19.14 (o versioni successive) e 21.5 (o versioni successive).