Datenbankkonnektor für Jitterbit Integration Studio

Zusammenfassung

Der Datenbankkonnektor 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.

Hinweis

Jitterbit bietet eine Reihe anwendungsspezifischer Konnektoren für häufig verwendete Datenbanken. Eine vollständige Liste finden Sie unter Konnektoren.

Der Datenbank-Connector bietet eine Schnittstelle zum Erstellen einer Datenbankverbindung, die Grundlage für die Generierung von Instanzen von Datenbankaktivitäten. Diese Aktivitäten interagieren nach der Konfiguration über die Verbindung mit der Datenbank.

Der Zugriff auf den Datenbank-Konnektor erfolgt über die Tab Endpoints und Konnektoren der Design-Komponentenpalette (siehe Design-Komponentenpalette).

Connector-Übersicht

Mit diesem Connector wird zunächst eine Datenbankverbindung konfiguriert. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (zum Bereitstellen von Daten in einem Operation) oder Ziele (zum Verbrauchen von Daten in einem Operation) dienen sollen.

Zusammen werden eine bestimmte Datenbankverbindung und ihre Aktivitäten als Endpoint bezeichnet:

Datenbankaktivitätstypen

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 ist zur Verwendung als Ziel in einer Operation oder zum Aufruf in einem Script vorgesehen.
Aktualisieren: Aktualisiert vorhandene Daten in einem Endpoint und ist zur Verwendung als Ziel in einer Operation oder zum Aufruf in einem Script vorgesehen.
Upsert: Aktualisiert vorhandene Daten und fügt neue Daten in einen Endpoint ein und ist zur Verwendung als Ziel in einer Operation oder zum Aufruf in einem Script vorgesehen. (Harmony unterstützt Upsert-Aktivitäten für Datenbanken durch eine Kombination aus Abfrage, Einfügen und Aktualisieren.)

Tipp

Da keine Datenbanklöschaktivität vorhanden ist, verwenden Sie zum Löschen von Daten aus einer Datenbankverbindung die DBExecute Funktion in einem Jitterbit Script durch Angabe des SQL-Befehls, der für die Datenbank ausgeführt werden soll.

Notiz

Dieser Konnektor ist ein nativer Integration Studio Konnektor, auf den Jitterbit bei der Kommunikation von Änderungen an Konnektoren verweisen kann. Der Release-Zeitplan für native Integration Studio Konnektoren basiert auf der Kadenz von Harmony-Portal-Webanwendungen.

Unterstützte Versionen und Einschränkungen

Unterstützte Datenbanken

Die meisten JDBC- und ODBC-kompatiblen Datenbanken werden unterstützt. Agent Ihrer Wahl wirkt sich auch darauf aus, welchen Driver Sie verwenden können, da Cloud-Agenten unterstützen nur JDBC-Treiber, während private Agenten unterstützen sowohl ODBC- als auch JDBC-Treiber.

Cloud-Agenten

Cloud-Agent-Gruppen unterstützen nur JDBC-Treiber. Es wird eine Reihe häufig verwendeter JDBC-Treiber bereitgestellt:

Amazon Redshift - IBM DB2 (AS400) - MySQL - Oracle (JDBC 19.7) - Oracle NetSuite - PostgreSQL - SQL Server jTDS - SQL Server MS JDBC - Sybase jTDS

Private Agenten

Private Agenten unterstützen JDBC- und ODBC-Treiber. Bei ODBC-Treibern muss die Architektur des Driver mit dem System des Agenten übereinstimmen. Das heißt, 64-Bit-Agenten unterstützen 64-Bit-ODBC-Treiber.

Diese JDBC-Treiber werden von privaten 64-Bit-Windows und Linux Agenten bereitgestellt:

Amazon Redshift - IBM DB2 (AS400) - IBM DB2 (JCC) - MySQL - Oracle (JDBC 19.7) - Oracle NetSuite - PostgreSQL - SQL Server jTDS - SQL Server Microsoft - SQLite - Sybase jTDS

Diese ODBC-Treiber sind im Lieferumfang der privaten 64-Bit-Windows Agenteninstallation enthalten:

PostgreSQL ANSI (x64)
PostgreSQL Unicode (x64)

