Mit Microsoft über den Datenbank-Connector in Jitterbit Studio verbinden

Diese Seite erklärt, wie Sie eine Verbindung zu diesen Microsoft-Diensten über den Datenbank-Connector herstellen:

• Microsoft Access
• Microsoft Excel
• Microsoft SQL Server

Microsoft Access

Sie müssen einen privaten Agenten ausführen, um eine Verbindung zu Microsoft Access herzustellen. Microsoft Office muss auf demselben 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 die ODBC-Treiber für Microsoft Access unter Linux nicht getestet hat.

Installieren Sie den ODBC-Treiber

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

Konfigurieren Sie die Datenbankverbindung

Nachdem der Treiber installiert ist, geben Sie diese Eingaben während der Konfiguration der Datenbankverbindung an:

• Treiber-Typ: 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 im folgenden Format ein:

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

  Verwenden Sie eine dieser Verbindungszeichenfolgen, abhängig von der Version und ob Sie ein Passwort haben. Ersetzen Sie den Ordnerpfad und den Dateinamen durch die spezifischen Angaben zur Datei, die sich auf Ihrem privaten Agenten befindet.

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

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

Datenbankaktivitäten konfigurieren

Bei der Konfiguration von Datenbankaktivitäten ist zu beachten, dass der Microsoft Access ODBC-Treiber die Suche nach Objekten nicht unterstützt. Geben Sie keine Suchkriterien in das Suchfeld zur Tabellenauswahl ein, da keine Ergebnisse zurückgegeben werden.

Beispiele für WHERE-Klauseln

Diese Beispiele für WHERE-Klauseln dienen als Referenz bei der Konfiguration einer Datenbankabfrage-Aktivität:

WHERE [LastName]='Bagel'

WHERE field1 LIKE field2

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

Für weitere Beispiele siehe die Dokumentation von Microsoft:

• Access SQL: WHERE-Klausel
• Beispiele für Abfragekriterien

Microsoft Excel

Sie müssen einen privaten Agenten verwenden, um eine Verbindung zu einer Microsoft Excel Tabelle herzustellen.

Installieren des ODBC-Treibers

Um eine Verbindung zu Excel-Tabellen herzustellen, müssen Sie möglicherweise einen Treiber installieren, wenn der entsprechende Treiber nicht bereits im Betriebssystem des privaten Agenten enthalten ist.

Zum Beispiel enthält Windows 10 x32 .xls ODBC-Treiber, die Excel-Versionen 3.0, 4.0, 5.0/95 und 97-2000 unterstützen. Um jedoch die neueren ODBC-Treiber zu erhalten, die all 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

Nachdem der Treiber installiert ist, geben Sie diese Eingaben während der Konfiguration der Datenbankverbindung an:

• Treiberart: 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, abhängig von Ihrer Excel-Version. Ersetzen Sie den Ordnerpfad und den Dateinamen durch die spezifischen Angaben zur Datei, die sich auf dem privaten Agenten befindet.

  Excel 97, Excel 2000, Excel 2002, Excel 2003

  Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};
  DBQ=C:\Ordnerpfad\MeinDateiname.xls;
  

  Excel 2007, Excel 2010, Excel 2013

  Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};
  DBQ=C:\Ordnerpfad\MeinDateiname.xlsx;
  

  Um anzugeben, dass die Verbindung aktualisierbar sein soll (zum Beispiel, wenn Sie das Schreiben in eine Zieldatei erlauben möchten), können Sie ReadOnly=0; am Ende der Verbindungszeichenfolge hinzufügen. Zum Beispiel:

  Aktualisierbar

  Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};
  DBQ=C:\Ordnerpfad\MeinDateiname.xlsx;ReadOnly=0;
  

  Tipp

  Siehe zusätzliche Optionen für Excel-Verbindungszeichenfolgen unter Microsoft Excel 2007 ODBC Driver-Verbindungszeichenfolgen im Referenzhandbuch für Verbindungszeichenfolgen.

Datenbankaktivitäten konfigurieren

Während der Konfiguration der Datenbankaktivität können Sie Arbeitsblätter innerhalb der Excel-Tabelle auswählen und verbinden.

Microsoft SQL Server

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

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

Windows-Authentifizierung

Windows-Authentifizierung wird nur über ODBC und JDBC 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 Verwaltungstool für Dienste (Start > Verwaltungstools > 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. Gehe zum Tab Log On. Wähle Dieses Konto aus und gib den Namen und die Anmeldeinformationen des Kontos ein, das du für die Authentifizierung verwenden möchtest. Klicke dann auf Übernehmen.

4. Wiederhole dies für den Dienst Jitterbit Process Engine.

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

6. Starte die Jitterbit-Dienste neu.

Nachdem diese Schritte abgeschlossen sind, gehe zu Studio und richte deine Datenbank wie gewohnt ein, indem du diese Eingaben während der Konfiguration der Datenbankverbindung angibst:

• Treiberart: Wähle ODBC oder JDBC je nach Bedarf.

  Wichtig

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

  • SQL Server jTDS [JDBC]
  • SQL Server Microsoft [JDBC]
  • Neuere Versionen des Microsoft JDBC-Treibers für SQL Server

  Um die Windows-Authentifizierung mit den Microsoft JDBC-Treibern zu verwenden, kopiere die Datei mssql-jdbc_auth-x.x.x.x64.dll, die im Download-Paket des Treibers enthalten ist, in den Ordner C:\Program Files\Jitterbit Agent\jre\bin auf dem Agenten. Mache eine Sicherungskopie der Datei, da sie während größerer Agenten-Updates gelöscht werden kann.

• Treiber: Wähle den SQL Server-Treiber aus.

• Servername: Gib den Namen oder die IP-Adresse des Servers ein, auf dem der SQL Server läuft, mit dem Harmony eine Verbindung herstellen muss. Möglicherweise musst du den SQL Server-Instanznamen angeben (HostName\InstanceName).

• Datenbankname: Geben Sie den Namen der Datenbank auf dem Server ein, mit dem Harmony eine Verbindung herstellen muss.

• Benutzername und Passwort: Lassen Sie diese Felder leer.

• Zusätzliche Verbindungszeichenfolgenparameter: Unter Optionale Einstellungen geben Sie 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-Treiber 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 Microsoft [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 Sie Ihre Datenbank wie gewohnt ein. Geben Sie diese Einstellungen während der Konfiguration der Datenbankverbindung an:

• Treiberart: 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 Microsoft.

• Servername: Geben Sie den Namen oder die IP-Adresse des Servers ein, auf dem der SQL Server läuft, mit dem Harmony eine Verbindung herstellen 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 dem Harmony eine Verbindung herstellen muss.

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

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

Beispiele für WHERE-Klauseln

Diese Beispiele für WHERE-Klauseln werden zu Referenzzwecken bereitgestellt, wenn Sie eine Datenbankabfrageaktivität konfigurieren:

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;

Für weitere Beispiele siehe die Dokumentation von Microsoft:

• WHERE (Transact-SQL)
• Suchbedingung (Transact-SQL)