Mit Microsoft verbinden, indem Sie den Database-Connector in Jitterbit Studio verwenden

Diese Seite erklärt, wie Sie sich mit diesen Microsoft-Diensten über den Database-Connector verbinden:

• Microsoft Access
• Microsoft Excel
• Microsoft SQL Server

Microsoft Access

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

Den ODBC-Treiber installieren

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

Die Database-Verbindung konfigurieren

Nachdem der Treiber installiert ist, geben Sie diese Eingaben während der Konfiguration der Database-Verbindung ein:

• Treibertyp: Wählen Sie ODBC.

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

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

• Verbindungszeichenfolge: Geben Sie unter Optionale Einstellungen die manuelle Verbindungszeichenfolge mit diesem Format ein:

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

  Verwenden Sie eine dieser Verbindungszeichenfolgen, je nach Version und ob Sie ein Passwort haben. Ersetzen Sie den Ordnerpfad und den Dateinamen mit denen, die für die Datei auf Ihrem privaten Agent spezifisch sind.

  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

Beachten Sie bei der Konfiguration von Database-Aktivitäten, dass der Microsoft Access ODBC-Treiber die Suche nach Objekten nicht unterstützt. Geben Sie keine Suchkriterien in das Suchfeld für die Tabellenauswahl ein, da keine Ergebnisse zurückgegeben werden.

WHERE-Klausel-Beispiele

Diese WHERE-Klausel-Beispiele werden zu Referenzzwecken bereitgestellt, wenn Sie eine Database Query Activity konfigurieren:

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

Sie müssen einen privaten Agent verwenden, um sich mit einem Microsoft Excel-Arbeitsblatt zu verbinden.

Den ODBC-Treiber installieren

Um sich mit Excel-Arbeitsblattern zu verbinden, müssen Sie möglicherweise einen Treiber installieren, wenn der entsprechende Treiber nicht bereits im Betriebssystem des privaten Agents 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 die neueren ODBC-Treiber zu erhalten, die alle diese Versionen und Excel 12.0 (Excel 2007) unterstützen, können Sie 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 werden folgende Eingaben während der Konfiguration der Datenbankverbindung benötigt:

• Treibertyp: Wählen Sie ODBC.

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

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

• Verbindungszeichenfolge: Verwenden Sie unter Optionale Einstellungen eine dieser Verbindungszeichenfolgen, je nach Excel-Version. Ersetzen Sie den Ordnerpfad und den Dateinamen durch die Werte 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 als aktualisierbar festzulegen (z. B. wenn Sie Schreibvorgänge in eine Zieldatei zulassen 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

Bei der Konfiguration der Datenbankaktivität können Sie Arbeitsblätter innerhalb 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 optimale Leistung empfohlen. Wenn Sie zusätzliche Funktionen nutzen möchten, wie 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-, SQL Server- oder Microsoft Entra-Authentifizierung konfiguriert. Sie enthalten auch Beispiele für WHERE-Klauseln, die man bei 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 verwenden, richten Sie diese Eigenschaften in Windows ein:

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

2. Klicken Sie bei Verwendung von ODBC mit der rechten Maustaste auf den Dienst Jitterbit Apache Server und wählen Sie Eigenschaften aus. Klicken Sie bei Verwendung von JDBC mit der rechten Maustaste auf den Dienst Jitterbit Tomcat Server und wählen Sie Eigenschaften aus.

3. Wechseln 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 Anwenden.

4. Wiederholen Sie den Vorgang für den Dienst Jitterbit Process Engine.

5. Setzen Sie TempDir in der Agent-Konfigurationsdatei (jitterbit.conf) auf C:\Windows\Temp\jitterbit.

6. Starten Sie die Jitterbit-Dienste neu.

Nach Abschluss dieser Schritte wechseln Sie zu Studio und richten die Datenbank wie gewohnt ein, indem Sie während der Konfiguration der Datenbankverbindung diese Eingaben angeben:

• Treibertyp: 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 eine DLL-Datei auf den Agenten, je nach gewähltem Treiber:

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

  • 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, 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 Agenten. Die DLL-Version muss der Version der JDBC-JAR-Datei entsprechen, die mit dem Agenten gebündelt ist. Erstellen Sie eine Sicherungskopie der Datei, da diese möglicherweise während großer Agent-Upgrades gelöscht wird.

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

• 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 Kennwort: Lassen Sie diese Felder leer.

• Zusätzliche Verbindungszeichenfolgenparameter: Geben Sie unter Optionale Einstellungen je nach Treiber Folgendes ein:

  • ODBC SQL Server: Bei Verwendung des ODBC SQL Server-Treibers geben Sie integratedSecurity=true ein. Wenn dies nicht funktioniert, geben Sie Trusted_Connection=yes ein.

  • ODBC Driver 11 for SQL Server, SQL Server Native Client 10.0, SQL Server Native Client 11.0: Bei Verwendung eines anderen ODBC 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

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

• Treibertyp: Wählen Sie je nach Bedarf entweder 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, Microsofts JDBC-Treiber für SQL Server.

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

Microsoft Entra-Authentifizierung

Die Microsoft Entra-Authentifizierung (ehemals Azure Active Directory) wird über JDBC auf Cloud- und Private Agents unterstützt. Richten Sie Ihre Datenbank wie gewohnt ein, verwenden Sie den Treiber SQL Server MS JDBC, und geben Sie diese Einstellungen in der Datenbankverbindung an:

• Anmeldung und Passwort: Geben Sie den Benutzernamen und das Passwort des Microsoft Entra-Kontos ein.

• Zusätzliche Verbindungszeichenfolgen-Parameter: Geben Sie unter Optionale Einstellungen authentication=ActiveDirectoryPassword ein.

Wenn die Datenbank durch eine Firewall geschützt ist, z. B. die Azure SQL Database-Firewall, ermöglichen Sie dem Agent die Verbindung. Fügen Sie für eine Cloud Agent-Gruppe die Jitterbit Cloud Agent-IP-Adressen für Ihre Region hinzu. Ermöglichen Sie für einen Private Agent die IP-Adresse, von der aus sich der Agent verbindet. Andernfalls schlägt die Verbindung fehl, mit einer Fehlermeldung, dass die Client-IP-Adresse keinen Zugriff auf den Server hat.

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. Wenn der Treiber das Zertifikat des Servers nicht anhand des Java-Keystores des Agents 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 nicht auf eine Zertifizierungsstelle (CA) zurückgeführt werden kann, der der Agent bereits vertraut, einschließlich eines selbstsigniert oder intern ausgestellten Zertifikats. 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 nicht im Standard-Keystore des Agents enthalten ist. Eine Datenbank kann Verschlüsselung aktiviert haben und ein gültiges Zertifikat installiert haben und trotzdem diese Validierung nicht bestehen, da das Problem in der Vertrauensstellung und nicht in der Verschlüsselung liegt.

Agent-Version 12.8 aktualisierte den gebündelten Microsoft SQL Server JDBC-Treiber. Microsoft änderte in Treiberversion 10.2 den Standardwert von encrypt von false auf true 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 zu fehlschlagen beginnen.

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.

Ihre SQL Server-Konfiguration kann auch andere Verbindungseigenschaften erfordern. Die vom Treiber unterstützten Eigenschaften finden Sie unter Set the connection properties in der Microsoft-Dokumentation.

WHERE-Klausel-Beispiele

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

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)