Datenbank-Connector in Jitterbit Studio

Zusammenfassung

Der Datenbank-Connector stellt den Zugriff auf eine Datenbank über einen JDBC- oder ODBC-Treiber bereit, der mit Jitterbit Cloud Agents mitgeliefert oder auf Jitterbit Private Agents installiert wird.

Hinweis

Jitterbit bietet eine Reihe von anwendungsspezifischen Connectoren für häufig verwendete Datenbanken. Eine vollständige Liste finden Sie unter Connectors.

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

Der Datenbank-Connector wird über die Registerkarte Projektendpunkte und Connectors der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer Datenbankverbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann zum Erstellen von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) dienen sollen.

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

Datenbankaktivitätstypen

Query: Fragt Daten von einem Datenbankendpunkt ab und ist zur Verwendung als Quelle in einem Vorgang oder zum Aufrufen in einem Skript vorgesehen.
Insert: Fügt neue Daten in einen Datenbankendpunkt ein und ist zur Verwendung als Ziel in einem Vorgang oder zum Aufrufen in einem Skript vorgesehen.
Update: Aktualisiert vorhandene Daten in einem Datenbankendpunkt und ist zur 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 zur 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 Query, Insert und Update.)

Tipp

Da es keine Datenbankaktivität zum Löschen gibt, verwenden Sie zum Löschen von Daten aus einer Datenbankverbindung die Funktion DBExecute in einem Jitterbit Script, indem Sie den SQL-Befehl angeben, der für die Datenbank ausgeführt werden soll.

Hinweis

Dieser Connector ist ein nativer Studio-Connector, auf den Jitterbit bei der Kommunikation von Änderungen an Connectoren verweisen kann. Der Veröffentlichungsplan für native Studio-Connectors basiert auf dem Rhythmus der Harmony Portal-Webanwendungen.

Endpunkte, die mit diesem Connector erstellt werden, sind in der Endpunkt-Nutzungsberichterstellung enthalten und werden auf Ihre Lizenz angerechnet.

Unterstützte Versionen und Einschränkungen

Unterstützte Datenbanken

Die meisten JDBC- und ODBC-konformen Datenbanken werden unterstützt. Die Wahl des Agents beeinflusst auch, welchen Treibertyp Sie verwenden können, da Cloud Agents nur JDBC-Treiber unterstützen, während Private Agents sowohl ODBC- als auch JDBC-Treiber unterstützen.

Cloud Agents

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

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

Private Agents

Private Agents unterstützen JDBC-Treiber und ODBC-Treiber. Bei ODBC-Treibern muss die Architektur des Treibers dem System des Agents entsprechen. Das heißt, 64-Bit-Agents unterstützen 64-Bit-ODBC-Treiber.

Diese JDBC-Treiber werden von 64-Bit-Windows- und Linux-Private-Agents bereitgestellt:

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

Diese ODBC-Treiber sind in der 64-Bit-Windows-Private-Agent-Installation enthalten:

PostgreSQL ANSI (x64)
PostgreSQL Unicode (x64)

Dieser ODBC-Treiber ist in der 64-Bit-Linux-Private-Agent-Installation enthalten:

PostgreSQL-jitterbit

Darüber hinaus können Sie nach Bedarf weitere Datenbanktreiber auf Private Agents installieren. Allgemeine Informationen und Anweisungen zur Installation zusätzlicher Treiber auf Private Agents finden Sie unter Zusätzliche ODBC- oder JDBC-Treiber installieren.

Unterstützte Daten

In Datenbanken unterstützt Jitterbit keine Daten mit diesen Codierungstypen oder Objektnamen:

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

Unterstützte TLS-Versionen

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

Auf Private Agents können TLS 1.0 oder 1.1 erneut aktiviert werden (obwohl nicht empfohlen), indem TLSv1 oder TLSv1.1 aus der Sicherheitseigenschaft jdk.tls.disabledAlgorithms in der Private-Agent-Konfigurationsdatei java.security entfernt werden.

Die Private-Agent-Konfigurationsdatei java.security 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 Private Agent können Sie Zeichen angeben, die zur Definition von Trennzeichen in Datenbanktabellen-/Spaltennamen verwendet werden, in der Private-Agent-Konfigurationsdatei im Abschnitt [DbDrivers].

Bei Verwendung eines ODBC-Datenbanktreibers ist zu beachten, dass einige Sonderzeichen in Datenbanktabellen-/Spaltennamen vom Treiber nicht verarbeitet werden können. Beispielsweise sind Datenbankfelder mit einem At-Zeichen (@) nicht konform mit SQL-basierten Spezifikationen und werden möglicherweise nicht unterstützt. Wenn die Datenbank solche Sonderzeichen in Tabellen-/Spaltennamen verwendet, empfehlen wir als Workaround, eine Ansicht der physischen Tabelle zu erstellen, die das Sonderzeichen nicht in Spaltennamen verwendet, und diese stattdessen zu verwenden.

Fehlerbehebung und Anleitungen

Wenn Probleme mit dem Database-Connector auftreten, werden diese Fehlerbehebungsschritte empfohlen:

Stellen Sie sicher, dass die Datenbankverbindung erfolgreich ist, indem Sie die Schaltfläche Test im Konfigurationsbildschirm verwenden. Wenn die Verbindung nicht erfolgreich ist, kann der zurückgegebene Fehler einen Hinweis auf das Problem geben.
Überprüfen Sie die Operationsprotokolle auf alle Informationen, die während der Ausführung der Operation geschrieben wurden.
Aktivieren Sie das Debug-Protokollieren von Operationen (für Cloud Agents oder für Private Agents), um zusätzliche Protokolldateien und Daten zu generieren.
Bei Verwendung von Private Agents können Sie die Agent-Protokolle auf weitere Informationen überprüfen.
Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.
Informationen zu Problemen und Lösungen, die speziell für den Database-Connector gelten, finden Sie im Leitfaden Connector-Fehlerbehebung:

Die folgenden Seiten enthalten zusätzliche Anweisungen für die Arbeit mit dem Database-Connector:

Zusätzliche Ressourcen

Eine Reihe von Datenbankfunktionen können in Skripten verwendet werden, um Zugriff auf grundlegende Datenbankinteraktionen zu ermöglichen, einschließlich dieser:

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.