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 werden alle Elemente der Benutzeroberfläche des Konfigurationsbildschirms für Datenbankverbindungen 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 (weitere Informationen finden Sie unter Datenbanktreiber auf Jitterbit Private Agents).

  • 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 relevanten 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 finden Sie unter [JdbcSecurity] in der Agent-Konfigurationsdatei Informationen zum Zulassen einer Datenbank, die auf demselben Host wie der Agent ausgeführt wird.

  • 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: Lassen Sie dieses Kontrollkästchen aktiviert, 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 an 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ür den MySQL JDBC-Treiber fügen Sie auch rewriteBatchedStatements=true zu Zusätzliche Verbindungsstringparameter 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 Standard beträgt 300 Sekunden (5 Minuten).

      Tipp

      Dieses Limit gilt auch, wenn das Connection Pooling von Agent-Version 12.11 und später eine neue physische Verbindung erstellt. Auf einem privaten Agent finden Sie [SourceTargetPooling] in der Agent-Konfigurationsdatei. Pooling fügt eine separate jdbc.hikari.connectionTimeout-Einstellung hinzu, die angibt, 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 Verbindungsstringparameter: Geben Sie hier alle zusätzlichen Parameter für die Datenbankverbindungszeichenfolge ein. Dieses Feld ist deaktiviert, wenn Sie die unten beschriebene Verbindungszeichenfolge verwenden.

      Tipp

      Bei Verwendung von SQL Server MS JDBC (Microsofts JDBC-Treiber für SQL Server) geben Sie 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 [JdbcSecurity] in der Agent-Konfigurationsdatei für die eingeschränkten Parameter und wie Sie einen aktivieren, den Sie benötigen.

  • Verbindungszeichenfolge verwenden: Aktivieren Sie dieses Kontrollkästchen, um eine Verbindungszeichenfolge in das Feld unten einzugeben. Wenn diese Option aktiviert ist, werden die Zusätzlichen Parameter für Verbindungszeichenfolgen oben deaktiviert und außer Kraft gesetzt. Wenn diese Option aktiviert ist und das Feld Verbindungszeichenfolge leer bleibt, werden die oben konfigurierten Werte für Servername, Anmeldung und Kennwort 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 den Benutzernamen und das Kennwort nicht in die Zeichenfolge aufnehmen. Verwenden Sie stattdessen die als Teil der Benutzeroberfläche bereitgestellten Felder **Anmeldung** und **Kennwort**. Diese 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 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 identifiziert, entweder ein einfaches oder ein doppeltes Anführungszeichen. Wenn Sie die Verbindung zu diesem Zeitpunkt nicht testen, werden die Informationen zu öffnenden und schließenden Anführungszeichen abgerufen, wenn Sie eine Aktivität konfigurieren.

  • 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 der Konfiguration 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 sowohl vorhandene Daten als auch 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 von Abfrage, Einfügen und Aktualisieren.)

Datenbankverbindungen in Skripten verwenden

Man kann Datenbankverbindungen in einem Skript mithilfe von Skriptfunktionen referenzieren, 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.