Zum Inhalt springen

Datenbankverbindung

Einführung

Eine Datenbankverbindung, die mit dem Datenbankkonnektor 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 Konnektor unterstützt die Organisationsrichtlinie Re-Authentifizierung bei Änderung aktivieren. Wenn diese aktiviert ist, erfordert eine Änderung des Servernamens oder der Anmeldedaten in der Verbindung eines Endpunkts, dass Benutzer das Passwort für die Verbindung erneut eingeben.

Datenbankverbindung erstellen oder bearbeiten

Eine neue Datenbankverbindung wird mit dem Datenbankkonnektor von einem dieser Orte aus erstellt:

Eine vorhandene Datenbankverbindung kann von diesen Orten aus bearbeitet werden:

Datenbankverbindung konfigurieren

Nachfolgend wird jedes Element der Benutzeroberfläche des Konfigurationsbildschirms für die Datenbankverbindung beschrieben.

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • 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 auf eine bestimmte Verbindung und 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 Sie zusätzliche Treiber installieren 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). Wenn Sie einen Datenbanktreiber auswählen, können sich die verbleibenden verfügbaren Felder auf diesem Konfigurationsbildschirm ändern, da nur die für den ausgewählten Datenbanktreiber geltenden Felder angezeigt werden.

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

    Vorsicht

    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 auf demselben Host wie der Agent ausgeführte Datenbank zuzulassen.

  • Datenbankname: Geben Sie ggf. 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.

  • Anmeldung 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: Aktivieren Sie dieses Kontrollkästchen, um den Standardport zu verwenden. Der Standardport unterscheidet sich je nach ausgewähltem Treiber. Wenn Sie den Standardport nicht 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 zu erweitern.

    • Batch aktivieren: Nur bei Verwendung eines JDBC-Treibers verfügbar. 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 Bulk-Daten optimieren beide sichtbar sind, aktiviert das Auswählen einer der beiden die gleiche 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 erhalten.

    • Für Bulk-Daten 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 Bulk-Daten optimieren beide sichtbar sind, aktiviert das Auswählen einer der beiden die gleiche Funktionalität.

    • Transaktionsisolationsstufe: Verwenden Sie ggf. das Dropdown-Menü, um die Transaktionsisolationsstufe auszuwählen. Treiberspezifische Transaktionsisolationsstufen werden nicht unterstützt. Die Option DEFAULT verwendet die Standard-Transaktionsisolationsstufe des Treibers oder Datenbankservers.

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

    • 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 unten stehende Verbindungszeichenfolgen-Option verwenden.

      Tipp

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

      Vorsicht

      Agent-Version 12.10 und später blockiert oder beschränkt standardmäßig bestimmte Parameter hier aus Sicherheitsgründen für die MySQL-, PostgreSQL-, Oracle- und SQL Server-Treiber. Auf einem privaten Agent finden Sie unter [JdbcSecurity] in der Agent-Konfigurationsdatei die eingeschränkten Parameter und wie Sie einen benötigten Parameter zulassen.

    • Verbindungszeichenfolge verwenden: Aktivieren Sie dieses Kontrollkästchen, um eine Verbindungszeichenfolge in das Feld unten einzugeben. Wenn diese Option aktiviert ist, werden die Zusätzlichen Verbindungszeichenfolgen-Parameter oben deaktiviert und überschrieben. Wenn diese Option aktiviert ist und das Feld Verbindungszeichenfolge leer gelassen wird, werden der Servername, die Anmeldung 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 datenbankspezifische Dokumentation zum Erstellen manueller Verbindungszeichenfolgen. Beispiele finden sich auch unter [https://www.connectionstrings.com](https://www.connectionstrings.com).

!!! note "Hinweis"
    Die Verbindungszeichenfolge wird während der Konfiguration im Klartext angezeigt. Daher sollten Benutzername und Passwort nicht in die Zeichenfolge aufgenommen werden. Verwenden Sie stattdessen die als Teil der Benutzeroberfläche bereitgestellten Felder **Login** und **Passwort**. Diese werden 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 bestimmte Parameter aus Sicherheitsgründen für die MySQL-, PostgreSQL-, Oracle- und SQL Server-Treiber. Auf einem privaten Agent finden Sie [`[JdbcSecurity]`](/de/agent/jitterbit-conf/#jdbcsecurity) in der Agent-Konfigurationsdatei für die eingeschränkten Parameter und wie Sie einen benötigten 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 (einfaches oder doppeltes Anführungszeichen) 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: Nachdem Sie Änderungen an einer neuen oder vorhandenen Konfiguration vorgenommen haben, 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: Nachdem Sie eine vorhandene Verbindungskonfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). 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 ihre Aktivitätstypen sind über den Projektbereich und die Designkomponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Nach dem Konfigurieren einer Datenbankverbindung können Sie eine oder mehrere Datenbankaktivitäten konfigurieren, die dieser Verbindung zugeordnet sind und entweder als Quelle zum Bereitstellen von Daten für einen Vorgang oder als Ziel zum Verarbeiten von Daten in einem Vorgang verwendet werden können. Alternativ können Sie die Datenbankverbindung in einem Skript verwenden.

Aktivitäten konfigurieren

Diese Aktivitätstypen sind verfügbar:

  • Abfrage: Fragt Daten von einem Datenbankendpunkt ab und ist für die Verwendung als Quelle in einem Vorgang oder zum Aufrufen in einem Skript vorgesehen.

  • Einfügen: Fügt neue Daten in einen Datenbankendpunkt ein und ist für die Verwendung als Ziel in einem Vorgang oder zum Aufrufen in einem Skript vorgesehen.

  • Aktualisieren: Aktualisiert vorhandene Daten in einem Datenbankendpunkt und ist für die Verwendung als Ziel in einem Vorgang oder zum Aufrufen in einem Skript vorgesehen.

  • Upsert: Aktualisiert vorhandene Daten und fügt neue Daten in einen Datenbankendpunkt ein und ist für die Verwendung als Ziel in einem Vorgang oder zum Aufrufen in einem Skript vorgesehen. (Harmony unterstützt Upsert-Aktivitäten für Datenbanken durch eine Kombination aus Abfrage, Einfügen und Aktualisieren.)

Datenbankverbindungen in Skripten verwenden

Datenbankverbindungen können in einem Skript mithilfe von Skriptfunktionen referenziert werden, die einen databaseId als Parameter verwenden:

Jitterbit Script-Funktionen

JavaScript Jitterbit-Funktionen

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