Ruby-Anwendung erstellen

Um eine Ruby-Anwendung zu erstellen, die auf eine Autonomous Database zugreift, konfigurieren Sie zunächst Ihr Entwicklungssystem so, dass der Datenbankzugriff unterstützt wird, dass die Features für kontinuierliche Verfügbarkeit und hohe Performance von Autonomous Database genutzt werden können.

Nachdem Sie das Entwicklungssystem für den Datenbankzugriff konfiguriert haben, codieren Sie Datenbankverbindungen und SQL-Anweisungen in der Anwendung, um diese Features zu nutzen.

Verwandte Themen

Ruby-Entwicklungssystem konfigurieren

Um Ihr Entwicklungssystem so zu konfigurieren, dass Ihre Ruby-Anwendung die Funktionen für kontinuierliche Verfügbarkeit und hohe Performance von einer Autonomous Database nutzen kann, führen Sie diese Schritte aus.

  1. Laden Sie Ruby herunter, und installieren Sie es.
  2. Laden Sie Oracle Instant Client herunter, und installieren Sie es.
  3. Laden Sie ruby-oci8 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.

Ruby herunterladen und installieren

Um Ruby herunterzuladen und zu installieren, gehen Sie zur Seite für die Installation von Ruby unter ruby-lang.org, und befolgen Sie die Anweisungen für das Betriebssystem und die Architektur Ihres Systems.

Oracle Instant Client herunterladen und installieren

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

  • Oracle Linux:

    Führen Sie die folgenden Befehle aus, um das Basispackage von Oracle Instant Client herunterzuladen und zu installieren:

    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, gehen Sie zu http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html.)

  • Andere OSes und Architekturen:

    1. Gehen Sie zur Seite Oracle Instant Client-Downloads, und wählen Sie den Download für das Betriebssystem und die Architektur Ihres Systems aus.

    2. Akzeptieren Sie auf der Downloadseite den Oracle Technology Network-Lizenzvertrag, laden Sie die neueste Version des Basispackages herunter, und installieren Sie sie, indem Sie die Anweisungen unten auf der Downloadseite befolgen.

ruby-oci8 herunterladen und installieren

Um die ruby-oci8-Schnittstelle herunterzuladen und in Oracle Database zu installieren, folgen Sie den Anweisungen auf der Seite Für Oracle Instant Client installieren.

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, mit dem Sie auf diese Seite zugreifen können, laden Sie die Zugangsdaten wie folgt herunter. Wenn Sie keinen solchen Account haben, müssen Sie die ZIP-Datei beim Administrator der Datenbank zusammen mit dem Kennwort anfordern, 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 Autonomous Database.

    2. Klicken Sie auf DB-Verbindung.

    3. Klicken Sie auf der Seite Datenbankverbindung auf Download.

    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 Download, 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 für die Unterstützung der Ruby-Anwendungskonnektivität mit einer Autonomous Database konfiguriert haben, befolgen Sie die folgenden Richtlinien, um eine hohe Performance und kontinuierliche Verfügbarkeit der Verbindungen Ihrer Anwendung zur Datenbank zu erreichen:

  • Verwenden Sie Verbindungspools.
  • Aktivieren Sie FAN (Fast Application Notification).
  • Verwenden Sie den vordefinierten Datenbankservice, der am besten zu den geplanten Vorgängen passt. Informationen zu den vordefinierten Datenbankservices finden Sie unter Namen vordefinierter Datenbankservices für autonome Datenbanken.

Beispiel:

require 'oci8'
OCI8.properties[:events_mode] = true
cpool = OCI8::ConnectionPool.new(1, 5, 2, username, password, 'tp_tls')
conn1 = OCI8.new(username, password, cpool)

In diesem Beispiel wird FAN aktiviert, indem die Eigenschaft events_mode auf true gesetzt wird. Außerdem wird ein Pool für Verbindungen zum Datenbankservice tp_tls erstellt und eine Verbindung vom Pool angefordert.

Zusätzliche Ressourcen

Ausführliche Informationen zu ruby-oci8 finden Sie auf der Seite Ruby-oci8.