Node.js-Anwendung erstellen

Um eine Node.js-Anwendung zu erstellen, die auf eine autonome KI-Datenbank zugreift, müssen Sie zunächst Ihr Entwicklungssystem so konfigurieren, dass es den Datenbankzugriff unterstützt, der die Funktionen für kontinuierliche Verfügbarkeit und hohe Performance der autonomen KI-Datenbank nutzen kann.

Nachdem Sie das Entwicklungssystem konfiguriert haben, codieren Sie Datenbankverbindungen und SQL-Anweisungen in der Anwendung, um die Features für kontinuierliche Verfügbarkeit und hohe Performance zu nutzen.

Tipp: Als Alternative zum Lesen der folgenden Themen können Sie die Vorgänge unter Lab 3: Build and Deploy Node.js Application in Oracle Autonomous AI Database Dedicated for Developers and Database Users Workshop ausführen.

Node.js-Entwicklungssystem konfigurieren

Um Ihr Entwicklungssystem so zu konfigurieren, dass Ihre Node.js-Anwendung die Funktionen für kontinuierliche Verfügbarkeit und hohe Performance einer autonomen KI-Datenbank nutzen kann, führen Sie diese Schritte aus.

  1. Laden Sie Node.js herunter, und installieren Sie es.

  2. Laden Sie Oracle Instant Client herunter, und installieren Sie es.

  3. Laden Sie node-oracledb herunter, und installieren Sie es.

  4. Laden Sie die Clientzugangsdaten für die Datenbank herunter, und machen Sie sie für Oracle Instant Client verfügbar.

Bevor Sie beginnen

Das Entwicklungssystem muss bestimmte Kriterien erfüllen, damit Sie es erfolgreich konfigurieren können.

Node.js herunterladen und installieren

Laden Sie Node.js für das Betriebssystem und die Architektur Ihres Systems herunter, und installieren Sie es:

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

Oracle Instant Client herunterladen und installieren

Sie benötigen Oracle Instant Client-Librarys ab Version 19.6.

Laden Sie das Basispackage von Oracle Instant Client für das Betriebssystem und die Architektur Ihres Systems herunter, und installieren Sie es:

sudo yum -y install oracle-release-el7
sudo yum -y install oracle-instantclient19.3-basic

(Wenn Sie eine Liste aller Instant Client-Packages anzeigen möchten, navigieren Sie zu http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html.)

node-oracledb herunterladen und installieren

Laden Sie das Add-on "node-oracledb" für Node.js für das Betriebssystem und die Architektur Ihres Systems herunter, und installieren Sie es:

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

Clientzugangsdaten für die Datenbank herunterladen und installieren

  1. Laden Sie die ZIP-Datei mit Clientzugangsdaten für die Datenbank in ein sicheres Verzeichnis auf Ihrem Rechner herunter.

    Diese ZIP-Datei kann über die Detailseite der Datenbank in der Oracle Cloud-Konsole heruntergeladen werden. Wenn Sie einen Oracle Cloud-Benutzeraccount haben, der Ihnen den Zugriff auf diese Seite ermöglicht, können Sie die Zugangsdaten wie folgt herunterladen. Wenn Sie keinen solchen Account haben, müssen sie die ZIP-Datei vom Administrator der Datenbank zusammen mit dem Kennwort abrufen, mit dem die ZIP-Datei geschützt wurde.

    1. Melden Sie sich in Ihrem Webbrowser bei Oracle Cloud an, und navigieren Sie zur Seite "Details" für die autonome KI-Datenbank.

    2. Klicken Sie auf DB-Verbindung.

    3. Klicken Sie auf der Seite Datenbankverbindung auf Herunterladen.

    4. Geben Sie im Dialogfeld Wallet herunterladen ein Wallet-Kennwort in das Feld Kennwort ein, und bestätigen Sie das Kennwort im Feld Kennwort bestätigen.

      Das Kennwort muss mindestens 8 Zeichen lang sein und mindestens einen Buchstaben und entweder ein numerisches Zeichen oder ein Sonderzeichen enthalten.

    5. Klicken Sie auf Herunterladen, um die ZIP-Datei mit den Clientzugangsdaten in einem sicheren Verzeichnis zu speichern.

  2. Führen Sie nach dem Herunterladen der ZIP-Datei die folgenden Schritte aus:

    1. Dekomprimieren Sie die ZIP-Datei mit den Clientzugangsdaten.

    2. Bearbeiten Sie die Datei sqlnet.ora in den Clientzugangsdaten, und ersetzen Sie "?/network/admin" durch den vollständigen Pfad des Verzeichnisses, in dem Sie die Clientzugangsdaten dekomprimiert haben. Ändern Sie z.B.:

       (DIRECTORY="?/network/admin")

      zu:

       (DIRECTORY="/users/jdoe/adbcredentials")

    3. Erstellen Sie die Umgebungsvariable TNS_ADMIN, und setzen Sie ihren Wert auf den vollständigen Pfad des Verzeichnisses, in dem Sie die Clientzugangsdaten dekomprimiert haben.

Datenbankverbindungen und SQL-Anweisungen codieren

Nachdem Sie Ihr Entwicklungssystem so konfiguriert haben, dass es die Konnektivität der Node.js-Anwendung mit einer autonomen KI-Datenbank unterstützt, führen Sie die folgenden Schritte aus, um die optimale Performance der Datenbankverwendung Ihrer Anwendung sicherzustellen:

  1. Fügen Sie die Abhängigkeit vom Add-on "node-oracledb" zur Datei package.json der Anwendung hinzu.

  2. Codieren Sie Verbindungen für hohe Performance und kontinuierliche Verfügbarkeit.

node-oracledb Dependency topackage.json hinzufügen

Bearbeiten Sie das Objekt dependencies in der Datei package.json für die Anwendung, und fügen Sie das oracledb-Package und die Version hinzu. (Verwenden Sie den Befehl npm init, um package.json zu generieren, wenn die Datei nicht vorhanden ist.) Beispiel:

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

Ausführliche Informationen zum Objekt dependencies finden Sie auf der Seite npm-package.json. Um die installierte oracledb-Version anzuzeigen, können Sie den Befehl npm list verwenden. Beispiel:

npm list -g --depth=0

Verbindungen für hohe Performance und kontinuierliche Verfügbarkeit codieren

Um hohe Performance und kontinuierliche Verfügbarkeit zu erreichen, befolgen Sie beim Herstellen von Verbindungen zur Datenbank die folgenden Richtlinien:

Beispiel:

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

In diesem Beispiel wird ein Pool für Verbindungen zum Datenbankservice tp_tls erstellt, und FAN wird aktiviert, indem die Eigenschaft events auf true gesetzt wird.

Verwandte Inhalte