Dieser ODBC Driver ist im Lieferumfang der privaten 64-Bit Linux Agenteninstallation enthalten:

PostgreSQL-jitterbit

Darüber hinaus können Sie bei Bedarf weitere Datenbanktreiber auf privaten Agenten installieren. Allgemeine Informationen und Anweisungen zur Installation zusätzlicher Treiber auf privaten Agenten finden Sie unter Installieren zusätzlicher ODBC- oder JDBC-Treiber.

Unterstützte Daten

In Datenbanken unterstützt Jitterbit keine Daten mit folgenden Kodierungstypen oder Objektnamen:

Binärdaten
Unicode/UTF-Daten
Tabellen oder Ansichten mit Leerzeichen im Namen

Unterstützte TLS-Versionen

Transport Layer Security (TLS) 1.3 und 1.2 werden für JDBC- Endpoints unterstützt.

Auf privaten Agenten kann TLS 1.0 oder 1.1 wieder aktiviert werden (obwohl dies nicht empfohlen wird), indem TLSv1 oder TLSv1.1 aus dem jdk.tls.disabledAlgorithms Sicherheitseigentum im privaten Agenten java.security Konfigurationsdatei.

Der private Agent java.security Die Konfigurationsdatei befindet sich in diesen Standardverzeichnissen:

Windows: C:\Program Files\Jitterbit Agent\jre\lib\security
Linux: /opt/jitterbit/jre/lib/security

Sonderzeichen in Datenbanktabellen-/Spaltennamen

Bei Verwendung eines privaten Agenten, können Sie Zeichen angeben, die zum Definieren von Trennzeichen in Datenbanktabellen-/Spaltennamen innerhalb der privaten Agentenkonfigurationsdatei verwendet werden unter dem [DbDrivers] Abschnitt.

Wenn Sie einen ODBC- Driver verwenden, beachten Sie, dass einige Sonderzeichen in Datenbanktabellen-/Spaltennamen vom Driver nicht verarbeitet werden können. Beispielsweise Datenbankfelder, die ein at-Zeichen (@) entsprechen nicht den SQL-basierten Spezifikationen und werden möglicherweise nicht unterstützt. Falls die Datenbank solche Sonderzeichen in Tabellen-/Spaltennamen verwendet, empfehlen wir als Workaround, eine Ansicht der physischen Tabelle zu erstellen, die das Sonderzeichen in Spaltennamen nicht verwendet, und stattdessen diese zu verwenden.

Fehlerbehebung und Anleitungen

Bei Problemen mit dem Datenbank-Connector empfehlen wir folgende Schritte zur Fehlerbehebung:

Stellen Sie sicher, dass die Datenbankverbindung erfolgreich ist, können Sie mit der Schaltfläche Test im Konfigurationsbildschirm überprüfen. Wenn die Verbindung nicht erfolgreich ist, kann der zurückgegebene Fehler Hinweise auf das Problem geben.
Überprüfen Sie die Operation für alle Informationen, die während der Ausführung der Operation geschrieben werden.
Aktivieren Sie die debuggen Protokollierung für Operation (für Cloud-Agenten oder für private Vertreter), um zusätzliche Protokolldateien und Daten zu generieren.
Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle überprüfen für weitere Informationen.
Weitere Hinweise zur Fehlerbehebung finden Sie unter Fehlerbehebung im Betrieb.

Darüber hinaus bieten die folgenden Seiten detaillierte Anweisungen zum Durchführen bestimmter Aufgaben mit Integrationsprojekten, die den Datenbank-Connector verwenden:

Zusätzliche Ressourcen

Eine Reihe von Datenbankfunktionen können innerhalb von Scripts verwendet werden um Zugriff auf grundlegende Datenbankinteraktionen zu ermöglichen, darunter:

CacheLookup
CallStoredProcedure
DBCloseConnection
DBExecute
DBLoad
DBLookup
DBLookupAll
DBRollbackTransaction
DBWrite
SetDBInsert
SetDBUpdate
SQLEscape
Unmap
<SEQUENCE>
<SQLIDENTITY>
<UDF>

Weitere Informationen zur Verwendung dieser Funktionen finden Sie unter Datenbankfunktionen.