Creare un'applicazione Ruby
Per creare un'applicazione Ruby 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 per supportare l'accesso al database, è possibile codificare le connessioni al database e le istruzioni SQL nell'applicazione per sfruttare queste funzioni.
Configurare il sistema di sviluppo Ruby
Per configurare il tuo sistema di sviluppo in modo che l'applicazione Ruby possa sfruttare la disponibilità continua e le funzioni ad alte prestazioni di un Autonomous AI Database, esegui questi passi.
-
Scaricare e installare Ruby.
-
Scaricare e installare Oracle Instant Client.
-
Scaricare e installare ruby-oci8.
-
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 Configurare un sistema di sviluppo per accedere al database
Scarica e installa Ruby
Per scaricare e installare Ruby, andare alla pagina Installazione di Ruby su ruby-lang.org e seguire le istruzioni per il sistema operativo e l'architettura del sistema.
Scaricare e installare Oracle Instant Client
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-basic
Se 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.
-
Scaricare e installare ruby-oci8
Per scaricare e installare l'interfaccia ruby-oci8 in Oracle Database, seguire le istruzioni nella pagina Installa per Oracle Instant Client.
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, quindi 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")a:
(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 Ruby a un Autonomous AI Database, attenersi alle linee guida riportate di seguito 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 i database AI autonomi.
Ad esempio:
require 'oci8'
OCI8.properties[:events_mode] = true
cpool = OCI8::ConnectionPool.new(1, 5, 2, username, password, 'tp_tls')
conn1 = OCI8.new(username, password, cpool)
Questo esempio abilita FAN impostando la proprietà events_mode su true, crea un pool per le connessioni al servizio di database tp_tls e acquisisce una connessione dal pool.
Contenuto correlato
-
Per informazioni dettagliate su ruby-oci8, andare alla pagina Ruby-oci8.