Mit Microsoft verbinden mit dem Database-Connector in Jitterbit Studio

Diese Seite erklärt, wie man sich mit diesen Microsoft-Diensten mit dem Database-Connector verbindet:

• Microsoft Access
• Microsoft Excel
• Microsoft SQL Server

Microsoft Access

Man muss einen privaten Agent ausführen, um sich mit Microsoft Access zu verbinden. Microsoft Office muss auf demselben System installiert sein, auf dem der private Agent läuft, und dieses System muss ein Windows-Betriebssystem sein. Beachten Sie, dass das Jitterbit-Team Linux-ODBC-Treiber für Microsoft Access nicht getestet hat.

ODBC-Treiber installieren

Der Microsoft Access ODBC-Treiber wird normalerweise als Teil von Windows installiert. Ältere Treiber unterstützen die Dateierweiterung .mdb. Wenn die Datenbank jedoch Access 2007 oder später mit der Dateierweiterung .accdb ist, benötigt man möglicherweise eine neuere Version des ODBC-Treibers, wie z. B. Microsoft Access 2016 Redistributable.

Database-Verbindung konfigurieren

Nach der Installation des Treibers gibt man diese Eingaben während der Konfiguration der Database-Verbindung an:

• Driver Type: Wählen Sie ODBC.

• Driver: Wählen Sie den Microsoft Access-Treiber.

• Use Connection String: Aktivieren Sie unter Optional Settings dieses Kontrollkästchen.

• Connection String: Geben Sie unter Optional Settings die manuelle Verbindungszeichenfolge in diesem Format ein:

  DRIVER=<driver>;DBQ=<database-path>;UID=<username>;PWD=<password>;
  

  Verwenden Sie eine dieser Verbindungszeichenfolgen, je nach Version und ob man ein Passwort hat. Ersetzen Sie den Ordnerpfad und den Dateinamen durch die spezifischen Angaben für die Datei auf dem privaten Agent.

  Microsoft Access Driver (\*.mdb) ohne Passwort

  DRIVER={Microsoft Access Driver (*.mdb, *.accdb)};DBQ=C:\myfolder\mydatabase.accdb;
  

  Microsoft Access Driver (\*.mdb, \*.accdb) mit Passwort

  DRIVER={Microsoft Access Driver(*.mdb, *accdb)};DBQ=C:\myfolder\mydatabase.accdb;UID=username;PWD=password;
  

Database-Aktivitäten konfigurieren

Bei der Konfiguration der Database-Aktivität ist zu beachten, dass der Microsoft Access ODBC-Treiber die Suche nach Objekten nicht unterstützt. Man sollte keine Suchkriterien in das Suchfeld zur Tabellenauswahl eingeben, da keine Ergebnisse zurückgegeben werden.

WHERE-Klausel-Beispiele

Diese WHERE-Klausel-Beispiele werden als Referenz bei der Konfiguration einer Database-Query-Aktivität bereitgestellt:

WHERE [LastName]='Bagel'

WHERE field1 LIKE field2

WHERE City = "Chicago" OR BirthDate < DateAdd (" yyyy ", -40, Date())

Weitere Beispiele finden Sie in der Microsoft-Dokumentation:

• Access SQL: WHERE clause
• Examples of query criteria

Microsoft Excel

Man muss einen privaten Agent verwenden, um sich mit einer Microsoft Excel-Tabelle zu verbinden.

ODBC-Treiber installieren

Um sich mit Excel-Tabellen zu verbinden, muss man möglicherweise einen Treiber installieren, wenn der entsprechende Treiber nicht bereits im Betriebssystem des privaten Agenten enthalten ist.

Beispielsweise wird Windows 10 mit x32 .xls ODBC-Treibern ausgeliefert, die Excel-Versionen 3.0, 4.0, 5.0/95 und 97-2000 unterstützen. Um jedoch die neueren ODBC-Treiber zu erhalten, die alle diese Versionen und Excel 12.0 (Excel 2007) unterstützen, kann man einen dieser Treiber installieren:

