Zum Inhalt springen

Datenbankverbindung

Einführung

Eine Datenbankverbindung, die mit dem Datenbank-Connector erstellt wird, ermöglicht den Zugriff auf eine Datenbank über einen JDBC- oder ODBC-Treiber, der mit Jitterbit Cloud Agents bereitgestellt oder auf Jitterbit Private Agents installiert wird. Nach der Konfiguration einer Verbindung können Sie Instanzen von Datenbankaktivitäten erstellen, die dieser Verbindung zugeordnet sind und entweder als Quellen (zur Bereitstellung von Daten in einem Vorgang) oder als Ziele (zur Verarbeitung von Daten in einem Vorgang) verwendet werden.

Hinweis

Dieser Connector unterstützt die Organisationsrichtlinie Erneute Authentifizierung bei Änderung aktivieren. Wenn diese aktiviert ist, erfordert eine Änderung des Servernamens oder der Anmeldung in einer Endpunktverbindung, dass Benutzer das Passwort für die Verbindung erneut eingeben.

Datenbankverbindung erstellen oder bearbeiten

Eine neue Datenbankverbindung wird mit dem Datenbank-Connector von einem dieser Orte aus erstellt:

Eine bestehende Datenbankverbindung kann von diesen Orten aus bearbeitet werden:

Datenbankverbindung konfigurieren

