Mit Node.js und anderen Skriptsprachen eine Verbindung zu Autonomous Database herstellen

Sie können Programme in verschiedenen Sprachen verwenden, einschließlich Node.js, PHP, Ruby, R, Go und Perl, um eine Verbindung zu Autonomous Database on Dedicated Exadata Infrastructure 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 mit Ihrer Skriptssprache eine Verbindung zu Autonomous Database on Dedicated Exadata Infrastructure herzustellen, installieren Sie zuerst wie folgt den Sprachtreiber und die Client-Librarys:

  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 (Beispiel: C:\instantclient_12_2). Rufen Sie unter Windows 8 den Einstellungsbereich der Variablen 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 Instant Client-Downloaddateien für Linux 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, verwenden Sie die Anweisungen auf der folgenden Seite: ROracle.

    • PHP: Um PHP OCI8 für PHP zu installieren, verwenden 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 den Library-Suchpfad wie LD_LIBRARY_PATH oder PATH auf das Instant Client-Verzeichnis, und verwenden Sie die Anweisungen auf der folgenden Seite: DBD::Oracle.

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

  1. Rufen Sie die Clientsicherheitszugangsdaten ab, um eine Verbindung zu einer Autonomous Database-Instanz herzustellen. Sie benötigen eine ZIP-Datei mit Clientsicherheitszugangsdaten und Netzwerkkonfigurationseinstellungen, die für den Zugriff auf die autonome 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.

    • Sonstiger Benutzer (kein Administrator): Beziehen Sie das Oracle Wallet vom Administrator für die autonome Datenbank.

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

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

    2. Wenn Sie Instant Client verwenden, erstellen Sie gegebenenfalls eine Unterverzeichnishierarchie network/admin unter dem Instant Client-Verzeichnis. 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, verschieben Sie die Datei in $ORACLE_HOME/network/admin.

    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 die folgenden Dateien erforderlich: tnsnames.ora, sqlnet.ora, cwallet.sso und ewallet.p12.

Anwendung ausführen

  1. Aktualisieren Sie die Anwendung so, dass die 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 der Anwendung verwendeten Zeichenfolge übereinstimmt.

  3. Führen Sie die Anwendung aus.

Verwandte Themen