Verbindung zu autonomer KI-Datenbank mit Node.js und anderen Skriptsprachen herstellen

Sie können Programme in verschiedenen Sprachen verwenden, einschließlich Node.js, PHP, Ruby, R, Go und Perl, um eine Verbindung zu Autonomous AI Database auf einer dedizierten Exadata-Infrastruktur herzustellen. Sicherheit wird mit Clientzugangsdaten durchgesetzt.

Diese Skriptsprachen verfügen über Datenbankzugriffs-APIs oder Treiber, die die Oracle Call Interface-Librarys verwenden. Die Oracle Call Interface-Librarys können entweder vom vollständigen Oracle-Client oder von Oracle Instant Client stammen.

Sprachtreiber und Client-Librarys installieren

Um über Ihre Skriptsprache eine Verbindung zur autonomen KI-Datenbank auf dedizierter Exadata-Infrastruktur herzustellen, installieren Sie zuerst den Sprachtreiber und die Clientbibliotheken wie folgt:

  1. Installieren Sie den Instant Client oder den vollständigen Client. Die für den vollständigen Client unterstützte Mindestversion ist Version 11.2.0.4. Verwenden Sie für Oracle Instant Client Version 12.1.0.2 oder höher:

    Der Instant Client funktioniert bei den meisten Anwendungen gut. So installieren Sie den Instant Client:

    1. Wählen Sie auf der Downloadseite für den Instant Client die gewünschte Architektur aus, und laden Sie ein Basispackage herunter (auf der Downloadseite verfügbar): Oracle Instant Client

      Alternativ können Sie das Basic Light-Package für Ihre gewünschte Architektur von der Downloadseite herunterladen, wenn die Basic Light-Globalisierungseinschränkungen Ihrer Verwendung entsprechen.

    2. Wenn Sie eine Sprach-API oder einen Treiber aus dem Quellcode erstellen, müssen Sie möglicherweise auch das Instant Client-SDK herunterladen: Oracle Instant Client

    3. Dekomprimieren Sie das ausgewählte Basispackage. Beispiel: Dekomprimieren Sie die Datei in "C:\instantclient_12_2" oder "/home/myuser/instantclient_18_5". Wenn Sie auch das SDK herunterladen, dekomprimieren Sie es im selben Verzeichnis.

    4. Fügen Sie unter Windows den Pfad zur Variablen PATH im Abschnitt "Systemvariablen" des Bereichs "Umgebungsvariablen" hinzu (z.B. "C:\instantclient_12_2"). Rufen Sie in Windows 8 den Einstellungsbereich für die Variable PATH auf, indem Sie zu "Systemsteuerung > System> Erweiterte Systemeinstellungen > Umgebungsvariablen" navigieren. Wenn mehrere Versionen von Oracle-Librarys installiert sind, stellen Sie sicher, dass das neue Verzeichnis zuerst im Pfad enthalten ist.

    5. Erstellen Sie auf Nicht-Windows-Plattformen einen symbolischen Link, falls noch nicht vorhanden. Beispiel:

       cd /home/myuser/instantclient_18_5
       ln -s libclntsh.so.18.1 libclntsh.so
      

      Wenn auf dem System keine andere Oracle-Software vorhanden ist, die betroffen sein kann, fügen Sie Instant Client zum Laufzeitlinkpfad hinzu. Beispiel:

       sudo sh -c "echo /home/myuser/instantclient_18_5 > /etc/ld.so.conf.d/oic.conf"
       sudo ldconfig
      

      Legen Sie alternativ den Library-Pfad in jeder Shell fest, in der die Anwendung ausgeführt wird. Beispiel:

       export LD_LIBRARY_PATH=/home/myuser/instantclient_18_5:$LD_LIBRARY_PATH
      

      Hinweis: Die Linux Instant Client-Downloaddateien sind als .zip- oder .rpm-Dateien verfügbar. Sie können eine der beiden Versionen verwenden.

  2. Installieren Sie den entsprechenden Sprachtreiber für Oracle Database:

    • Node.js: Um node-oracledb für Node.js zu installieren, verwenden sie die Anweisungen auf der folgenden Seite: node-oracledb installieren.

    • ROracle: Um ROracle für R zu installieren, führen Sie die Anweisungen auf der folgenden Seite aus: ROracle

    • PHP: Um PHP OCI8 für PHP zu installieren, nutzen Sie die Anweisungen auf der folgenden Seite: PHP mit OCI8 konfigurieren.

      Windows-DLLs sind unter http://php.net/downloads.php und unter PECL oci8 verfügbar.

    • PHP PDO_OCI: Um PHP PDO_OCI für PHP zu installieren, verwenden sie die Anweisungen auf der folgenden Seite: Oracle Functions (PDO_OCI).

      Windows-DLLs sind unter http://php.net/downloads.php verfügbar und in PHP enthalten.

    • Ruby: Um ruby-oci8 für Ruby zu installieren, verwenden sie die Anweisungen auf der folgenden Seite: Für Oracle Instant Client installieren

    • DBD für Perl: Um DBD::Oracle für Perl zu installieren, setzen Sie ORACLE_HOME und die Library-Suchpfad wie LD_LIBRARY_PATH oder PATH auf das Instant Client-Verzeichnis, und verwenden die Anweisungen auf der folgenden Seite: DBD::Oracle.

