Zum Inhalt springen

Verwandeln Sie Ihre Kontakte in Urlaubsgeld mit unserem neuen Kundenempfehlungsprogramm! Erfahren Sie mehr

Stellen Sie mithilfe des Datenbank-Connectors im Jitterbit Integration Studio eine Verbindung zu Microsoft her

Auf dieser Seite erfahren Sie, wie Sie mithilfe des Datenbank-Connectors eine Verbindung zu verschiedenen Microsoft-Diensten herstellen. Es gibt Anweisungen zum Herstellen einer Verbindung mit Microsoft Access, Microsoft Excel und 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 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.

Installieren des ODBC Driver

Der Microsoft Access ODBC Driver wird normalerweise als Teil von Windows installiert. Ältere Treiber unterstützen den .mdb Dateierweiterung. Wenn Ihre Datenbank jedoch Access 2007 oder höher mit der .accdb Erweiterung benötigen Sie möglicherweise eine neuere Version des ODBC Driver, z. B. Microsoft Access 2016 Redistributable.

Konfigurieren der Datenbankverbindung

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

  • Treibertyp: Wählen Sie ODBC.

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

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

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

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

    Verwenden Sie je nach Version und Passwort eine dieser Verbindungszeichenfolgen. Ersetzen Sie Ordnerpfad und Dateinamen durch die spezifischen Angaben für die Datei auf Ihrem privaten Agenten.

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

Konfigurieren von Datenbankaktivitäten

Beachten Sie bei der Konfiguration der Datenbankaktivität, dass der Microsoft Access ODBC Driver die Objektsuche nicht unterstützt. Geben Sie keine Suchkriterien in das Suchfeld für die Tabellenauswahl ein, da sonst keine Ergebnisse zurückgegeben werden.

Beispiele für WHERE-Klauseln

Diese WHERE-Klauselbeispiele dienen als Referenz bei der Konfiguration einer Abfrage:

WHERE [LastName]='Bagel'
WHERE field1 LIKE field2
WHERE City = "Chicago" OR BirthDate < DateAdd (" yyyy ", -40, Date())

Weitere Beispiele finden Sie in der Microsoft-Dokumentation:

Microsoft Excel

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

Installieren des ODBC Driver

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

Beispielsweise verfügt Windows 10 über x32 .xls ODBC-Treiber, die 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, können Sie einen dieser Treiber installieren:

Konfigurieren der Datenbankverbindung

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

  • Treibertyp: Wählen Sie ODBC.

  • Treiber: Wählen Sie den Microsoft Excel Driver aus.

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

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

    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 das Schreiben in eine Zieldatei zulassen möchten), können Sie Folgendes hinzufügen: ReadOnly=0;bis zum Ende der Verbindungszeichenfolge. Beispiel:

    Updateable
    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 Verbindungszeichenfolgen für Microsoft Excel 2007 ODBC-Treiber in der Referenz zu Verbindungszeichenfolgen.

Konfigurieren von Datenbankaktivitäten

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

Anhang

Notiz

Wenn beim Ausführen des Operation die Fehlermeldung „[Microsoft][ODBC Excel Driver] Vorgang muss eine aktualisierbare Abfrage verwenden“ angezeigt wird, ist die Excel Datei möglicherweise schreibgeschützt. Sie können die Aktualisierbarkeit Ihrer Excel Datei durch Anhängen von ReadOnly=0; zu Ihrer Verbindungszeichenfolge, während Sie den Endpoint wie oben beschrieben konfigurieren.

Microsoft SQL Server

Microsoft SQL Server Datenbanken sind über Jitterbit-Agenten zugänglich, die unter Windows laufen oder Linux, wobei Windows ODBC auf privaten Agenten für eine optimale Leistung empfohlen wird. Beachten Sie jedoch, dass Sie, wenn Sie zusätzliche Funktionen nutzen möchten, z. B. die Möglichkeit, eine manuelle Abfrage, sind diese nur über den JDBC Driver verfügbar. Harmony unterstützt die folgenden Authentifizierungsoptionen:

  • MS SQL ODBC unter Windows mit Windows-Authentifizierung oder SQL Server-Authentifizierung
  • MS SQL JDBC unter Windows mit Windows-Authentifizierung oder SQL Server-Authentifizierung
  • MS SQL JDBC unter Linux mit SQL Server-Authentifizierung

