Datenbankconnector in Jitterbit Studio

Zusammenfassung

Der Datenbankconnector ermöglicht den Zugriff auf eine Datenbank über einen JDBC- oder ODBC-Treiber, der mit Jitterbit-Cloud-Agenten bereitgestellt oder auf Jitterbit-Privatagenten installiert ist.

Der Datenbankconnector bietet eine Schnittstelle zum Erstellen einer Datenbankverbindung, die die Grundlage für die Generierung von Instanzen von Datenbankaktivitäten bildet. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit der Datenbank.

Der Datenbankconnector wird über die Registerkarte Projektendpunkte und Connectoren in der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Connector-Übersicht

Dieser Connector wird zunächst verwendet, um eine Datenbankverbindung zu konfigurieren. Die mit dieser Verbindung verbundenen Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (um Daten in einem Vorgang bereitzustellen) oder Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden sollen.

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

• Abfrage: Abfragt Daten von einem Datenbankendpunkt und ist als Quelle in einem Vorgang oder in einem Skript vorgesehen.

• Einfügen: Fügt neue Daten in einen Datenbankendpunkt ein und ist als Ziel in einem Vorgang oder in einem Skript vorgesehen.

• Aktualisieren: Aktualisiert vorhandene Daten in einem Datenbankendpunkt und ist als Ziel in einem Vorgang oder in einem Skript vorgesehen.

• 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 eine Kombination aus Abfrage, Einfügen und Aktualisieren.)

Unterstützte Versionen und Einschränkungen

Unterstützte Datenbanken

Die meisten JDBC- und ODBC-kompatiblen Datenbanken werden unterstützt. Ihre 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 von häufig verwendeten JDBC-Treibern wird bereitgestellt:

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

Private Agents

Private Agents unterstützen JDBC-Treiber und ODBC-Treiber. Bei ODBC-Treibern muss die Architektur des Treibers mit dem System des Agents übereinstimmen. Das bedeutet, dass 64-Bit-Agents 64-Bit-ODBC-Treiber unterstützen.

Diese JDBC-Treiber werden von 64-Bit Windows- und Linux-Privatagenten 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 mit der Installation des 64-Bit Windows-Privatagenten gebündelt:

• PostgreSQL ANSI (x64)
• PostgreSQL Unicode (x64)

Dieser ODBC-Treiber ist mit der Installation des 64-Bit Linux-Privatagenten gebündelt:

• PostgreSQL-jitterbit

Darüber hinaus können bei Bedarf weitere Datenbanktreiber auf Privatagenten installiert werden. Für allgemeine Informationen und Anweisungen zur Installation zusätzlicher Treiber auf Privatagenten siehe Zusätzliche ODBC- oder JDBC-Treiber installieren.

Unterstützte Daten

In Datenbanken unterstützt Jitterbit keine Daten mit diesen Kodierungstypen 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 Privatagenten können TLS 1.0 oder 1.1 wieder aktiviert werden (obwohl nicht empfohlen), indem TLSv1 oder TLSv1.1 aus der Sicherheits-Eigenschaft jdk.tls.disabledAlgorithms in der java.security-Konfigurationsdatei des Privatagenten entfernt wird.

Die java.security-Konfigurationsdatei des Privatagenten befindet sich in diesen Standardverzeichnissen:

• Windows: C:\Program Files\Jitterbit Agent\jre\lib\security

• Linux: /opt/jitterbit/jre/lib/security

Sonderzeichen in Datenbanktabellen-/Spaltennamen

Wenn Sie einen Privatagenten verwenden, können Sie Zeichen angeben, die zur Definition von Trennzeichen innerhalb von Datenbanktabellen-/Spaltennamen im Konfigurationsdatei des Privatagenten unter dem Abschnitt [DbDrivers] verwendet werden.

Wenn Sie einen ODBC-Datenbanktreiber verwenden, beachten Sie, dass einige Sonderzeichen in Datenbanktabellen-/Spaltennamen vom Treiber nicht verarbeitet werden können. Beispielsweise sind Datenbankfelder, die ein At-Zeichen (@) enthalten, 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 auf der physischen Tabelle zu erstellen, die das Sonderzeichen in den Spaltennamen nicht verwendet, und stattdessen diese zu verwenden.

Fehlerbehebung und Anleitungen

Wenn Sie Probleme mit dem Datenbankconnector haben, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

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

2. Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

3. Aktivieren Sie das Debug-Protokoll für den Betrieb (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

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

5. Für zusätzliche Überlegungen zur Fehlerbehebung siehe Fehlerbehebung bei Operationen.

Die folgenden Seiten bieten zusätzliche Anleitungen zur Arbeit mit dem Datenbankconnector:

• IBM DB2

• Microsoft (Access, Excel, SQL Server)

• SQL Server Kerberos-Authentifizierung

• MySQL

• Oracle

• PostgreSQL

• Progress

• Von JDBC zu ODBC konvertieren

• Zusätzliche Treiber installieren

Zusätzliche Ressourcen

Eine Reihe von Datenbankfunktionen kann innerhalb von 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>

Für Details zur Verwendung dieser Funktionen siehe Datenbankfunktionen.