Zum Inhalt springen

Verwandeln Sie Ihre Kontakte in Urlaubsgeld mit unserem neuen Kundenempfehlungsprogramm! Erfahren Sie mehr

✕

Datenbankverbindung

Einführung

Eine Datenbankverbindung, die mit dem Datenbank-Connector erstellt wurde, stellt den Zugriff auf eine Datenbank über einen JDBC- oder ODBC- Driver her, der mit Jitterbit-Cloud-Agenten bereitgestellt oder auf privaten Jitterbit-Agenten installiert wird. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von Datenbankaktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Hinweis

Dieser Connector unterstützt die Organisationsrichtlinie Erneute Authentifizierung bei Änderung aktivieren. Wenn diese Option aktiviert ist, müssen Benutzer bei einer Änderung des Servernamens oder Anmeldenamens in der Verbindung eines Endpunkts das Passwort für die Verbindung erneut eingeben.

Erstellen oder Bearbeiten einer Datenbankverbindung

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

Eine bestehende Datenbankverbindung kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Datenbankverbindung

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

Konfiguration der Datenbankverbindung

Tipp

Felder mit einem Unterstützung variabler Symbole durch globale Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Verbindungsname: 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.

  • Treibertyp: Um die Liste der Treiber zu filtern, wählen Sie die Schaltfläche für den entsprechenden Driver. Cloud-Agenten unterstützen nur eine begrenzte Anzahl von JDBC-Treibern, während private Agenten unterstützen sowohl ODBC- als auch JDBC-Treiber und Sie können zusätzliche Treiber installieren (siehe Datenbanktreiber auf privaten Jitterbit-Agenten für weitere Informationen).

  • Treiber: Wählen Sie aus der Liste den Driver aus. Die verfügbaren Treiber hängen davon ab, ob Sie Cloud-Agenten oder private Agenten verwenden (siehe Datenbanktreiber). Wenn Sie einen Driver auswählen, können sich die übrigen in diesem Konfigurationsbildschirm verfügbaren Felder ändern, da nur die für den ausgewählten Driver 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 zutrifft, 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 Driver 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:

    Optionale Einstellungen für Datenbankverbindung

    • Für Massendaten optimieren: Nur verfügbar, wenn entweder der Oracle oder SQL Server jTDS- Driver 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 Driver 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- Driver verwenden, teilt dies dem Driver 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.

Nächste Schritte

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Nachdem Sie eine Datenbankverbindung konfiguriert haben, können Sie eine oder mehrere mit dieser Verbindung verknüpfte Datenbankaktivitäten konfigurieren, die entweder als Quelle zum Bereitstellen von Daten für einen Operation oder als Ziel zum Verbrauchen von Daten in einem Operation verwendet werden sollen. Alternativ können Sie die Datenbankverbindung in einem Script verwenden.

Konfigurieren von Aktivitäten

Die folgenden Aktivitätstypen sind verfügbar:

  • 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

JavaScript Jitterbit-Funktionen

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