Mit dem Datenbank-Connector in Jitterbit Studio eine Verbindung zu Oracle herstellen

Diese Seite beschreibt, wie Sie eine Verbindung zu einer Oracle-Datenbank über den Datenbank-Connector herstellen können.

Sie können eine Verbindung zu einer Oracle-Datenbank entweder über einen JDBC- oder ODBC-Treiber herstellen. Version 19.7 des JDBC-Treibers von Oracle ist in Cloud und privaten Agenten enthalten. Der JDBC-Treiber wird für zusätzliche Funktionen empfohlen, wie z. B. die Möglichkeit, eine manuelle Abfrage bereitzustellen, die über eine ODBC-Verbindung nicht verfügbar sind. In diesem Abschnitt wird beschrieben, wie Sie eine Oracle-Datenbank innerhalb von Studio mit einem ODBC-Treiber auf privaten Agenten konfigurieren.

Installieren Sie den Oracle-Client auf dem Jitterbit-Privatagenten

Bevor Sie eine Verbindung zu Oracle über ODBC herstellen können, müssen Sie den Oracle-Client (einschließlich des Oracle ODBC-Treibers) auf dem Jitterbit-Privatagenten installiert haben. Wenn Sie mehrere private Agenten innerhalb einer Agentengruppe verwenden, muss der Oracle-Client auf allen Agenten in der Gruppe installiert sein. Weitere Informationen finden Sie unter Agenten.

Konfigurieren und testen Sie den Oracle-Client

Nachdem Sie den Oracle-Client installiert haben, konfigurieren Sie die Datei tnsnames.ora, um auf die Datenbank zu verweisen, die Sie verwenden möchten. Dies ist Teil des Standardverfahrens zur Einrichtung des Oracle-Clients. Für weitere Informationen siehe die Tnsnames.org - Oracle FAQ oder konsultieren Sie die Oracle-Dokumentation für die von Ihnen verwendete Version.

Nachdem der Oracle-Client auf dem privaten Agenten eingerichtet ist, sollten Sie den Server testen, um sicherzustellen, dass Harmony eine Verbindung zur Datenbank hat. Eine Möglichkeit, dies zu tun, besteht darin, sich über SQL*Plus mit dem Server zu verbinden. Wenn dies erfolgreich ist, sollte der Oracle-Client korrekt mit Harmony funktionieren.

Zusätzlich benötigen einige Versionen des Oracle-Treibers (nicht der Microsoft Oracle-Treiber) möglicherweise, dass eine oder mehrere Umgebungsvariablen im Betriebssystem gesetzt werden. Zum Beispiel:

ORACLE_HOME=/usr/local/oracle/10.2.0
TNS_ADMIN=/usr/local/oracle/10.2.0/network/admin
TWO_TASK=//dbdpmr:1555/pmrd1

Unter Linux müssen Sie möglicherweise auch das Oracle-Bibliotheksverzeichnis zu Ihrem Pfad hinzufügen (z. B. LD_LIBRARY_PATH). Fügen Sie diese in die Datei /etc/sysconfig/jitterbit ein. Einige Beispiele sind unten aufgeführt, aber der genaue Pfad hängt von Ihrer Oracle-Client-Installation ab:

LD_LIBRARY_PATH=/usr/local/oracle/lib
export ORACLE_HOME=/usr/local/oracle/10.2.0
export TNS_ADMIN=/usr/local/oracle/10.2.0/network/admin
export TWO_TASK=//dbdpmr:1555/pmrd1

Konfigurieren der Datenbankverbindung

Nachdem der Oracle-Client konfiguriert und getestet wurde, geben Sie diese Eingaben während der Konfiguration der Datenbankverbindung an:

Treibertyp: Wählen Sie ODBC.
Treiber: Wählen Sie den Oracle-Treiber aus. Wenn Sie Ihren Treiber nicht in der Liste sehen, siehe Fügen Sie Ihren Treiber zur Jitterbit-Agenten-Konfigurationsdatei hinzu unten.
Verwenden Sie die Verbindungszeichenfolge: Aktivieren Sie dieses Kontrollkästchen unter Optionale Einstellungen. Sie müssen die Verbindungszeichenfolge manuell erstellen, da Oracle die Datenbank basierend auf der Einstellung in tnsnames.ora referenziert.
Verbindungszeichenfolge: Geben Sie unter Optionale Einstellungen die manuelle Verbindungszeichenfolge für Ihre spezifische Oracle-Datenbank ein. Zum Beispiel:
Oracle in OraHome92
```
Driver={Oracle in OraHome92};Dbq=myTNSServiceName;Uid=myUsername;Pwd=myPassword;
```
Oracle in OraClient11g_home1
```
DRIVER={Oracle in OraClient11g_home1};SERVER=[server SID];UID=[userid];
PWD=[password];DBQ=[server SID];
```
Tipp

