Datenbankverbindung

Einführung

Eine Datenbankverbindung wird mithilfe des Datenbank-Connectors konfiguriert, der den Zugriff auf eine Datenbank ermöglicht. Sobald eine Verbindung hergestellt ist, können Sie eine oder mehrere Datenbankaktivitäten konfigurieren, die mit dieser Verbindung verknüpft sind und entweder als Quelle zum Bereitstellen von Daten für einen Operation oder ein Script oder als Ziel zum Verwenden von Daten in einem Operation oder Script verwendet werden können.

Cloud-Agenten unterstützen einen bereitgestellten Satz von JDBC-Treibern. Private Agenten unterstützen sowohl ODBC- als auch JDBC-Treiber. Zusätzlich zu den bereitgestellten Treibern können Sie zusätzliche ODBC- und JDBC-Treiber installieren auf private Agenten.

Informationen zum Konvertieren einer vorhandenen Datenbankverbindung von der Verwendung eines ODBC Treiber zur Verwendung eines JDBC- Treiber finden Sie unter Konvertieren von ODBC zu JDBC weiter unten auf dieser Seite.

Erstellen oder Bearbeiten einer Datenbankverbindung

Eine neue Datenbankverbindung wird mithilfe des Datenbankkonnektors von einem dieser Standorte aus erstellt:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint erstellen in Globale Verbindungen).

Eine bestehende Datenbankverbindung kann von diesen Orten aus bearbeitet werden:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint bearbeiten in Globale Verbindungen).

Konfigurieren einer Datenbankverbindung

Die Konfiguration einer Datenbankverbindung umfasst diese Felder:

• Endpoint: Geben Sie einen Namen ein, der zur Identifizierung der Datenbankverbindung verwendet werden soll. Der Name muss für jede Datenbankverbindung eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:). Dieser Name wird auch verwendet, um den Endpoint zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

• Fahrertyp: Um die Liste der Fahrer zu filtern, wählen Sie die Schaltfläche für den entsprechenden Treiber.

• Treiber: Verwenden Sie das Dropdown-Menü, um den Treiber auszuwählen. Die verfügbaren Treiber hängen davon ab, ob Sie Cloud-Agenten oder private Agenten verwenden (siehe Datenbanktreiber unten). Wenn Sie einen Treiber auswählen, können sich die übrigen in diesem Konfigurationsbildschirm verfügbaren Felder ändern, da nur die für den ausgewählten Treiber geltenden Felder angezeigt werden.

• Servername: Geben Sie den Namen, die URL oder die IP-Adresse des Datenbankservers ein.

• Datenbankname: Geben Sie ggf. den Namen der Datenbank ein. Bei Datenbanktreibern, für die dieses Feld nicht gilt, wie z. B. Oracle, ist dieses Feld möglicherweise nicht vorhanden.

• Anmeldename und Passwort: Geben Sie ggf. einen Benutzernamen und ein Passwort ein, die den Zugriff auf die Datenbank ermöglichen. Sie können diese Felder leer lassen, wenn kein Benutzername oder Passwort erforderlich ist.

• Standardport verwenden: Lassen Sie dieses Kontrollkästchen aktiviert, um den Port zu verwenden. Der Port ist je nach ausgewähltem Treiber unterschiedlich. Wenn Sie den Port nicht verwenden möchten, deaktivieren Sie das Kontrollkästchen Standardport verwenden und geben Sie den zu verwendenden Port in das Feld Port unten ein.

• Port: (Dieses Feld ist nur aktiviert, wenn das Kontrollkästchen Standardport verwenden deaktiviert ist.) Geben Sie nur dann einen benutzerdefinierten Port ein, wenn der Datenbankserver auf einem nicht standardmäßigen Port lauscht.

