Verbindung zu Oracle mit dem Database-Connector in Jitterbit Studio

Diese Seite beschreibt, wie man sich mit einer Oracle-Datenbank über den Database-Connector verbindet.

Man kann sich mit einer Oracle-Datenbank entweder über einen JDBC- oder ODBC-Treiber verbinden. Der Oracle JDBC-Treiber 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 man eine Oracle-Datenbank in Studio mit einem ODBC-Treiber auf privaten Agenten konfiguriert.

Oracle-Client auf dem Jitterbit-Private-Agent installieren

Bevor man eine Verbindung zu Oracle über ODBC herstellen kann, muss der Oracle-Client (einschließlich des Oracle ODBC-Treibers) auf dem Jitterbit-Private-Agent installiert sein. Bei Verwendung mehrerer privater Agenten innerhalb einer Agent-Gruppe muss der Oracle-Client auf allen Agenten in der Gruppe installiert sein. Weitere Informationen finden Sie unter Agents.

Oracle-Client konfigurieren und testen

Nach der Installation des Oracle-Clients konfiguriert man die Datei tnsnames.ora, um auf die Datenbank zu verweisen, die man verwenden möchte. Dies ist Teil des standardmäßigen Oracle-Client-Setups. Weitere Informationen finden Sie unter Tnsnames.org - Oracle FAQ oder in der Oracle-Dokumentation für die verwendete Version.

Nach dem Setup des Oracle-Clients auf dem privaten Agent sollte man den Server testen, um sicherzustellen, dass Harmony Konnektivität zur Datenbank hat. Eine Möglichkeit besteht darin, sich über SQL*Plus mit dem Server zu verbinden. Wenn dies erfolgreich ist, sollte der Oracle-Client mit Harmony ordnungsgemäß funktionieren.

Darüber hinaus können einige Versionen des Oracle-Treibers (nicht der Microsoft Oracle-Treiber) eine oder mehrere Umgebungsvariablen im Betriebssystem erfordern. 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 muss man möglicherweise auch das Oracle-Bibliotheksverzeichnis zum Pfad hinzufügen (z. B. LD_LIBRARY_PATH). Diese werden zur Datei /etc/sysconfig/jitterbit hinzugefügt. Einige Beispiele sind unten dargestellt, aber der genaue Pfad hängt von der 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

Database-Verbindung konfigurieren

Nach der Konfiguration und dem Testen des Oracle-Clients gibt man diese Eingaben während der Konfiguration der Database-Verbindung an:

Driver Type: Wählen Sie ODBC.
Driver: Wählen Sie den Oracle-Treiber. Wenn der Treiber nicht in der Liste angezeigt wird, siehe Treiber zur Jitterbit-Agent-Konfigurationsdatei hinzufügen unten.
Use Connection String: Aktivieren Sie unter Optional Settings dieses Kontrollkästchen. Man muss die Verbindungszeichenfolge manuell erstellen, da Oracle die Datenbank basierend auf der Einstellung in tnsnames.ora referenziert.
Connection String: Geben Sie unter Optional Settings die manuelle Verbindungszeichenfolge für die 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

Weitere Oracle-Verbindungszeichenfolgen-Beispiele finden Sie unter The Connection Strings Reference.

Treiber zur Private-Agent-Konfigurationsdatei hinzufügen

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

Nachdem die Treiberinformationen wie unten beschrieben hinzugefügt wurden, sollte Ihr Treiber bei der Auswahl in Studio in der Liste der ODBC-Treiber angezeigt werden. Falls die folgenden Schritte nicht erfolgreich sind, finden Sie unter Zusätzliche ODBC- oder JDBC-Treiber installieren Details zur Treiberinstallation.

Konfiguration des Remote-Agenten

Wenn Sie die Remote-Agent-Konfiguration über die Management Console aktiviert haben, können Sie Ihre Treiberinformationen wie folgt auf der Registerkarte Db Drivers hinzufügen. Details zur Remote-Agent-Konfiguration finden Sie im Abschnitt Agents unter Agents.

Gehen Sie in der Management Console zu Agents > Agent Groups.
Suchen Sie in der Tabelle Ihre Agent-Gruppe und verwenden Sie das Dropdown-Menü Action, um Jitterbit Conf auszuwählen.
Wählen Sie im Dialog die Registerkarte Db Drivers und klicken Sie oben rechts auf Edit. Suchen Sie den folgenden Beispieleintrag für eine bestimmte Oracle-Version und ersetzen Sie die bereitgestellten Beispielinformationen durch die Informationen für Ihren spezifischen Oracle-ODBC-Treiber. Klicken Sie nach Abschluss auf Submit, um die Treiberinformationen in der Konfigurationsdatei des privaten Agenten 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.

Beenden Sie auf dem Computer, auf dem jeder private Agent installiert ist, zunächst die Dienste und starten Sie sie dann neu. Weitere Informationen finden Sie unter Windows-Private-Agent neu starten oder Linux-Private-Agent neu starten.

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 Agent befindet. Details finden Sie unter Konfigurationsdatei bearbeiten (jitterbit.conf).

Öffnen Sie jitterbit.conf in einem Text-Editor und scrollen Sie zum Abschnitt [DbDrivers].
Suchen Sie den folgenden Beispieleintrag für eine bestimmte Oracle-Version und ersetzen Sie die bereitgestellten Beispielinformationen durch die Informationen für Ihren spezifischen Oracle-ODBC-Treiber. Speichern Sie die Datei jitterbit.conf nach Abschluss.
```
#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.

Beenden Sie auf dem Computer, auf dem jeder private Agent installiert ist, zunächst die Dienste und starten Sie sie dann neu. Weitere Informationen finden Sie unter Windows-Private-Agent neu starten oder Linux-Private-Agent neu starten.

WHERE-Klausel-Beispiele

Diese WHERE-Klausel-Beispiele werden als Referenz bei der Konfiguration einer Database-Query-Aktivität bereitgestellt:

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

Weitere Beispiele finden Sie unter Oracle Basics und im Oracle-Artikel WHERE clause.