Zusätzliche Beispiele für Oracle-Verbindungszeichenfolgen finden Sie in The Connection Strings Reference.

Fügen Sie Ihren Treiber zur privaten Agenten-Konfigurationsdatei hinzu

Aufgrund der vielen Variationen des Oracle-Treibernamens müssen Sie möglicherweise Ihre Treiberinformationen zur privaten Agenten-Konfigurationsdatei hinzufügen.

Sobald die Treiberinformationen wie unten beschrieben hinzugefügt wurden, sollten Sie beim Auswählen Ihres Treibers innerhalb von Studio Ihren Treiber in der Liste der ODBC-Treiber sehen. Wenn die folgenden Schritte nicht erfolgreich sind, siehe Installieren zusätzlicher ODBC- oder JDBC-Treiber für Details zur Treiberinstallation.

Remote-Agent-Konfiguration

Wenn die Remote-Agent-Konfiguration über die Management-Konsole aktiviert ist, können Sie Ihre Treiberinformationen unter dem Tab Db Drivers wie folgt hinzufügen. Für Details zur Remote-Agent-Konfiguration siehe den Abschnitt über Agenten unter Agenten.

Gehen Sie innerhalb der Management-Konsole zu Agenten > Agentengruppen.
Finden Sie innerhalb der Tabelle Ihre Agentengruppe und verwenden Sie das Dropdown-Menü Aktion, um Jitterbit Conf auszuwählen.
Wählen Sie im Dialog den Tab Db Drivers und klicken Sie dann oben rechts auf Bearbeiten. Finden Sie den folgenden Beispiel-Eintrag für eine spezifische Oracle-Version und ersetzen Sie die bereitgestellten Beispielinformationen durch die für Ihren spezifischen Oracle ODBC-Treiber. Klicken Sie nach Abschluss auf Übermitteln, um die Treiberinformationen in der Konfigurationsdatei des privaten Agents zu speichern.
```
#Oracle in OraClient10g_home2
'Oracle in OraClient10g_home2 Quote Begin'='\"'
'Oracle in OraClient10g_home2 Quote End'='\"'
```
Alle Jitterbit-Dienste müssen neu gestartet werden, damit die neue Konfiguration wirksam wird.

Auf dem Rechner, auf dem jeder private Agent installiert ist, stoppen Sie zuerst die Dienste und starten Sie sie dann neu. Siehe Einen Windows-Privatagenten neu starten oder Einen Linux-Privatagenten neu starten für weitere Informationen.

Manuelle Agent-Konfiguration

Wenn Sie die manuelle Agent-Konfiguration verwenden, können Sie Ihre Treiberinformationen im Abschnitt [DbDrivers] der Datei jitterbit.conf hinzufügen, die sich auf jedem privaten Agenten befindet. Für Details siehe Die Konfigurationsdatei (jitterbit.conf) bearbeiten.

Öffnen Sie jitterbit.conf in einem Texteditor und scrollen Sie zum Abschnitt [DbDrivers].
Suchen Sie den folgenden Beispiel-Eintrag für eine spezifische Oracle-Version und ersetzen Sie die bereitgestellten Beispielinformationen durch die für Ihren spezifischen Oracle ODBC-Treiber. Wenn Sie fertig sind, speichern Sie die Datei jitterbit.conf.
```
#Oracle in OraClient10g_home2
'Oracle in OraClient10g_home2 Quote Begin'='\"'
'Oracle in OraClient10g_home2 Quote End'='\"'
```
Alle Jitterbit-Dienste müssen neu gestartet werden, damit die neue Konfiguration wirksam wird.

Auf dem Rechner, auf dem jeder private Agent installiert ist, stoppen Sie zuerst die Dienste und starten Sie sie dann neu. Weitere Informationen finden Sie unter Neustart eines Windows-privaten Agents oder Neustart eines Linux-privaten Agents.

WHERE-Klausel-Beispiele

Diese WHERE-Klausel-Beispiele werden zu Referenzzwecken bereitgestellt, wenn Sie eine Datenbankabfrage-Aktivität konfigurieren:

WHERE
    product_name = 'Kingston';

WHERE
    list_price > 500;

WHERE
    list_price > 500
    AND category_id = 4;

WHERE
    list_price BETWEEN 650 AND 680

WHERE
    category_id IN(1, 4)

WHERE
    product_name LIKE 'Asus%'

WHERE business_seats_taken IS NULL
    OR business_seats_taken = 0

WHERE EMP_ACT.EMPNO = EMPLOYEE.EMPNO

WHERE THIS_EMP.JOB = 'SALESREP'
       AND THIS_EMP.WORKDEPT = DINFO.DEPTNO

Für zusätzliche Beispiele siehe Oracle Basics und den Oracle-Artikel WHERE-Klausel.