Die folgenden Verfahren zeigen, wie Sie Microsoft SQL Server als Datenbankverbindung konfigurieren, entweder mit Windows oder SQL Server-Authentifizierung, gefolgt von Beispielen für WHERE-Klauseln, die mit Datenbankaktivitäten verwendet werden können.

Windows-Authentifizierung

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

  1. Öffnen Sie das Tool Diensteverwaltung (Start > Verwaltung > 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. Wechseln Sie zur Tab Anmelden. Wählen Sie Dieses Konto aus und geben Sie den Namen und die Anmeldeinformationen des Kontos ein, das Sie zur Authentifizierung verwenden möchten. Klicken Sie anschließend auf Übernehmen.
  4. Wiederholen Sie den Vorgang für den Dienst Jitterbit Process Engine.
  5. Satz TempDir in der Agentenkonfigurationsdatei (jitterbit.conf) Zu C:\Windows\Temp\jitterbit.
  6. Jitterbit-Dienste neu starten.

Achtung

Stellen Sie sicher, dass Sie dem Domänenbenutzer die Berechtigungen Anmelden als Dienst und Aktivieren als Teil des Betriebssystems erteilt haben. Stellen Sie sicher, dass der Domänenbenutzer Lese- und Schreibrechte für das private Agenten-Installationsverzeichnis hat.

Notiz

Alternativ zu den oben genannten Schritten 1 bis 4 können Sie dem auf dem privaten Agenten-Computer verwendeten Konto Berechtigungen für den SQL Server erteilen. Dies kann vom SQL Server Administrator durch die Einrichtung des privaten Agenten-Computerkontos in Windows Active Directory erfolgen (<domainName>\<machineName>$).

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

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

    Wichtig

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

    Um die Windows Authentifizierung mit den Microsoft JDBC-Treibern zu verwenden, kopieren Sie die mssql-jdbc_auth-x.x.x.x64.dll Datei, die mit dem Download-Paket des Treibers gebündelt ist, an den C:\Program Files\Jitterbit Agent\jre\bin Ordner auf dem Agenten. Erstellen Sie eine Sicherungskopie der Datei, da diese bei größeren Agenten-Upgrades gelöscht werden kann.

  • Treiber: Wählen Sie den SQL Server Driver 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 Namen der SQL Server Instanz angeben (HostName\InstanceName).
  • Datenbankname: Geben Sie den Namen der Datenbank auf dem Server ein, mit dem Harmony eine Verbindung herstellen muss.
  • Anmelden und Passwort: Lassen Sie diese Felder leer.
  • Zusätzliche Verbindungszeichenfolgenparameter: Geben Sie unter Optionale Einstellungen je nach Driver Folgendes ein:

    • ODBC SQL Server: Wenn Sie den ODBC SQL Server Driver verwenden, geben Sie ein integratedSecurity=true. Wenn dies nicht funktioniert, geben Sie Trusted_Connection=yes.
    • 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 Driver verwenden, geben Sie Trusted_Connection=yes.
    • SQL Server jTDS [JDBC], SQL Server Microsoft [JDBC]: Wenn Sie einen JDBC SQL Server Driver verwenden, geben Sie integratedSecurity=true.

Der Driver authentifiziert sich jetzt als der oben angegebene Windows Domänenbenutzer.

SQL Server Authentifizierung

Gehen Sie zu Integration Studio und richten Sie Ihre Datenbank wie gewohnt ein. Geben Sie diese Eingaben 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 Driver aus. Bei der Auswahl eines JDBC Driver empfehlen wir die Verwendung von SQL Server MS JDBC.

  • 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 Namen der SQL Server Instanz angeben (HostName\InstanceName).

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

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

Der Driver authentifiziert sich jetzt wie angegeben mit den SQL Server Authentifizierungsdaten.

Beispiele für WHERE-Klauseln

Diese WHERE-Klauselbeispiele dienen als Referenz bei der Konfiguration einer Abfrage:

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: