Creare un'applicazione Python
Per creare un'applicazione Python che accede a un Autonomous AI Database, puoi iniziare configurando il tuo sistema di sviluppo per supportare l'accesso al database che può sfruttare la disponibilità continua e le funzioni ad alte prestazioni di Autonomous AI Database.
Dopo aver configurato il sistema di sviluppo, è possibile codificare le connessioni al database e le istruzioni SQL nell'applicazione per sfruttare queste funzioni.
Suggerimento: per un'alternativa "prova" alla lettura dei seguenti argomenti, è possibile partecipare al laboratorio 4: creare stack di applicazioni Python nel workshop Oracle Autonomous AI Database dedicato per sviluppatori e utenti del database.
Configura il tuo sistema di sviluppo Python
Per configurare il sistema di sviluppo in modo che l'applicazione Python possa sfruttare la disponibilità continua e le funzioni ad alte prestazioni di un Autonomous AI Database, eseguire questi passi.
-
Scaricare e installare Python.
-
Scaricare e installare Oracle Instant Client.
-
Scaricare e installare cx_Oracle.
-
Scaricare le credenziali client per il database e renderle disponibili per Oracle Instant Client.
Operazioni preliminari
Il sistema di sviluppo deve soddisfare determinati criteri per configurarlo correttamente.
-
Deve avere accesso a Internet.
-
Deve disporre dell'accesso di rete all'Autonomous AI Database.
Vedere Configura un sistema di sviluppo per accedere al database per informazioni su come garantire che il sistema di sviluppo soddisfi questi requisiti.
Scarica e installa Python
-
Oracle Linux:
Oracle Linux 7 include Python 2.7, quindi è sufficiente eseguire questo comando::
sudo yum -y install oracle-release-el7 -
Altri sistemi operativi e architetture:
Andare alla pagina Download di python.org e scaricare e installare la versione più recente di Python 2.7 o Python 3.5 (o versione successiva) per il sistema operativo e l'architettura.
Scaricare e installare Oracle Instant Client
Sono necessarie librerie Oracle Instant Client versione 19.6 o successiva.
Scaricare e installare il pacchetto di base di Oracle Instant Client per il sistema operativo e l'architettura del sistema:
-
Oracle Linux:
Eseguire i comandi riportati di seguito per scaricare e installare il pacchetto di base di Oracle Instant Client.
sudo yum -y install oracle-release-el7 sudo yum -y install oracle-instantclient19.3-basicSe si desidera visualizzare un elenco di tutti i pacchetti Instant Client, andare a
http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html. -
Altri sistemi operativi e architetture:
-
Andare alla pagina Download di Oracle Instant Client e selezionare il download per il sistema operativo e l'architettura del sistema.
-
Nella pagina di download accettare il contratto di licenza di Oracle Technology Network, scaricare la versione più recente del pacchetto di base, quindi installarlo seguendo le istruzioni riportate nella parte inferiore della pagina di download.
-
Download e installazione di cx_Oracle
Utilizzare il pacchetto pip di Python per installare cx_Oracle da PyPI (Python Package Index).
-
Oracle Linux:
Eseguire i comandi seguenti per scaricare il pacchetto
pip, quindi utilizzarlo per installarecx_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 -
Altri sistemi operativi e architetture:
Eseguire questo comando:
python -m pip install cx_Oracle --upgrade
Scarica e installa credenziali client per il database
-
Scaricare il file zip contenente le credenziali client per il database in una directory sicura del computer.
Questo file zip è disponibile per il download dalla pagina Dettagli del database nella console di Oracle Cloud. Se si dispone di un account utente Oracle Cloud che consente di accedere a questa pagina, scaricare le credenziali come indicato di seguito. Se non si dispone di un account di questo tipo, è necessario ottenere il file zip dall'amministratore del database, insieme alla password utilizzata per proteggere il file zip.
-
Nel tuo browser Web, accedi a Oracle Cloud e vai alla pagina Dettagli per Autonomous AI Database.
-
Fare clic su Connessione DB.
-
Nella pagina Connessione al database fare clic su Scarica.
-
Nel campo Password della finestra di dialogo Scarica wallet, immettere la password del wallet e confermare la password nel campoConferma password.
La password deve avere la lunghezza di almeno 8 caratteri e deve includere almeno 1 lettera e 1 carattere numerico o 1 carattere speciale
-
Fare clic su Scarica per salvare il file zip delle credenziali client in una directory sicura.
-
-
Dopo aver scaricato il file zip, effettuare le operazioni riportate di seguito.
-
Decomprimere il file zip delle credenziali client.
-
Modificare il file
sqlnet.orafornito nelle credenziali client, sostituendo"?/network/admin"con il percorso completo della directory in cui sono state decompresse le credenziali client; ad esempio, modificare:(DIRECTORY="?/network/admin")to
(DIRECTORY="/users/jdoe/adbcredentials") -
Creare la variabile di ambiente
TNS_ADMIN, impostandone il valore sul percorso completo della directory in cui sono state decompresse le credenziali client.
-
Connessioni al database di codice e istruzioni SQL
Dopo aver configurato il sistema di sviluppo per supportare la connettività dell'applicazione Python a un Autonomous AI Database, seguire queste linee guida per ottenere prestazioni elevate e disponibilità continua delle connessioni dell'applicazione al database:
-
Utilizzare i connection pool.
-
Abilita FAN (Fast Application Notification).
-
Utilizzare il servizio di database predefinito che corrisponde meglio alle operazioni che si eseguiranno. Per informazioni sui servizi di database predefiniti, vedere Nomi dei servizi di database predefiniti per Autonomous AI Database.
Ad esempio:
pool = cx_Oracle.SessionPool("appuser",
SampleEnv.GetMainPassword(),
"tp_tls",
events=True,
threaded=True)
In questo esempio viene creato un pool per le connessioni al servizio di database tp_tls e viene abilitato FAN impostando il parametro events su True.
Contenuto correlato
-
Per informazioni dettagliate su cx_Oracle, andare alla pagina cx_Oracle Documentation.
-
Per esempi di codice che dimostrano un'ampia varietà di funzioni cx_Oracle, andare alla cartella python-cx_Oracle sample.