Creare un'applicazione Node.js

Per creare un'applicazione Node.js che acceda 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 la disponibilità continua e le funzioni ad alte prestazioni.

Suggerimento: per un'alternativa "prova" alla lettura dei seguenti argomenti, è possibile partecipare al workshop 3: Build and Deploy Node.js Application nel workshop Oracle Autonomous AI Database dedicato per sviluppatori e utenti di database.

Configurare il sistema di sviluppo Node.js

Per configurare il tuo sistema di sviluppo in modo che l'applicazione Node.js possa sfruttare la disponibilità continua e le funzioni ad alte prestazioni di un Autonomous AI Database, esegui questi passi.

  1. Scaricare e installare Node.js.

  2. Scaricare e installare Oracle Instant Client.

  3. Scaricare e installare node-oracledb.

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

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

sudo yum install -y oracle-release-el7 oracle-nodejs-release-el7
sudo yum install -y nodejs

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:

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.

Scarica e installa node-oracledb

Scarica e installa l'add-on node-oracledb per Node.js per il sistema operativo e l'architettura del tuo sistema:

sudo yum install -y oracle-release-el7 oracle-nodejs-release-el7
sudo yum install -y node-oracledb-node10

Scarica e installa 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 è 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.

    1. Nel tuo browser Web, accedi a Oracle Cloud e vai alla pagina Dettagli per Autonomous AI Database.

    2. Fare clic su Connessione DB.

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

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

    5. Fare clic su Scarica per salvare il file zip delle credenziali client in una directory sicura.

  2. Dopo aver scaricato il file zip, effettuare le operazioni riportate di seguito.

    1. Decomprimere 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 a un Autonomous AI Database, effettuare le operazioni riportate di seguito per garantire prestazioni ottimali dell'uso del database da parte dell'applicazione.

  1. Aggiungere la dipendenza dall'add-on node-oracledb al file package.json dell'applicazione.

  2. Connessioni di codice per prestazioni elevate e disponibilità continua.

Aggiungere node-oracledb Dependency topackage.json

Modificare l'oggetto dependencies nel file package.json dell'applicazione, aggiungendo il pacchetto e la versione oracledb. (Utilizzare 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 di 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, attenersi alle linee guida riportate di seguito durante le connessioni al database.

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.

Contenuto correlato