• Microsoft Access 2016 Runtime (Win 7/8/10/2008 R2/2012)
• Microsoft Access 2016 Redistributable

Datenbankverbindung konfigurieren

Nach der Installation des Treibers geben Sie diese Eingaben während der Konfiguration der Datenbankverbindung an:

• Treibertyp: Wählen Sie ODBC.

• Treiber: Wählen Sie den Microsoft Excel-Treiber.

• Verbindungszeichenfolge verwenden: Aktivieren Sie unter Optionale Einstellungen dieses Kontrollkästchen.

• Verbindungszeichenfolge: Verwenden Sie unter Optionale Einstellungen eine dieser Verbindungszeichenfolgen, je nach Ihrer Excel-Version. Ersetzen Sie den Ordnerpfad und den Dateinamen durch die spezifischen Angaben für die Datei auf dem privaten Agent.

  Excel 97, Excel 2000, Excel 2002, Excel 2003

  Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};
  DBQ=C:\Folder Path\My File Name.xls;
  

  Excel 2007, Excel 2010, Excel 2013

  Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};
  DBQ=C:\Folder Path\My File Name.xlsx;
  

  Um die Verbindung aktualisierbar zu machen (z. B. wenn Sie in eine Zieldatei schreiben möchten), können Sie ReadOnly=0; am Ende der Verbindungszeichenfolge hinzufügen. Beispiel:

  Aktualisierbar

  Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};
  DBQ=C:\Folder Path\My File Name.xlsx;ReadOnly=0;
  

  Tipp

  Weitere Optionen für Excel-Verbindungszeichenfolgen finden Sie unter Microsoft Excel 2007 ODBC Driver connection strings in der The Connection Strings Reference.

Datenbankaktivitäten konfigurieren

Während der Konfiguration der Datenbankaktivität können Sie Arbeitsblätter in der Excel-Tabelle auswählen und verknüpfen.

Microsoft SQL Server

Microsoft SQL Server-Datenbanken sind für Cloud- und Private Agents zugänglich. Windows ODBC auf Private Agents wird für optimierte Leistung empfohlen. Wenn Sie zusätzliche Funktionen nutzen möchten, z. B. die Bereitstellung einer manuellen Abfrage, sind diese nur mit dem JDBC-Treiber verfügbar. Harmony unterstützt diese Authentifizierungsoptionen:

Die folgenden Verfahren zeigen, wie man Microsoft SQL Server als Datenbankverbindung mit Windows- oder SQL Server-Authentifizierung konfiguriert. Sie enthalten auch Beispiele für WHERE-Klauseln, die man mit Datenbankaktivitäten verwenden kann.

Windows-Authentifizierung

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

1. Öffnen Sie das Tool Services Administrative (Start > Verwaltung > Dienste).

2. Bei Verwendung von ODBC klicken Sie mit der rechten Maustaste auf den Dienst Jitterbit Apache Server und wählen Sie Eigenschaften. Bei Verwendung von JDBC 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 den Namen und die Anmeldedaten des Kontos ein, das Sie für die Authentifizierung verwenden möchten. Klicken Sie dann auf Übernehmen.

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 die Jitterbit-Dienste neu.

Nach Abschluss dieser Schritte gehen Sie zu Studio und richten Ihre Datenbank wie gewohnt ein. Geben Sie diese Eingaben während der Konfiguration der Datenbankverbindung an:

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

  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 den Microsoft JDBC-Treibern zu verwenden, kopieren Sie die Datei mssql-jdbc_auth-x.x.x.x64.dll, die im Download-Paket des Treibers enthalten ist, 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 diese bei größeren Agent-Upgrades gelöscht werden kann.

• Treiber: Wählen Sie den SQL Server-Treiber.

• Servername: Geben Sie den Namen oder die IP-Adresse des Servers ein, auf dem der SQL Server ausgeführt wird, mit dem sich Harmony 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 sich Harmony verbinden muss.

