Konfigurieren eines Microsoft SQL-Datenbankziels in Jitterbit Design Studio

Diese Seite beschreibt, wie man Microsoft SQL Server als Quelle oder Ziel in Jitterbit Studio mit Windows- oder SQL Server-Authentifizierung konfiguriert. Weitere Informationen zu den unterstützten Authentifizierungstypen für verschiedene Systeme finden Sie unter Database.

Windows-Authentifizierung

Die Windows-Authentifizierung wird über ODBC und JDBC nur auf privaten Agents unterstützt und kann nur mit einem Domänenkonto verwendet werden. Richten Sie diese Eigenschaften unter Windows ein, um Windows-Authentifizierung zu verwenden:

1. Öffnen Sie das Tool Services Administrative (Start > Administrative Tools > Services).
2. Bei Verwendung von ODBC klicken Sie mit der rechten Maustaste auf den Dienst Jitterbit Apache Server und wählen Sie Properties aus. Bei Verwendung von JDBC klicken Sie mit der rechten Maustaste auf den Dienst Jitterbit Tomcat Server und wählen Sie Properties aus.
3. Gehen Sie zur Registerkarte Log On. Wählen Sie This account aus und geben Sie den Namen und die Anmeldedaten des Kontos ein, das Sie für die Authentifizierung verwenden möchten. Klicken Sie dann auf Apply.
4. Wiederholen Sie den Vorgang für den Dienst Jitterbit Process Engine.
5. Legen Sie TempDir in der Agent-Konfigurationsdatei (jitterbit.conf) auf C:\Windows\Temp\jitterbit fest.
6. Starten Sie Jitterbit-Services neu.

Nachdem die obigen Schritte abgeschlossen sind, gehen Sie zu Jitterbit Studio und richten Sie Ihre Quelle oder Ihr Ziel wie gewohnt ein. Geben Sie im Definitionsbildschirm der Datenbankquelle/-ziel unter Connection Parameters Folgendes an:

• Driver Type: Wählen Sie ODBC oder JDBC nach Bedarf aus.

  Wichtig

  Die Windows-Authentifizierung wird mit den folgenden JDBC-Treibern unterstützt:

  • SQL Server jTDS [JDBC]
  • SQL Server MS JDBC [JDBC]
  • Neuere Versionen des Microsoft JDBC Driver for SQL Server

  Um die Windows-Authentifizierung mit einem JDBC-Treiber zu verwenden, kopieren Sie je nach ausgewähltem Treiber eine DLL-Datei auf den Agent:

  • SQL Server jTDS: Kopieren Sie die Datei ntlmauth.dll aus dem Ordner x64/SSO des jTDS-Projektdownloadpakets in den Ordner C:\Program Files\Jitterbit Agent\jre\bin auf dem Agent.

  • SQL Server MS JDBC oder ein neuerer Microsoft JDBC Driver for SQL Server: Kopieren Sie die Datei mssql-jdbc_auth-x.x.x.x64.dll aus dem Downloadpaket des Treibers in die Ordner C:\Program Files\Jitterbit Agent\jre\bin und C:\Program Files\Jitterbit Agent\jre\lib auf dem Agent. Die DLL-Version muss mit der Version der JDBC-JAR-Datei übereinstimmen, die mit dem Agent gebündelt ist. Erstellen Sie eine Sicherungskopie der Datei, da sie bei größeren Agent-Upgrades möglicherweise gelöscht wird.

• Server Name: Geben Sie den Namen oder die IP-Adresse des Servers ein, auf dem der SQL Server ausgeführt wird, zu dem Jitterbit eine Verbindung herstellen muss. Sie müssen möglicherweise den Namen der SQL Server-Instanz angeben (HostName\InstanceName).

• Database Name: Geben Sie den Namen der Datenbank auf dem Server ein, in die Jitterbit integriert werden muss.
• Login: Lassen Sie dieses Feld leer.
• Password: Lassen Sie dieses Feld leer.

• Options: Klicken Sie, um zusätzliche Einstellungen zu erweitern. Geben Sie im Feld Additional Connection String Parameters je nach Treiber Folgendes ein:

• SQL Server [ODBC]: Bei Verwendung des Treibers "SQL Server [ODBC]" geben Sie integratedSecurity=true ein. Falls dies nicht funktioniert, geben Sie Trusted_Connection=yes ein.

