Zum Inhalt springen

Datenbank-Connector für Jitterbit Integration Studio

Zusammenfassung

Der Datenbank-Connector 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 zum Generieren von Instanzen von Datenbankaktivitäten. Diese Aktivitäten interagieren nach der Konfiguration über die Verbindung mit der Datenbank.

Der Datenbank-Konnektor wird über die Registerkarte Endpoints und Tab der Design-Komponentenpalette aufgerufen (siehe Design-Komponentenpalette).

Connector-Übersicht

Mit diesem Connector wird zunächst eine Datenbankverbindung konfiguriert. Mit dieser Verbindung verknüpfte 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) verwendet werden sollen.

Eine bestimmte Datenbankverbindung und ihre Aktivitäten werden zusammen 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 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.)

Tipp

Da es keine Datenbanklöschaktivität gibt, 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.

Hinweis

Dieser Connector ist ein nativer Integration Studio Connector, auf den Jitterbit verweisen kann, wenn Änderungen an Connectoren kommuniziert werden. Der Release-Zeitplan für native Integration Studio Connectors basiert auf der Kadenz der Harmony Portal-Webanwendungen.

Unterstützte Versionen und Einschränkungen

Unterstützte Datenbanken

Die meisten JDBC- und ODBC-kompatiblen Datenbanken werden unterstützt. Ihr Agent 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-Treiber 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

Die folgenden 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 64-Bit Linux Privatagent-Installation 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 diesen Kodierungstypen oder Objektnamen:

  • Binäre Daten
  • 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- 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 zur Definition von Trennzeichen in Datenbanktabellen-/Spaltennamen in 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 können Datenbankfelder, die ein At-Zeichen (@) sind nicht mit SQL-basierten Spezifikationen kompatibel und werden möglicherweise nicht unterstützt. Wenn die Datenbank solche Sonderzeichen in Tabellen-/Spaltennamen verwendet, empfehlen wir als Workaround, eine Ansicht für die physische Tabelle zu erstellen, die das Sonderzeichen nicht in Spaltennamen verwendet, und stattdessen diese zu verwenden.

Fehlerbehebung und Anleitungen

Wenn Sie Probleme mit dem Datenbank-Connector haben, werden diese Schritte zur Fehlerbehebung empfohlen:

  1. Stellen Sie sicher, dass die Datenbankverbindung erfolgreich ist, indem Sie im Konfigurationsbildschirm auf die Schaltfläche Test klicken. Wenn die Verbindung nicht erfolgreich ist, kann der zurückgegebene Fehler einen Hinweis auf das Problem geben.

  2. Überprüfen Sie die Operation für alle Informationen, die während der Ausführung der Operation geschrieben werden.

  3. Aktivieren Sie die debuggen für Operation (für Cloud-Agenten oder für private Vertreter), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle überprüfen für weitere Informationen.

  5. Weitere Hinweise zur Fehlerbehebung finden Sie unter Fehlerbehebung beim Betrieb.

Darüber hinaus enthalten 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 in Scripts verwendet werden, um Zugriff auf grundlegende Datenbankinteraktionen zu ermöglichen, darunter diese:

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

Einzelheiten zur Verwendung dieser Funktionen finden Sie unter Datenbankfunktionen.