Creare un'applicazione Node.js

Per creare un'applicazione Node.js 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, è possibile codificare le connessioni al database e le istruzioni SQL nell'applicazione per sfruttare le funzioni di disponibilità continua e ad alte prestazioni.

Suggerimento

Per un'alternativa "prova" alla lettura dei seguenti argomenti, è possibile consultare la Lab 3: Build and Deploy Node.js Application nel Workshop su Oracle Autonomous Database Dedicated for Developers and Database Users.

Argomenti correlati

Le basi per costruire un'applicazione

Configura sistema di sviluppo Node.js

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

Scaricare e installare Node.js.
Scaricare e installare Oracle Instant Client.
Scaricare e installare node-oracledb.
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 Database.

Per informazioni su come garantire che il sistema di sviluppo soddisfi questo requisito, vedere Configura un sistema di sviluppo per l'accesso al database.

Scaricare e installare Node.js

Scaricare e installare Node.js per il sistema operativo e l'architettura del sistema:

Oracle Linux:

Eseguire i seguenti comandi per scaricare e installare la versione più recente di Node.js:
```
sudo yum install -y oracle-release-el7 oracle-nodejs-release-el7
sudo yum install -y nodejs 
```
Altre architetture e OSes:

Andare alla pagina Node.js Download, selezionare la versione LTS (Long Term Support) più recente per il sistema operativo e l'architettura, quindi installarla.

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 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.

Scarica e installa node-oracledb

Scarica e installa il componente aggiuntivo node-oracledb per Node.js per il sistema operativo e l'architettura:

Oracle Linux:

Eseguire i comandi riportati di seguito per scaricare e installare la versione più recente di node-oracledb.
```
sudo yum install -y oracle-release-el7 oracle-nodejs-release-el7
sudo yum install -y node-oracledb-node10
```
Altre architetture e OSes:

Passare alla pagina Installazione di node-oracledb, scegliere le istruzioni "Il mio database si trova su un altro computer" per il sistema operativo e l'architettura, quindi seguire le istruzioni Installa il componente aggiuntivo.

Scaricare e installare le 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 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.
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 Node.js in un Autonomous Database, attenersi alla procedura riportata di seguito per garantire prestazioni ottimali dell'uso del database da parte dell'applicazione.

Aggiungi la dipendenza dal componente aggiuntivo node-oracledb al file package.json della tua applicazione.
Connessioni di codice per prestazioni elevate e disponibilità continua.

Aggiungere la dipendenza node-oracledb a package.json

Modificare l'oggetto dependencies nel file package.json per l'applicazione, aggiungendo il pacchetto e la versione oracledb. (Usare il comando npm init per generare package.json se non esiste). Ad esempio:

. . .
"dependencies": {
  . . .,
  "oracledb": "^4.0",
  . . .
},
. . .

Per informazioni dettagliate sull'oggetto dependencies, vedere la pagina npm-package.json. Per visualizzare la versione oracledb installata, è possibile utilizzare il comando npm list, ad esempio:

npm list -g --depth=0

Connessioni al codice per prestazioni elevate e disponibilità continua

Per ottenere prestazioni elevate e disponibilità continua, seguire le linee guida riportate di seguito durante le connessioni al database.

Usa connection pool.
Abilitare 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 predefiniti dei servizi di database per i database autonomi.

Ad esempio:

pool = await oracledb.createPool({
  events: true,
  user: "appuser",
  password: process.env.MY_PASSWORD_ENV_VAR,
  connectString: "tp_tls"
});

In questo esempio viene creato un pool per le connessioni al servizio di database tp_tls e viene abilitato FAN impostando la proprietà events su true.

Risorse aggiuntive

Per informazioni dettagliate su node-oracledb, andare alla pagina Documentazione Node-oracledb, che include sia un riferimento API che un manuale utente.

Per esempi di codice che dimostrano una vasta gamma di funzioni node-oracledb, andare alla cartella node-oracledb Examples.

Titolo e informazioni sul copyright

Oracle e/o relative consociate.