Zum Inhalt springen

Datenbankverbindung

Einführung

Eine Datenbankverbindung, die mit dem Datenbank-Connector erstellt wurde, ermöglicht den Zugriff auf eine Datenbank über einen JDBC- oder ODBC-Treiber, der mit Jitterbit-Cloud-Agenten bereitgestellt oder auf Jitterbit-Privat-Agenten installiert ist. Sobald eine Verbindung konfiguriert ist, können Instanzen von Datenbankaktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Hinweis

Dieser Connector unterstützt die Re-Authentifizierung bei Änderung Organisationsrichtlinie. Wenn aktiviert, erfordert eine Änderung des Servernamens oder Logins in der Verbindung eines Endpunkts, dass die Benutzer das Passwort für die Verbindung erneut eingeben.

Erstellen oder Bearbeiten einer Datenbankverbindung

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

Eine vorhandene Datenbankverbindung kann von diesen Standorten aus bearbeitet werden:

Konfigurieren einer Datenbankverbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Datenbankverbindung wird im Folgenden beschrieben.

Tipp

Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Symbol für Variablen klicken, um ein Menü mit vorhandenen Variablen anzuzeigen, aus dem 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 verwendet, um den Datenbankendpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.

  • Treiberart: Um die Liste der Treiber zu filtern, wählen Sie die Schaltfläche für die entsprechende Treiberart aus. Cloud-Agenten unterstützen nur eine begrenzte Anzahl von JDBC-Treibern, während private Agenten sowohl ODBC- als auch JDBC-Treiber unterstützen und Sie zusätzliche Treiber installieren können (siehe Datenbanktreiber auf Jitterbit-privaten Agenten 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-Agenten oder private Agenten verwenden (siehe Datenbanktreiber). Wenn Sie einen Datenbanktreiber auswählen, können sich die verbleibenden Felder auf diesem Konfigurationsbildschirm ändern, da nur die Felder angezeigt werden, die für den ausgewählten Datenbanktreiber relevant sind.

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

  • Datenbankname: Geben Sie gegebenenfalls den Namen der Datenbank ein. Dieses Feld ist möglicherweise nicht vorhanden für Datenbanktreiber, für die dieses Feld nicht zutrifft, wie z. B. Oracle.

  • Login und Passwort: Geben Sie, falls zutreffend, 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 variiert 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 verfügbar, wenn ein JDBC-Treiber verwendet wird. Aktivieren Sie dieses Kontrollkästchen, um die Leistung bei der Arbeit mit großen Datenmengen in Insert oder Update Aktivitäten zu verbessern. Wenn die Einstellungen Batch aktivieren und Für große Daten optimieren beide sichtbar sind, aktiviert die Auswahl einer von beiden die gleiche Funktionalität.

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

    • Transaktionsisolationsstufe: Wählen Sie, falls zutreffend, im Dropdown-Menü die Transaktionsisolationsstufe. Treiberspezifische Transaktionsisolationsstufen werden nicht unterstützt. Die Option DEFAULT verwendet die standardmäßige Transaktionsisolationsstufe des Treibers oder des Datenbankservers.

    • Timeout (Sekunden): Um eine Grenze festzulegen, wie lange auf eine erfolgreiche Verbindung zur Datenbank gewartet werden soll, geben Sie hier eine Anzahl von Sekunden ein. Der Standardwert beträgt 300 Sekunden (5 Minuten).

    • Fetch-Größe: Wenn ein JDBC-Treiber verwendet wird, gibt dies dem Treiber an, wie viele Zeilen abgerufen werden sollen, wenn mehr Zeilen benötigt werden. Dies kann verwendet werden, um die Verarbeitung großer Datensätze zu verbessern.

    • Zusätzliche Verbindungszeichenfolgenparameter: Geben Sie hier zusätzliche Parameter für die Verbindungszeichenfolge zur Datenbank ein. Dieses Feld ist deaktiviert, wenn die untenstehende Verbindungszeichenfolgenoption verwendet wird.

      Tipp

      Für die Microsoft Entra-Authentifizierung bei Verwendung von SQL Server Microsoft geben Sie authentication=ActiveDirectoryPassword in dieses Feld ein.

    • Verbindungszeichenfolge verwenden: Wählen Sie dieses Kontrollkästchen aus, um eine Verbindungszeichenfolge im untenstehenden Feld einzugeben. Wenn ausgewählt, werden die oben genannten Zusätzlichen Verbindungszeichenfolgenparameter deaktiviert und überschrieben. Wenn ausgewählt und das Feld Verbindungszeichenfolge leer gelassen wird, werden die oben konfigurierten Servername, Anmeldung und Passwort verwendet.

    • Verbindungszeichenfolge: Geben Sie gegebenenfalls eine Verbindungszeichenfolge in das Textfeld ein. Das obenstehende Kontrollkästchen muss ausgewählt sein, damit dieses Feld aktiviert wird.

      Tipp

      Konsultieren Sie die spezifische Dokumentation zur Datenbank für die Erstellung manueller Verbindungszeichenfolgen. Beispiele finden Sie auch unter https://www.connectionstrings.com.

      Hinweis

      Die Verbindungszeichenfolge wird während der Konfiguration im Klartext angezeigt, sodass Sie möglicherweise den Benutzernamen und das Passwort nicht in der Zeichenfolge einfügen möchten. Anstelle der Einbeziehung dieser Parameter und Werte in die Zeichenfolge verwenden Sie die bereitgestellten Felder Anmeldung und Passwort als Teil der Benutzeroberfläche. Diese werden dann bei Bedarf an die Verbindungszeichenfolge angehängt, sind jedoch nicht auf dem Bildschirm sichtbar.

  • Test: Klicken Sie, 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 zu den öffnenden und schließenden Anführungszeichen abgerufen, wenn Sie eine Aktivität konfigurieren.

  • Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

  • Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration 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 Nachricht fragt Sie, ob Sie die Verbindung wirklich löschen möchten.

Nächste Schritte

Menüaktionen für eine Verbindung und deren Aktivitätstypen sind im Projektbereich und in der Design-Komponentenpalette verfügbar. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Nachdem Sie eine Datenbankverbindung konfiguriert haben, können Sie eine oder mehrere Datenbankaktivitäten konfigurieren, die mit dieser Verbindung verknüpft sind, um sie entweder als Quelle zur Bereitstellung von Daten für eine Operation oder als Ziel zum Konsumieren von Daten in einer Operation zu verwenden, oder Sie können die Datenbankverbindung in einem Skript verwenden.

Aktivitäten konfigurieren

Diese Aktivitätstypen sind verfügbar:

  • Abfrage: Abfragen von Daten aus einem Datenbank-Endpunkt und ist dafür gedacht, als Quelle in einer Operation verwendet oder in einem Skript aufgerufen zu werden.

  • Einfügen: Fügt neue Daten in einen Datenbank-Endpunkt ein und ist dafür gedacht, als Ziel in einer Operation verwendet oder in einem Skript aufgerufen zu werden.

  • Aktualisieren: Aktualisiert vorhandene Daten in einem Datenbank-Endpunkt und ist dafür gedacht, als Ziel in einer Operation verwendet oder in einem Skript aufgerufen zu werden.

  • Upsert: Aktualisiert sowohl vorhandene Daten als auch fügt neue Daten in einen Datenbank-Endpunkt ein und ist dafür gedacht, als Ziel in einer Operation verwendet oder in einem Skript aufgerufen zu werden. (Harmony unterstützt Upsert-Aktivitäten für Datenbanken durch die Verwendung einer Kombination aus Abfrage, Einfügen und Aktualisieren.)

Datenbankverbindungen in Skripten verwenden

Datenbankverbindungen können in einem Skript unter Verwendung von Skriptfunktionen referenziert werden, die eine databaseId als Parameter verwenden:

Jitterbit Skriptfunktionen

JavaScript Jitterbit-Funktionen

Für weitere Details zur Referenzierung von Endpunkten in Skripten siehe Endpunkte in Jitterbit Script oder Endpunkte in JavaScript.