• Optionale Einstellungen: Klicken Sie hier, um weitere optionale Einstellungen anzuzeigen:

  

  • Für Massendaten optimieren: Nur verfügbar, wenn entweder der Oracle oder SQL Server jTDS- Treiber ausgewählt ist. Aktivieren Sie dieses Kontrollkästchen, um die Leistung beim Arbeiten mit großen Datenmengen zu verbessern.

  • Transaktionsisolationsebene: Wählen Sie ggf. über das Dropdown-Menü die Transact-SQL (T-SQL)-Isolationsebene aus. Treiberspezifische Transaktionsisolationsebenen werden nicht unterstützt. Die Option DEFAULT verwendet die Standardtransaktionsisolationsebene des Treiber oder Datenbankservers.

  • Timeout (Sek.): Um ein Limit für die Wartezeit auf eine erfolgreiche Verbindung zur Datenbank festzulegen, geben Sie hier eine Anzahl von Sekunden ein. Der Standardwert beträgt 300 Sekunden (5 Minuten).

  • Abrufgröße: Wenn Sie einen JDBC- Treiber verwenden, teilt dies dem Treiber mit, wie viele Zeilen abgerufen werden sollen, wenn mehr Zeilen erforderlich sind. Dies kann verwendet werden, um die Verarbeitung großer Datensätze zu verbessern.

  • Zusätzliche Verbindungszeichenfolgenparameter: Um der Datenbankverbindungszeichenfolge zusätzliche Parameter hinzuzufügen, geben Sie sie hier ein. Beachten Sie, dass dieses Feld deaktiviert ist, wenn Sie unten die Option zur Verwendung einer Verbindungszeichenfolge ausgewählt haben.

  • Verbindungszeichenfolge verwenden: Aktivieren Sie dieses Kontrollkästchen, um in das Feld unten eine Verbindungszeichenfolge einzugeben. Wenn diese Option aktiviert ist, werden die oben stehenden Zusätzlichen Verbindungszeichenfolgenparameter deaktiviert und überschrieben. Wenn diese Option aktiviert ist und das Feld Verbindungszeichenfolge leer gelassen wird, werden der oben konfigurierte Servername, Anmeldedaten und Passwort verwendet.

  • Verbindungszeichenfolge: Geben Sie ggf. eine Verbindungszeichenfolge in das Textfeld ein. Das Kontrollkästchen oben muss aktiviert sein, damit dieses Feld aktiviert wird.

    Tipp

    Lesen Sie die datenbankspezifische Dokumentation zum Erstellen manueller Verbindungszeichenfolgen. Beispiele finden Sie auch unter https://www.connectionstrings.com.

    Hinweis

    Die Verbindungszeichenfolge wird während der Konfiguration im Klartext angezeigt, daher sollten Sie den Benutzernamen und das Kennwort möglicherweise nicht in die Zeichenfolge aufnehmen. Anstatt diese Parameter und Werte in die Zeichenfolge aufzunehmen, verwenden Sie die Felder Anmelden und Kennwort, die als Teil der Benutzeroberfläche bereitgestellt werden. Sie werden dann bei Bedarf an die Verbindungszeichenfolge angehängt, sind jedoch nicht auf dem Bildschirm sichtbar.

• Test: Klicken Sie hier, um die Verbindung zur Datenbank zu überprüfen. Wenn Sie eine Datenbankverbindung testen, wird das von der Datenbank verwendete Anführungszeichen, entweder ein einfaches oder ein doppeltes Anführungszeichen, identifiziert. Wenn Sie die Verbindung zu diesem Zeitpunkt nicht testen, werden die Informationen zum öffnenden und schließenden Anführungszeichen abgerufen, wenn Sie eine Aktivität konfigurieren.

• Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder vorhandenen Konfiguration vorgenommen haben, klicken Sie hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration auf, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Datenbanktreiber

Die im Dropdown-Menü Treiber zur Auswahl stehenden Treiber hängen davon ab, ob Sie Cloud-Agenten oder private Agenten verwenden.

Cloud-Agenten

Cloud-Agent-Gruppen unterstützen nur JDBC-Treiber. Die folgenden JDBC-Treiber werden bereitgestellt:

• Amazon Redshift
• IBM DB2 (AS400)
• MySQL
• Oracle (JDBC 19.7)
• Oracle NetSuite
• PostgreSQL
• SQL Server jTDS
• SQL Server MS JDBC
• Sybase jTDS

Private Agenten

Private Agenten unterstützen JDBC-Treiber und ODBC-Treiber. Bei ODBC-Treibern muss die Architektur des Treiber mit dem System des Agenten übereinstimmen. Das heißt, 32-Bit-Agenten unterstützen 32-Bit-ODBC-Treiber und 64-Bit-Agenten unterstützen 64-Bit-ODBC-Treiber.

Diese JDBC-Treiber werden von privaten 64-Bit-Windows und Linux Agenten bereitgestellt:

