Creare un'applicazione Ruby

Per creare un'applicazione Ruby che acceda a un Autonomous Database, è innanzitutto necessario configurare il sistema di sviluppo per supportare l'accesso al database che può sfruttare la disponibilità continua e le funzioni ad alte prestazioni di Autonomous 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 usufruire di queste funzioni.

Argomenti correlati

Configura sistema di sviluppo Ruby

Per configurare il sistema di sviluppo in modo che l'applicazione Ruby possa sfruttare la disponibilità continua e le funzioni ad alte prestazioni di un Autonomous Database, eseguire le operazioni riportate di seguito.

  1. Scarica e installa Ruby.
  2. Scaricare e installare Oracle Instant Client.
  3. Scaricare e installare ruby-oci8.
  4. 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.

Scarica e installa Ruby

Per scaricare e installare Ruby, andare alla pagina Installazione di Ruby all'indirizzo 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 seguenti 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.)

  • Altre architetture e OSes:

    1. Andare alla pagina Download di Oracle Instant Client e selezionare il download per il sistema operativo e l'architettura del sistema.

    2. Nella pagina di download, accettare il contratto di licenza di Oracle Technology Network, scaricare l'ultima versione del pacchetto di base, quindi installarlo seguendo le istruzioni 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.

Scaricare e installare le credenziali client per il database

  1. Scaricare il file zip contenente le credenziali client per il database in una directory sicura del computer.

    Questo file zip può essere scaricato 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.

    1. Nel browser Web, collegarsi a Oracle Cloud e andare alla pagina Dettagli per Autonomous Database.

    2. Fare clic su Connessione DB.

    3. Nella pagina Connessione al database fare clic su Scarica.

    4. Nella finestra di dialogo Scarica wallet, immettere una password per il wallet nel campo Password e confermare la password nel campo Conferma password.

      La password deve avere una lunghezza di almeno 8 caratteri e deve includere almeno 1 lettera e 1 carattere numerico o 1 carattere speciale.

    5. Fare clic su Download per salvare il file ZIP delle credenziali del client in una directory sicura.

  2. Dopo aver scaricato il file zip, attenersi alla procedura riportata di seguito.

    1. Estrarre il file zip delle credenziali client.

    2. Modificare il file sqlnet.ora fornito 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")

    3. 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 in un Autonomous Database, seguire le linee guida riportate di seguito per ottenere prestazioni elevate e disponibilità continua delle connessioni dell'applicazione al database.

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.

Risorse aggiuntive

Per informazioni dettagliate su ruby-oci8, visitare la pagina Ruby-oci8.