Im Folgenden wird jedes Benutzeroberflächenelement des Konfigurationsbildschirms für Datenbankverbindungen beschrieben.

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben, oder klicken Sie auf das Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen.

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

  • Treibertyp: Wählen Sie die Schaltfläche für den entsprechenden Treibertyp, um die Treiberliste zu filtern. Cloud Agents unterstützen nur eine begrenzte Anzahl von JDBC-Treibern, während Private Agents sowohl ODBC- als auch JDBC-Treiber unterstützen und zusätzliche Treiber installiert werden können (siehe Datenbanktreiber auf Jitterbit Private Agents für weitere Informationen).

  • Treiber: Verwenden Sie die Liste, um den Datenbanktreiber auszuwählen. Die verfügbaren Treiber hängen davon ab, ob Sie Cloud Agents oder Private Agents verwenden (siehe Datenbanktreiber). Bei Auswahl eines Datenbanktreibers können sich die verbleibenden verfügbaren Felder in diesem Konfigurationsbildschirm ändern, da nur die für den ausgewählten Datenbanktreiber gültigen Felder angezeigt werden.

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

    Achtung

    Agent Version 12.10 und später blockiert eine Datenbankverbindung zu localhost oder 127.0.0.1 standardmäßig aus Sicherheitsgründen. Auf einem Private Agent siehe [JdbcSecurity] in der Agent-Konfigurationsdatei, um eine Datenbank zuzulassen, die auf demselben Host wie der Agent ausgeführt wird.

  • Datenbankname: Falls zutreffend, geben Sie den Namen der Datenbank ein. Dieses Feld ist möglicherweise nicht vorhanden für Datenbanktreiber, für die dieses Feld nicht relevant ist, z. B. Oracle.

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

  • Standardport verwenden: Aktivieren Sie dieses Kontrollkästchen, um den Standardport zu verwenden. Der Standardport unterscheidet sich je nach ausgewähltem Treiber. Wenn Sie keinen Standardport verwenden möchten, deaktivieren Sie das Kontrollkästchen Standardport verwenden und geben Sie den zu verwendenden Port im Feld Port unten ein.

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

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen anzuzeigen.

    • Batch aktivieren: Nur verfügbar bei Verwendung eines JDBC-Treibers. Aktivieren Sie dieses Kontrollkästchen, um die Leistung bei der Arbeit mit großen Datenmengen mit Insert- oder Update-Aktivitäten zu verbessern. Wenn die Einstellungen Batch aktivieren und Für Massendaten optimieren beide sichtbar sind, bewirkt die Auswahl beider dieselbe Funktionalität.

      Wichtig

      Fügen Sie für den MySQL JDBC-Treiber auch rewriteBatchedStatements=true zu den Zusätzlichen Verbindungszeichenfolgen-Parametern unten hinzu, um den vollständigen Leistungsvorteil von Batch aktivieren zu nutzen.

    • Für Massendaten optimieren: Nur verfügbar, wenn der Oracle- oder SQL Server jTDS-Datenbanktreiber ausgewählt ist. Aktivieren Sie dieses Kontrollkästchen, um die Leistung bei der Arbeit mit großen Datenmengen mit Insert- oder Update-Aktivitäten zu verbessern. Wenn die Einstellungen Batch aktivieren und Für Massendaten optimieren beide sichtbar sind, bewirkt die Auswahl beider dieselbe Funktionalität.

    • Transaktionsisolationsstufe: Falls zutreffend, wählen Sie mithilfe der Dropdown-Liste die Transaktionsisolationsstufe aus. Treiberspezifische Transaktionsisolationsstufen werden nicht unterstützt. Die Option STANDARD verwendet die Transaktionsisolationsstufe des Treibers oder des Datenbankservers als Standard.

    • Timeout (Sek.): Um eine Grenze dafür festzulegen, wie lange auf eine erfolgreiche Verbindung mit der Datenbank gewartet werden kann, geben Sie hier eine Anzahl von Sekunden ein. Der Standard beträgt 300 Sekunden (5 Minuten).

      Tipp

      Diese Grenze gilt auch, wenn das Connection Pooling der Agent-Version 12.11 und später eine neue physische Verbindung erstellt. Informationen zu einem privaten Agent finden Sie unter [SourceTargetPooling] in der Agent-Konfigurationsdatei. Das Pooling fügt eine separate Einstellung jdbc.hikari.connectionTimeout hinzu, um festzulegen, wie lange ein Vorgang wartet, um eine Verbindung aus dem Pool zu erhalten, sobald alle gepoolten Verbindungen in Gebrauch sind.

    • Fetch-Größe: Bei Verwendung eines JDBC-Treibers wird dem Treiber mitgeteilt, wie viele Zeilen abgerufen werden sollen, wenn weitere Zeilen erforderlich sind. Dies kann verwendet werden, um die Verarbeitung großer Datensätze zu verbessern.

    • Zusätzliche Verbindungszeichenfolgen-Parameter: Geben Sie hier alle zusätzlichen Parameter für die Datenbankverbindungszeichenfolge ein. Dieses Feld ist deaktiviert, wenn Sie die Option Verbindungszeichenfolge unten verwenden.

      Tipp

      Geben Sie bei Verwendung von SQL Server MS JDBC (Microsoft's JDBC-Treiber für SQL Server) in diesem Feld authentication=ActiveDirectoryPassword ein, um die Microsoft Entra-Authentifizierung zu ermöglichen. Dieses Feld steuert auch die Verbindungsverschlüsselung, die unter Verbindungsverschlüsselung und Serverzertifikate beschrieben wird.

      Vorsicht

      Die Agent-Version 12.10 und später blockiert oder beschränkt standardmäßig aus Sicherheitsgründen bestimmte Parameter hier für die MySQL-, PostgreSQL-, Oracle- und SQL Server-Treiber. Informationen zu einem privaten Agent finden Sie in der Agent-Konfigurationsdatei unter [JdbcSecurity], um die eingeschränkten Parameter und die Aktivierung eines erforderlichen Parameters anzuzeigen.

  • Verbindungszeichenfolge verwenden: Aktivieren Sie dieses Kontrollkästchen, um eine Verbindungszeichenfolge in das Feld unten einzugeben. Wenn aktiviert, werden die Zusätzlichen Parameter für Verbindungszeichenfolgen oben deaktiviert und außer Kraft gesetzt. Wenn aktiviert und das Feld Verbindungszeichenfolge leer gelassen wird, werden der Servername, die Anmeldedaten und das Passwort wie oben konfiguriert verwendet.

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

    !!! tip "Tipp"
    Konsultieren Sie die datenbankspezifische Dokumentation zum Erstellen manueller Verbindungszeichenfolgen. Beispiele finden Sie auch unter [https://www.connectionstrings.com](https://www.connectionstrings.com).

!!! note "Hinweis"
    Die Verbindungszeichenfolge wird während der Konfiguration im Klartext angezeigt. Daher sollten Sie möglicherweise nicht den Benutzernamen und das Passwort in die Zeichenfolge aufnehmen. Verwenden Sie stattdessen die **Anmeldedaten** und **Passwort**-Felder der Benutzeroberfläche, anstatt diese Parameter und Werte in die Zeichenfolge aufzunehmen. Sie werden dann bei Bedarf an die Verbindungszeichenfolge angehängt, sind aber auf dem Bildschirm nicht sichtbar.

!!! caution "Vorsicht"
    Agent-Version 12.10 und später blockieren oder beschränken hier standardmäßig aus Sicherheitsgründen bestimmte Parameter für die MySQL-, PostgreSQL-, Oracle- und SQL Server-Treiber. Bei einem privaten Agent finden Sie in [`[JdbcSecurity]`](/de/agent/jitterbit-conf/#jdbcsecurity) in der Agent-Konfigurationsdatei die eingeschränkten Parameter und wie Sie einen Ihrer Anforderungen entsprechenden Parameter zulassen.

  • Test: Klicken Sie, um die Verbindung zur Datenbank zu überprüfen. Beim Testen einer Datenbankverbindung wird das von der Datenbank verwendete Anführungszeichen – einfach oder doppelt – identifiziert. Wenn Sie die Verbindung zu diesem Zeitpunkt nicht testen, werden die Informationen zu öffnenden und schließenden Anführungszeichen beim Konfigurieren einer Aktivität abgerufen.

  • Speichern: Klicken Sie, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Nach Änderungen an einer neuen oder vorhandenen Konfiguration klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

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

Nächste Schritte

Menüaktionen für eine Verbindung und deren Aktivitätstypen sind über den Projektbereich und die Designkomponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Grundlagen zu Konnektoren.

Nach der Konfiguration einer Datenbankverbindung können Sie eine oder mehrere damit verknüpfte Datenbankaktivitäten konfigurieren, die entweder als Quelle zum Bereitstellen von Daten für einen Arbeitsablauf oder als Ziel zum Nutzen von Daten in einem Arbeitsablauf verwendet werden, oder Sie können die Datenbankverbindung in einem Skript verwenden.

Aktivitäten konfigurieren

Diese Aktivitätstypen sind verfügbar:

  • Abfrage: Fragt Daten von einem Datenbankendpunkt ab und ist als Quelle in einem Arbeitsablauf oder aufgerufen in einem Skript bestimmt.

  • Einfügen: Fügt neue Daten in einem Datenbankendpunkt ein und ist als Ziel in einem Arbeitsablauf oder aufgerufen in einem Skript bestimmt.

  • Aktualisieren: Aktualisiert vorhandene Daten in einem Datenbankendpunkt und ist als Ziel in einem Arbeitsablauf oder aufgerufen in einem Skript bestimmt.

  • Upsert: Aktualisiert sowohl vorhandene Daten als auch fügt neue Daten in einem Datenbankendpunkt ein und ist als Ziel in einem Arbeitsablauf oder aufgerufen in einem Skript bestimmt. (Harmony unterstützt Upsert-Aktivitäten für Datenbanken durch eine Kombination von Abfrage, Einfügen und Aktualisieren.)

Datenbankverbindungen in Skripten verwenden

Datenbankverbindungen lassen sich in einem Skript über Skriptfunktionen referenzieren, die einen databaseId als Parameter verwenden:

Jitterbit-Skriptfunktionen

JavaScript-Jitterbit-Funktionen

Weitere Informationen zum Referenzieren von Endpunkten in Skripten finden Sie unter Endpunkte in Jitterbit Script oder Endpunkte in JavaScript.