• Amazon Redshift
• IBM DB2 (AS400)
• IBM DB2 (JCC)
• MySQL
• Oracle (JDBC 19.7)
• Oracle NetSuite
• PostgreSQL
• SQL Server jTDS
• SQL Server Microsoft
• SQLite
• Sybase jTDS

Die folgenden ODBC-Treiber sind im Lieferumfang der privaten 64-Bit Windows-Agenteninstallation enthalten:

• PostgreSQL ANSI (x64)
• PostgreSQL Unicode (x64)

Dieser ODBC Treiber ist im Lieferumfang der 64-Bit Linux Privatagent-Installation enthalten:

• PostgreSQL-jitterbit

Zusätzliche Treiber werden vom Operationssystem erkannt. Sie können zusätzliche Datenbanktreiber installieren nach Bedarf.

Nächste Schritte

Nachdem eine Datenbankverbindung erstellt wurde, sind Menüaktionen für diese Verbindung über die Tab Komponenten des Projektbereichs zugänglich. Siehe Aktionsmenü Verbindungsaktionen für weitere Einzelheiten.

Wenn Sie eine Datenbankverbindung konfigurieren, können Sie eine oder mehrere mit dieser Verbindung verknüpfte Datenbankaktivitäten so konfigurieren, dass sie als Quelle (zum Bereitstellen von Daten innerhalb einer Operation), als Ziel (zum Verwenden von Daten innerhalb einer Operation) oder in einem Script verwendet werden. Alternativ können Sie die Datenbankverbindung in einem Script verwenden.

Konfigurieren von Aktivitäten

Datenbankaktivitäten interagieren mit der Datenbankverbindung, um als Quellen (Bereitstellung von Daten innerhalb einer Operation) oder Ziele (Empfang von Daten innerhalb einer Operation) zu fungieren.

Nachdem Sie eine Datenbankverbindung konfiguriert haben, filtern Sie mithilfe der Dropdown-Liste Anzeigen nach Endpoints und klicken Sie dann auf den Block „Datenbankverbindung“, um Aktivitäten anzuzeigen, die für die Verwendung mit einer Datenbankverbindung verfügbar sind:

Weitere Informationen finden Sie in diesen Aktivitäten:

• Abfrage: Fragt Daten von einem Endpoint ab und ist zur Verwendung als Quelle in einer Operation oder zum Aufruf in einem Script vorgesehen.
• Einfügen: Fügt neue Daten in einen Endpoint ein und soll als Ziel in einer Operation verwendet oder in einem Script aufgerufen werden.
• Aktualisieren: Aktualisiert vorhandene Daten in einem Endpoint und soll als Ziel in einer Operation verwendet oder in einem Script aufgerufen werden.
• Upsert: Aktualisiert vorhandene Daten und fügt neue Daten in einen Endpoint ein und soll als Ziel in einer Operation verwendet oder in einem Script aufgerufen werden. (Harmony unterstützt Upsert-Aktivitäten für Datenbanken durch Verwendung einer Kombination aus Abfrage, Einfügen und Aktualisieren.)

Verwenden von Datenbankverbindungen in Scripts

Datenbankverbindungen können in einem Script mithilfe von Script referenziert werden, die eine databaseId als Parameter:

Jitterbit Script Skriptfunktionen

• CacheLookup- CallStoredProcedure- DBCloseConnection- DBExecute- DBLookup- DBLookupAll- DBRollbackTransaction- DBWrite

JavaScript-Jitterbit-Funktionen

• Jitterbit.DbExecute- Jitterbit.DbLookup

Weitere Einzelheiten zum Referenzieren von Endpoints in Scripts finden Sie unter Endpoints in Jitterbit Script oder Endpoints in JavaScript.

Konvertieren von ODBC zu JDBC

Die Konvertierung einer Datenbankverbindung von der Verwendung eines ODBC Treiber zur Verwendung eines JDBC- Treiber ist normalerweise ein unkomplizierter Vorgang. Dies kann erforderlich sein, wenn Sie ein Projekt von der Ausführung auf einem privaten Agenten mit einem ODBC- Treiber auf eine Jitterbit-Cloud-Agentengruppe verschieben, die ab Harmony 9.8, unterstützen keine ODBC-Treiber mehr in den Cloud-Agent-Gruppen.

