Microsoft SQL-Datenbankquelle in Jitterbit Design Studio konfigurieren

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

Windows-Authentifizierung

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

1. Öffnen Sie das Tool Services Administrative (Start > Verwaltungsprogramme > Dienste).
2. Wenn Sie ODBC verwenden, klicken Sie mit der rechten Maustaste auf den Dienst Jitterbit Apache Server und wählen Sie Eigenschaften. Wenn Sie JDBC verwenden, klicken Sie mit der rechten Maustaste auf den Dienst Jitterbit Tomcat Server und wählen Sie Eigenschaften.
3. Gehen Sie zur Registerkarte Anmelden. Wählen Sie Dieses Konto und geben Sie Name und Anmeldedaten des Kontos ein, das Sie für die Authentifizierung verwenden möchten. Klicken Sie dann auf Übernehmen.
4. Wiederholen Sie dies 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-Dienste 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 Verbindungsparameter Folgendes an:

• Treibertyp: Wählen Sie je nach Bedarf ODBC oder JDBC.

  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 für 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-Projektpakets in den Ordner C:\Program Files\Jitterbit Agent\jre\bin auf dem Agent.

  • SQL Server MS JDBC oder ein neuerer Microsoft JDBC Driver für SQL Server: Kopieren Sie die Datei mssql-jdbc_auth-x.x.x.x64.dll, die im Download-Paket des Treibers enthalten ist, sowohl in den Ordner C:\Program Files\Jitterbit Agent\jre\bin als auch in den Ordner C:\Program Files\Jitterbit Agent\jre\lib auf dem Agent. Die DLL-Version muss der Version der mit dem Agent gebündelten JDBC-JAR-Datei entsprechen. Erstellen Sie eine Sicherungskopie der Datei, da sie möglicherweise bei großen Agent-Upgrades gelöscht wird.

• Servername: Geben Sie den Namen oder die IP-Adresse des Servers ein, auf dem die SQL Server ausgeführt wird, mit der sich Jitterbit 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 ein, zu der Jitterbit integriert werden muss.
• Anmeldung: Lassen Sie dieses Feld leer.
• Passwort: Lassen Sie dieses Feld leer.

• Optionen: Klicken Sie, um zusätzliche Einstellungen zu erweitern. Geben Sie im Feld Zusätzliche Verbindungsstringparameter 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 jetzt als der oben angegebene Windows-Domänenbenutzer.

SQL Server-Authentifizierung

Öffnen Sie Jitterbit Studio und richten Sie Ihre Quelle oder Ihr Ziel wie gewohnt ein. Geben Sie im Definitionsbildschirm für Quelle/Ziel 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 in Jitterbit-Agents enthalten ist.

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

• Datenbankname: Geben Sie den Namen der Datenbank auf dem Server ein, mit der Jitterbit integriert werden 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 jetzt mit den angegebenen SQL Server-Authentifizierungsdaten.

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. Kann der Treiber das Serverzertifikat nicht anhand des Java-Keystores des Agents validieren, schlägt die Verbindung mit einem Fehler fehl, der diesem ähnelt:

"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 nicht auf eine Zertifizierungsstelle (CA) zurückgeführt werden kann, der der Agent bereits vertraut, einschließlich selbstsignierter oder intern ausgestellter Zertifikate. Amazon RDS für 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 Agents befindet. Eine Datenbank kann eine aktivierte Verschlüsselung und ein gültiges installiertes Zertifikat haben und diese Validierung dennoch nicht bestehen, da der Fehler ein Vertrauensproblem und kein Verschlüsselungsproblem ist.

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

Um dieses Problem zu beheben, erweitern Sie Optionen und geben Sie encrypt=false; im Feld Zusätzliche Verbindungszeichenfolgen-Parameter ein, oder fügen 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. Informationen zu den vom Treiber unterstützten Eigenschaften finden Sie unter Set the connection properties in der Microsoft-Dokumentation.