• Anmeldung und Kennwort: Lassen Sie diese Felder leer.

• Zusätzliche Verbindungszeichenfolgen-Parameter: Geben Sie unter Optionale Einstellungen je nach Treiber Folgendes ein:

  • ODBC SQL Server: Wenn Sie den ODBC SQL Server-Treiber verwenden, geben Sie integratedSecurity=true ein. Wenn dies nicht funktioniert, geben Sie Trusted_Connection=yes ein.

  • ODBC Driver 11 für SQL Server, SQL Server Native Client 10.0, SQL Server Native Client 11.0: Wenn Sie einen anderen ODBC SQL Server-Treiber verwenden, geben Sie Trusted_Connection=yes ein.

  • SQL Server jTDS [JDBC], SQL Server MS JDBC [JDBC]: Wenn Sie einen JDBC SQL Server-Treiber verwenden, geben Sie integratedSecurity=true ein.

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

SQL Server-Authentifizierung

Gehen Sie zu Studio und richten Ihre Datenbank wie gewohnt ein. Geben Sie diese Einstellungen während der Konfiguration der Datenbankverbindung an:

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

• Treiber: Wählen Sie den SQL Server-Treiber aus. Bei der Auswahl eines JDBC-Treibers empfehlen wir die Verwendung von SQL Server MS JDBC, dem JDBC-Treiber von Microsoft für SQL Server.

• Servername: Geben Sie den Namen oder die IP-Adresse des Servers ein, auf dem der SQL Server ausgeführt wird, mit dem sich Harmony 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, mit der sich Harmony verbinden muss.

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

Der Treiber authentifiziert sich nun mit den angegebenen SQL Server-Authentifizierungsdaten.

Verbindungsverschlüsselung und Serverzertifikate

Aktuelle Versionen des SQL Server MS JDBC-Treibers fordern standardmäßig eine verschlüsselte Verbindung an (encrypt=true) und validieren das Zertifikat, das der Datenbankserver präsentiert. Wenn der Treiber das Serverzertifikat nicht anhand des Java-Keystores des Agenten validieren kann, schlägt die Verbindung mit einem Fehler wie diesem 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 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 und sich nicht im Standard-Keystore des Agenten befindet. Eine Datenbank kann Verschlüsselung aktiviert haben und ein gültiges Zertifikat installiert haben und diese Validierung dennoch nicht bestehen, da der Fehler ein Vertrauensproblem und kein Verschlüsselungsproblem ist.

Agent-Version 12.8 aktualisierte den gebündelten Microsoft SQL Server JDBC-Treiber. Microsoft änderte den Standardwert von encrypt von false zu 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 Verbindung, die auf einem Agent vor Version 12.8 funktionierte, kann daher nach dem Upgrade fehlschlagen.

Um dieses Problem zu beheben, geben Sie encrypt=false; im Feld Zusätzliche Verbindungszeichenfolgen-Parameter unter Optionale Einstellungen der Datenbankverbindung ein, oder fügen Sie es in eine manuelle Verbindungszeichenfolge ein. 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.

WHERE-Klausel-Beispiele

Diese WHERE-Klausel-Beispiele werden als Referenz bei der Konfiguration einer Datenbankabfrage-Aktivität bereitgestellt:

WHERE LastName = 'Smith' ;

WHERE LastName LIKE ('%Smi%');

WHERE EmployeeKey  <= 500;

WHERE EmployeeKey = 1 OR EmployeeKey = 8 OR EmployeeKey = 12;

WHERE EmployeeKey <= 500 AND LastName LIKE '%Smi%' AND FirstName LIKE '%A%';

WHERE LastName IN ('Smith', 'Godfrey', 'Johnson');

WHERE EmployeeKey Between 100 AND 200;

Weitere Beispiele finden Sie in der Microsoft-Dokumentation:

• WHERE (Transact-SQL)
• Search Condition (Transact-SQL)