Wenn Ihre Verbindung die Standardoptionen verwendet, können Sie sie schnell konvertieren, indem Sie die unten beschriebenen Schritte befolgen. Wenn Sie jedoch die Option verwendet haben, zusätzliche Verbindungszeichenfolgenparameter anzugeben oder die Verbindungszeichenfolge manuell zu erstellen, müssen Sie diese Optionen anpassen, um die Unterschiede zwischen ODBC und JDBC zu berücksichtigen.

Jitterbit-Unterstützung steht Ihnen zur Verfügung, um Sie bei der Konvertierung Ihrer Verbindung zu JDBC zu unterstützen, wenn Sie Unterstützung bei der Konvertierung Ihrer Datenbankverbindungen oder der Überarbeitung erweiterter Optionen benötigen.

Konvertieren einfacher Datenbankverbindungen

Um eine Datenbankverbindung, die aktuell einen ODBC Treiber verwendet, in eine Verbindung mit einem JDBC Treiber umzuwandeln, führen Sie die folgenden Schritte aus:

1. Öffnen Sie die Datenbankverbindung, die einen ODBC Treiber verwendet. In diesem Beispiel wurde eine Verbindung mit dem PostgreSQL Treiber geöffnet:

   

2. Testen Sie die Verbindung, indem Sie auf die Schaltfläche Test klicken, um sicherzustellen, dass sie funktioniert:

   

3. Wenn die Verbindung erfolgreich war, können Sie mit dieser Konvertierung fortfahren. Wenn nicht, beheben Sie alle Fehler, bevor Sie fortfahren.

4. Überprüfen Sie, ob zusätzliche Verbindungsparameter angegeben wurden, indem Sie unten im Konfigurationsbildschirm auf Optionale Einstellungen klicken:

   

   • Wenn außer den oben gezeigten Standardeinstellungen keine weiteren Verbindungsparameter angegeben wurden, können Sie mit der Konvertierung der Datenbankverbindung fortfahren, indem Sie den Rest dieser Anweisungen befolgen.
   • Wenn neben den oben gezeigten Standardeinstellungen weitere Verbindungsparameter angegeben wurden, lesen Sie den nächsten Abschnitt Konvertieren von Verbindungen mit zusätzlichen Verbindungsparametern.

5. Ändern Sie den Treibertyp in JDBC und wählen Sie dann im Dropdown-Menü Treiber den entsprechenden JDBC- Treiber aus. In diesem Beispiel haben wir den JDBC- Treiber_PostgreSQL_ ausgewählt.

   

6. Testen Sie die überarbeitete Verbindung, indem Sie auf die Schaltfläche Test klicken, um sicherzustellen, dass sie funktioniert:

   

7. Klicken Sie auf die Schaltfläche Änderungen speichern, um die überarbeitete Datenbankverbindung zu speichern.

Konvertieren von Verbindungen mit zusätzlichen Verbindungsparametern

Wenn Ihre Verbindung über die oben angezeigten Standardwerte hinaus zusätzliche Verbindungsparameter verwendet, entweder als Zusätzliche Verbindungszeichenfolgenparameter oder wenn das Kontrollkästchen Verbindungszeichenfolge verwenden aktiviert und die Verbindungszeichenfolge manuell eingegeben wurde, sind möglicherweise zusätzliche Schritte erforderlich, um die Verbindung von ODBC in JDBC zu konvertieren. Die Zusätzlichen Verbindungszeichenfolgenparameter für SQL Server ODBC könnten beispielsweise lauten (um die NTLM- Windows Authentifizierung zu verwenden):

integratedSecurity=true

Ein äquivalenter SQL Server jTDS JDBC Treiber Zusätzliche Verbindungszeichenfolgenparameter (zur Verwendung der NTLM- Windows Authentifizierung) wäre:

useNTLMv2=true

Verbindungszeichenfolgenparameter sind spezifisch für den von Ihnen verwendeten Treiber (z. B. Microsoft SQL, MySQL, PostgreSQL oder Oracle). Überprüfen Sie die Treiber, um die erforderlichen Parameter zu bestimmen. Wenn Sie Hilfe beim Konvertieren von Verbindungszeichenfolgen oder Parametern für einen JDBC- Treiber benötigen, wenden Sie sich an den Jitterbit-Support.