• ODBC Driver 11 for SQL Server [ODBC], SQL Server Native Client 10.0 [ODBC], SQL Server Native Client 11.0 [ODBC]: Bei Verwendung eines anderen SQL Server-Treibers geben Sie Trusted_Connection=yes ein.
• SQL Server jTDS [JDBC]: Geben Sie integratedSecurity=true ein.
• SQL Server MS JDBC [JDBC]: Geben Sie integratedSecurity=true;trustServerCertificate=true ein.

Der Treiber authentifiziert sich nun als der oben angegebene Windows-Domänenbenutzer.

SQL Server-Authentifizierung

Rufen Sie Jitterbit Studio auf und richten Sie die Quelle oder das Ziel wie gewohnt ein. Geben Sie im Bildschirm der Quelle/des Ziel-Definition unter Verbindungsparameter Folgendes an:

• Treiber: Der SQL Server-Treiber kann ein ODBC- oder JDBC-Treiber sein.

  Hinweis

  Bei Auswahl eines JDBC-Treibers empfehlen wir die Verwendung von "SQL Server MS JDBC [JDBC]", Microsofts JDBC-Treiber für SQL Server, der ab Version 9.3 mit Jitterbit-Agenten gebündelt ist.

• Servername: Geben Sie den Namen oder die IP-Adresse des Servers an, auf dem sich der SQL Server befindet, mit dem Jitterbit sich verbinden muss. Möglicherweise müssen Sie den Namen der SQL Server-Instanz angeben (HostName\InstanceName).

• Datenbankname: Geben Sie den Namen der Datenbank auf dem Server an, mit der Jitterbit sich integrieren muss.

• Anmeldung: Geben Sie den Benutzernamen für die SQL Server-Authentifizierung ein.

• Passwort: Geben Sie das Passwort für die SQL Server-Authentifizierung ein.

Der Treiber authentifiziert sich nun mit den oben angegebenen Anmeldeinformationen der SQL Server-Authentifizierung.

Verbindungsverschlüsselung und Serverzertifikate

Aktuelle Versionen des Treibers SQL Server MS JDBC fordern standardmäßig eine verschlüsselte Verbindung an (encrypt=true) und validieren das Zertifikat, das der Datenbankserver präsentiert. Falls der Treiber das Serverzertifikat nicht anhand des Java-Keystores des Agenten validieren kann, schlägt die Verbindung mit einer ähnlichen Fehlermeldung fehl:

"encrypt" property is set to "true" and "trustServerCertificate" property is set to "false" but the driver could not establish a secure connection to SQL Server by using Secure Sockets Layer (SSL) encryption: Error: (certificate_unknown) PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target.

Dies betrifft jeden SQL Server, dessen Zertifikat sich nicht auf eine Zertifizierungsstelle (CA) zurückführen lässt, der der Agent bereits vertraut, einschließlich eines selbstsigniert oder intern ausgestellten Zertifikats. Amazon RDS for SQL Server ist ein Beispiel: Eine RDS-Instanz präsentiert ein Zertifikat, das von einer Amazon RDS-CA ausgestellt wurde, die sich nicht im Standard-Keystore des Agenten befindet. Eine Datenbank kann Verschlüsselung aktiviert haben und ein gültiges Zertifikat installiert haben und trotzdem diese Validierung fehlschlagen lassen, da der Fehler eher ein Vertrauensproblem als ein Verschlüsselungsproblem ist.

Agent-Version 12.8 hat den gebündelten Microsoft SQL Server JDBC-Treiber aktualisiert. Microsoft änderte den Standardwert von encrypt in der Treiberversion 10.2 von false auf true und dokumentiert diese Änderung als Breaking Change, beschrieben unter encrypt in Set the connection properties in der Microsoft-Dokumentation. Ein Ziel, das auf einem Agent vor Version 12.8 funktionierte, kann nach dem Upgrade daher fehlschlagen.

Um dies zu beheben, erweitern Sie Optionen und geben Sie encrypt=false; im Feld Zusätzliche Verbindungszeichenfolgen-Parameter ein, oder beziehen Sie es in die Verbindungszeichenfolge ein, wenn Sie Verbindungszeichenfolge manuell erstellen gewählt haben. Dies funktioniert auf Cloud- und Private Agents.

Ihr SQL Server-Setup erfordert möglicherweise auch andere Verbindungseigenschaften. Die vom Treiber unterstützten Eigenschaften finden Sie in Set the connection properties in der Microsoft-Dokumentation.