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.

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 verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) verwendet werden sollen.

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

• 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.)

Dieser Connector kann mit Cloud Agents und Private Agents verwendet werden.

Dieser Connector ist ein nativer Connector: Seine Updates werden mit der Studio-Anwendung oder dem Agent veröffentlicht und nicht separat. Siehe Studio Connector-Updates.

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-kompatiblen 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. Ein Satz 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 Agenten entsprechen. Das heißt, 64-Bit-Agenten 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 Installation des 64-Bit-Windows-Private-Agents enthalten:

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

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

• PostgreSQL-jitterbit

Darüber hinaus können Sie bei 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 Konfigurationsdatei java.security des Private Agents entfernt werden.

Die Konfigurationsdatei java.security des Private Agents 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 Agents können Sie Zeichen angeben, die zur Definition von Trennzeichen in Datenbanktabellen-/Spaltennamen verwendet werden, in der Konfigurationsdatei des Private Agents 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 Schritte zur Fehlerbehebung empfohlen:

1. 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.

2. Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.

3. Aktivieren Sie das Debug-Protokollieren von Operationen (für Cloud Agents oder für Private Agents), um zusätzliche Protokolldateien und Daten zu generieren.

4. Bei Verwendung von Private Agents können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

5. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.

6. Informationen zu Problemen und Lösungen, die speziell für den Database Connector gelten, finden Sie im Leitfaden Connector-Fehlerbehebung:

   • Database (JDBC): DBLookup oder DBExecute schlägt mit einem Base64-Decodierungsfehler fehl
   • Database (ODBC): Mehrbyte-Zeichen werden nicht korrekt verarbeitet
   • Database: Verbindung durch Sicherheitsrichtlinie blockiert
   • Database: Verbindungszeitüberschreitungen unter Last
   • Database: Feldlängenfehler bei Insert, Update oder Upsert
   • Database: JDBC-Treiber-JAR wird bei Agent-Upgrades überschrieben
   • Database: Sonderzeichen in Spaltennamen verursachen Abfragefehler
   • Database: SQL-Anweisung überschreitet das Limit von 2.000 Zeichen
   • IBM DB2 on iSeries: JDBC-Verbindung schlägt fehl
   • IBM DB2: JCC JDBC-Treiber-Setup (veraltete JAR- und Lizenzdatei)
   • Kerberos: „Could not initialize class KerbAuthentication"
   • Kerberos: JGSS- oder GSS-Fehler während des Verbindungstests
   • Microsoft Excel: „Operation must use an updateable query"
   • MySQL: Zugriff verweigert trotz korrekter Anmeldedaten
   • MySQL: Enable Batch verbessert die Insert- oder Update-Leistung nicht
   • MySQL: ODBC-Treiber nicht in Studio-Dropdown aufgelistet
   • PostgreSQL: Client-Codierungskonfliktfehler
   • PostgreSQL: Verwenden Sie den von Jitterbit bereitgestellten Treiber unter Linux
   • Snowflake: Operationen schlagen auf Agent 12.x fehl
   • SQL Server JDBC: Windows-integrierte Authentifizierung schlägt fehl
   • SQL Server Windows-Authentifizierung: Unzureichende Berechtigungen
   • SQL Server: „Cannot insert explicit value for identity column" beim Einfügen in eine Identity-Spalte
   • SQL Server: Verbindung schlägt mit einem PKIX-Zertifikatpfadfehler fehl

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

• 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 können in Skripten verwendet werden, um Zugriff auf grundlegende Datenbankinteraktionen zu bieten, 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.