Oracle-Netzwerkkonnektivität aktivieren und Sicherheitszugangsdaten abrufen (Oracle Wallet)

  1. Rufen Sie Client-Sicherheitszugangsdaten ab, um eine Verbindung zu einer autonomen AI-Datenbankinstanz herzustellen. Sie erhalten eine ZIP-Datei mit Clientsicherheitszugangsdaten und Netzwerkkonfigurationseinstellungen, die für den Zugriff auf Ihre autonome KI-Datenbank erforderlich sind. Sie müssen diese Datei und ihren Inhalt schützen, um einen nicht autorisierten Datenbankzugriff zu verhindern. Rufen Sie die Datei mit den Sicherheitszugangsdaten des Clients wie folgt ab:

    • ADMIN-Benutzer: Klicken Sie auf DB-Verbindung. Siehe Clientzugangsdaten herunterladen.

    • Anderer Benutzer (ohne Administrator): Rufen Sie das Oracle Wallet vom Administrator für Ihre autonome KI-Datenbank ab.

  2. Extrahieren Sie die Clientzugangsdaten-(Wallet-)Dateien:

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

    2. Wenn Sie Instant Client verwenden, können Sie gegebenenfalls eine Unterverzeichnishierarchie network/admin unter dem Instant Client-Verzeichnis erstellen. Verschieben Sie die Dateien dann in dieses Unterverzeichnis. Abhängig von der Architektur oder Ihrem Clientsystem und dem Ort, an dem Sie Instant Client installiert haben, sollten sich die Dateien im folgenden Verzeichnis befinden:

       C:\instantclient_12_2\network\admin
      

      Oder

       /home/myuser/instantclient_18_5/network/admin
      

      Oder

       /usr/lib/oracle/18.5/client64/lib/network/admin
      
      • Wenn Sie einen vollständigen Oracle-Client verwenden und die Datei in $ORACLE_HOME/network/admin verschieben.
    3. Alternativ können Sie die nicht komprimierten Wallet-Dateien in einem sicheren Verzeichnis ablegen und die Umgebungsvariable TNS_ADMIN auf diesen Verzeichnisnamen setzen.

    Hinweis: In der ZIP-Datei sind nur folgende Dateien erforderlich: tnsnames.ora, sqlnet.ora, cwallet.sso und ewallet.p12.

Anwendung ausführen

  1. Aktualisieren Sie die Anwendung so, dass eine Verbindung mit Ihrem Datenbankbenutzernamen, Ihrem Kennwort und dem Oracle Net-Verbindungsnamen in der entpackten Datei tnsnames.ora hergestellt wird. Beispiel: Benutzer atpc_user, Kennwort und atpc_low als Verbindungszeichenfolge.

  2. Ändern Sie alternativ die Verbindungszeichenfolge in tnsnames.ora so, dass sie mit der von Ihrer Anwendung verwendeten Zeichenfolge übereinstimmt.

  3. Führen Sie die Anwendung aus.

Verwandte Inhalte

Verbindung zu einer dedizierten autonomen KI-Datenbank herstellen