Verbindung zu Microsoft über den Datenbank-Connector in Jitterbit Studio

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 des ODBC-Treibers

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 Dateiendung .accdb ist, müssen Sie möglicherweise eine neuere Version des ODBC-Treibers wie den Microsoft Access 2016 Redistributable beziehen.

Konfigurieren der 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 auf Ihrem privaten Agenten.

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.

ODBC-Treiber installieren

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 in The Connection Strings Reference.

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 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 entweder 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 für private Agenten über ODBC und JDBC unterstützt. Sie kann nur mit einem Domänenkonto verwendet werden. Um die Windows-Authentifizierung zu nutzen, richten Sie diese Eigenschaften in Windows ein:

1. Öffnen Sie das Dienstverwaltungs-Tool (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 den Namen und die Anmeldeinformationen 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. Setzen Sie TempDir in der Agent-Konfigurationsdatei (jitterbit.conf) auf C:\Windows\Temp\jitterbit.

6. Starten Sie die Jitterbit-Dienste neu.

Nachdem diese Schritte abgeschlossen sind, gehen Sie zu Studio und richten Sie Ihre Datenbank wie gewohnt ein, indem Sie diese Eingaben während der Konfiguration der Datenbankverbindung angeben:

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

  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, kopieren Sie 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. Erstellen Sie eine Sicherungskopie der Datei, da sie während größerer Agenten-Updates gelöscht werden könnte.

• 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 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 der Harmony eine Verbindung herstellen muss.

• Benutzername und Passwort: Lassen Sie diese Felder leer.

• Zusätzliche Verbindungszeichenfolgenparameter: Unter Optionale Einstellungen geben Sie Folgendes je nach Ihrem Treiber 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 der Harmony eine Verbindung herstellen muss.

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

Der Treiber wird nun die Authentifizierung mit den angegebenen SQL Server-Authentifizierungsdaten durchführen.

WHERE-Klausel Beispiele

Diese WHERE-Klausel Beispiele werden zu Referenzzwecken bereitgestellt, wenn Sie eine Datenbankabfrage-Aktivitä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 zusätzliche Beispiele siehe die Dokumentation von Microsoft:

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