Freigeben über


Installieren des Microsoft BizTalk-Adapters für SQL Server – 2013 R2 und 2013

Installieren Sie den Microsoft BizTalk-Adapter für SQL Server, der in BizTalk Server 2013 R2 enthalten ist oder in BizTalk Server 2013 enthalten ist.

Der SQL-Adapter kann mit:

  • Eine .NET-Anwendung

  • Microsoft BizTalk Server

    Basierend auf der Verwendung der Adapter variiert die erforderliche Software.

Voraussetzungen für die Verwendung des Adapters mit einer .NET-Anwendung

Installieren Sie die folgende Software auf dem Computer, auf dem Sie .NET-Anwendungen schreiben, die den SQL-Adapter nutzen. Installieren Sie die Software in der aufgeführten Reihenfolge.

2013 R2 2013
.NET Framework 4.5.1 Microsoft .NET Framework 4.5
Visual Studio 2013 Visual Studio 2012
WCF LOB Adapter SDK WCF LOB Adapter SDK
Die SQL Server-Clientbibliotheken. . Die SQL Server-Clientbibliotheken..

Voraussetzungen für die Verwendung des Adapters mit BizTalk Server

Installieren Sie die folgende Software auf dem Computer, auf dem Sie den SQL-Adapter mit BizTalk Server verwenden. Es wird empfohlen, die Software in derselben Reihenfolge wie hier aufgeführt zu installieren.

2013 R2 2013
.NET Framework 4.5.1 Microsoft .NET Framework 4.5
Visual Studio 2013 Visual Studio 2012
WCF LOB Adapter SDK

Installieren Sie das Add-In "Consume Adapter Service BizTalk Project" für Visual Studio, das im WCF LOB Adapter SDK enthalten ist. Führen Sie zur Installation eine benutzerdefinierte Installation durch (wählen Sie BizTalk Server-Add-In) oder eine komplette Installation des WCF LOB Adapter SDK.
WCF LOB Adapter SDK

Installieren Sie das Add-In "Consume Adapter Service BizTalk Project" für Visual Studio, das im WCF LOB Adapter SDK enthalten ist. Führen Sie zum Installieren eine benutzerdefinierte Installation durch (wählen Sie BizTalk Server Addin) oder führen Sie eine komplette Installation des WCF LOB Adapter SDK aus.
BizTalk Server 2013 R2 BizTalk Server 2013
Die SQL Server-Clientbibliotheken. Die SQL Server-Clientbibliotheken.

Unterstützte SQL Server-Versionen und Clientbibliotheken

Im folgenden Abschnitt werden die unterstützten SQL Server-Versionen und die clientbibliotheken dargestellt, die vom SQL-Adapter benötigt werden.

  • Unterstützte Serverversionen: SQL Server 2005, SQL Server 2008 SP1, SQL Server 2008 R2, SQL Server 2012

  • Unterstützte Clientversionen: Microsoft .NET Framework 4.5 bündelt die Client-DLLs, die zur Verbindung mit SQL Server erforderlich sind. Sie müssen keine Client-DLLs explizit auf Ihrem Computer installieren.

  • Erforderliche Treiber:

    • Wenn Sie die UDTs verwenden, die mit den SQL Server-Versionen ausgeliefert wurden, z. B. "Geography", stellen Sie sicher, dass die folgenden DLLs auf dem Computer vorhanden sind, auf dem Sie den Adapter zum Ausführen von Vorgängen auf SQL Server verwenden. Wenn Sie beispielsweise BizTalk-Projekte zum Ausführen von Vorgängen auf SQL Server erstellen, müssen diese DLLs auf dem Computer vorhanden sein, auf dem BizTalk Server ausgeführt wird.

      • Stellen Sie sicher, dass Microsoft.SqlServer.Types.dll dem GAC hinzugefügt wird.

      • Stellen Sie sicher, dass SqlServerSpatial.dll im Ordner "System32" verfügbar ist.

        Sie können diese DLLs auf dem Computer installieren, indem Sie das SQL Server-Setup ausführen und die Verwaltungstools – Standard und Verwaltungstools – Vollständig auf der Seite Featureauswahl des Assistenten auswählen.

    • Wenn Sie den Adapter zum Ausführen von Vorgängen in Spalten von FILESTREAM-Datentypen verwenden, stellen Sie sicher, dass das SQL Client Connectivity SDK installiert ist. Sie können das SQL Client Connectivity SDK installieren, indem Sie das SQL Server-Setup ausführen und das SQL Client Connectivity SDK auf der Seite "Featureauswahl " des Assistenten auswählen. Der Adapter verwendet die sqlncli10.dll, die mit dem SQL Client Connectivity SDK installiert ist, um FILESTREAM-Vorgänge auszuführen.

    • Wenn Sie eigene UDTs in SQL Server erstellen, stellen Sie sicher, dass die entsprechenden Assemblys für die UDTs dem GAC hinzugefügt werden.

64-Bit-Unterstützung

Der SQL-Adapter kann in einer 32-Bit- oder 64-Bit-Hostinstanz ausgeführt werden.

Weitere Informationen zu den unterstützten Installationsszenarien für den 32-Bit- und 64-Bit-SQL-Adapter.

Installieren des SQL-Adapters

Stellen Sie sicher, dass die erforderlichen Komponenten installiert sind, bevor Sie den SQL-Adapter installieren.

Sie können den SQL-Adapter auf zwei Arten installieren:

  • Im interaktiven Modus mit dem Setup-Assistenten

  • Im lautlosen Modus mit msiexec in der Befehlszeile

    Von Bedeutung

    Sie müssen über Administratorrechte auf dem Computer verfügen, auf dem Sie den SQL-Adapter installieren, unabhängig davon, ob Sie den Assistenten oder die Befehlszeile verwenden.

32-Bit- und 64-Bit-Installationsszenarien

Mit BizTalk Server kann der SQL-Adapter für Folgendes verwendet werden:

  • Visual Studio-Entwurfszeit (beim Generieren von Metadaten für Vorgänge).

  • Entwurfszeit der BizTalk Server-Verwaltungskonsole (zum Erstellen physischer Ports).

    Hinweis

    Die BizTalk Server-Verwaltungskonsole wird als 32-Bit-Anwendung der Microsoft Management Console (MMC) ausgeführt.

  • BizTalk-Laufzeit (beim Senden und Empfangen von Nachrichten von LOB-Anwendungen).

    Sie können über eine Installation verfügen, bei der Sie alle diese Aufgaben auf demselben Computer oder auf unterschiedlichen Computern ausführen. Da visual Studio und BizTalk MMC 32-Bit-Prozesse sind, müssen Sie den 32-Bit-SQL-Adapter auf dem Computer installieren, auf dem Sie die Entwurfszeitaufgaben ausführen möchten. Die folgenden Szenarien werden für die Installation des SQL-Adapters auf 32-Bit- und 64-Bit-Plattformen unterstützt.

Installieren von Szenarien auf einer 32-Bit-Plattform

Die folgenden Szenarien werden beim Installieren des SQL-Adapters auf einer 32-Bit-Plattform unterstützt.

Visual Studio-Entwurfszeit BizTalk MMC-Entwurfszeit BizTalk-Laufzeit Visual Studio-Entwurfszeit und/oder BizTalk MMC-Entwurfszeit + BizTalk-Laufzeit
- Installieren Sie das 32-Bit WCF LOB Adapter SDK.

- Installieren Sie den 32-Bit-SQL-Adapter.

– Installieren Sie den 32-Bit-Client und andere erforderliche DLLs.
- Installieren Sie das 32-Bit WCF LOB Adapter SDK.

- Installieren Sie den 32-Bit-SQL-Adapter.

– Installieren Sie den 32-Bit-Client und andere erforderliche DLLs.
- Installieren Sie das 32-Bit WCF LOB Adapter SDK.

- Installieren Sie den 32-Bit-SQL-Adapter.

– Installieren Sie den 32-Bit-Client und andere erforderliche DLLs.
- Installieren Sie das 32-Bit WCF LOB Adapter SDK.

- Installieren Sie den 32-Bit-SQL-Adapter.

– Installieren Sie den 32-Bit-Client und andere erforderliche DLLs.

Installieren von Szenarien auf einer 64-Bit-Plattform

Die folgenden Szenarien werden bei der Installation des SQL-Adapters auf einer 64-Bit-Plattform unterstützt.

Hinweis

Auf jedem Computer, auf dem Sie Entwurfszeitaufgaben mit Visual Studio oder BizTalk MMC ausführen möchten, müssen Sie den 32-Bit-SQL-Adapter installieren.

Visual Studio-Entwurfszeit BizTalk MMC-Entwurfsphase BizTalk-Laufzeit Visual Studio-Entwurfszeit und/oder BizTalk MMC-Entwurfszeit + BizTalk-Laufzeit
- Installieren Sie das 64-Bit WCF LOB Adapter SDK.

- Installieren Sie den 32-Bit-SQL-Adapter.

– Installieren Sie den 32-Bit-Client und andere erforderliche DLLs.
- Installieren Sie das 64-Bit WCF LOB Adapter SDK.

- Installieren Sie den 32-Bit-SQL-Adapter.

– Installieren Sie den 32-Bit-Client und andere erforderliche DLLs.
Für einen 32-Bit-BizTalk-Prozess:

- Installieren Sie das 64-Bit WCF LOB Adapter SDK.

- Installieren Sie den 32-Bit-SQL-Adapter.

– Installieren Sie den 32-Bit-Client und andere erforderliche DLLs.

Für einen 64-Bit-BizTalk-Prozess:

- Installieren Sie das 64-Bit WCF LOB Adapter SDK.

- Installieren Sie den 64-Bit-SQL-Adapter.

– Installieren Sie den 64-Bit-Client und andere erforderliche DLLs.
Für einen 32-Bit-BizTalk-Prozess:

- Installieren Sie das 64-Bit WCF LOB Adapter SDK.

- Installieren Sie den 32-Bit-SQL-Adapter.

– Installieren Sie den 32-Bit-Client und andere erforderliche DLLs.

Für einen 64-Bit-BizTalk-Prozess:

- Installieren Sie das 64-Bit WCF LOB Adapter SDK.

- Installieren Sie den 64-Bit-SQL-Adapter.

– Installieren Sie den 64-Bit-Client und andere erforderliche DLLs.

- Installieren Sie den 32-Bit-SQL-Adapter.

– Installieren Sie den 32-Bit-Client und andere erforderliche DLLs.

Installieren des SQL-Adapters im interaktiven Modus

  1. Führen Sie das Installationsprogramm aus.

    Hinweis

    Wenn Sie den SQL-Adapter auf einem virtuellen Computer installieren, wird der Setup-Assistent möglicherweise nicht über ein Dialogfeld hinaus fortgesetzt, in dem darüber informiert wird, dass das Setup auf verfügbaren Speicherplatz überprüft wird. In solchen Fällen empfehlen wir, die Option für die stille Installation zu verwenden.

  2. Lesen Sie die Informationen auf der Willkommensseite, und klicken Sie dann auf "Weiter".

  3. Lesen Und akzeptieren Sie den Endbenutzer-Lizenzvertrag (EULA), und klicken Sie dann auf Weiter.

  4. Geben Sie im Dialogfeld "Zielordner " den Speicherort an, an dem Sie den SQL-Adapter installieren möchten, klicken Sie auf "Weiter", und klicken Sie dann auf "Installieren".

  5. Geben Sie im Dialogfeld "Programm zur Verbesserung der Benutzerfreundlichkeit" an, ob Sie sich für das Programm zur Verbesserung der Benutzerfreundlichkeit (Customer Experience Improvement Program, CEIP) registrieren möchten. Als Teil von CEIP für SQL-Adapter geben Sie die folgenden Daten mit Microsoft zusammen:

    • Daten im Zusammenhang mit der Computerhardware, auf der Sie den SQL-Adapter installieren.

    • Daten im Zusammenhang mit den SQL Server-Versionen, die Sie zum Herstellen einer Verbindung mit dem SQL-Adapter verwenden.

      Geben Sie Ihre Auswahl an, und klicken Sie auf 'OK'.

    Hinweis

    Sie können Ihre Vorliebe für die Registrierung für CEIP jederzeit ändern, indem Sie das Setup im Reparaturmodus über die Systemsteuerung ausführen.

  6. Klicken Sie auf Fertig stellen.

Installieren des SQL-Adapters im unbeaufsichtigten Modus

Das folgende Verfahren veranschaulicht, wie Sie mithilfe des msiexec Befehls eine automatische Installation des SQL-Adapters ausführen.

  1. Öffnen Sie eine Eingabeaufforderung, und navigieren Sie zu dem Ordner, in dem Sie über das Installationsprogramm verfügen.

  2. Führen Sie den folgenden Befehl aus, um den SQL-Adapter zu installieren:

    Hinweis

    Um die stille Installation auf einer x64-basierten Plattform auszuführen, ersetzen Sie in den folgenden Befehlen SqlAdapterSetup.msi durch SqlAdapterSetup64.msi.

    msiexec /i SqlAdapterSetup.msi /qn  
    

    Sie haben die Möglichkeit, sich im Rahmen der stillen Installation für das CEIP anzumelden. Als Teil von CEIP für SQL-Adapter geben Sie die folgenden Daten mit Microsoft zusammen:

    • Die Computerhardware, auf der Sie den SQL-Adapter installieren.

    • Die SQL Server-Versionen, die Sie zum Herstellen einer Verbindung mit dem SQL-Adapter verwenden.

      Führen Sie den folgenden Befehl aus, um sich für CEIP zu registrieren:

    msiexec /i SqlAdapterSetup.msi /qn CEIP_OPTIN=true  
    

    Standardmäßig ist die Option "false".

    Wenn Sie weitere Informationen zum msiexec Befehl wünschen, geben Sie msiexec in die Befehlszeile ein, und drücken Sie ENTER. Oder lesen Sie msiexec.

Aufgaben nach der Installation

Bindungen registrieren

Führen Sie diese Schritte nur aus, wenn der Setup-Assistent die Adapterbindungen in der datei machine.config nicht registriert.

  1. Navigieren Sie zur datei machine.config auf dem Computer. Beispielsweise ist die machine.config auf einer 32-Bit-Plattform unter <Systemlaufwerk>:\WINDOWS\Microsoft.NET\Framework\version>\<CONFIG verfügbar.

    • Für Microsoft .NET Framework 3.5 SP1 < ist die Version> v2.0.50727 des .NET Frameworks.

    • Für Microsoft .NET Framework 4.5 < ist die Version> v4.0.30319 von .NET Framework.

  2. Öffnen Sie die Datei mit einem Text-Editor.

  3. So registrieren Sie die Adapterbindungen:

    1. Suchen Sie nach dem Element "system.serviceModel", und fügen Sie folgendes hinzu:

      <client>  
        <endpoint binding="sqlBinding" contract="IMetadataExchange" name="mssql" />  
      </client>  
      
    2. Suchen Sie unter "system.serviceModel\extensions" nach dem Element "bindingElementExtensions".

    3. Fügen Sie den folgenden Abschnitt unter dem Knoten "bindingElementExtensions" hinzu.

      Fügen Sie für den SQL-Adapter Folgendes hinzu:

      <add name="sqlAdapter" type="Microsoft.Adapters.Sql.SqlAdapterBindingElementExtensionElement,Microsoft.Adapters.Sql, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />  
      
    4. Suchen Sie unter "system.serviceModel\extensions" nach dem Element "bindingExtensions".

    5. Fügen Sie den folgenden Abschnitt unter dem Knoten "bindingExtensions" hinzu.

      Fügen Sie für den SQL-Adapter Folgendes hinzu:

      <add name="sqlBinding" type="Microsoft.Adapters.Sql.SqlAdapterBindingCollectionElement,Microsoft.Adapters.Sql, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />  
      
  4. Speichern und schließen Sie die machine.config Datei.

Bestimmen des öffentlichen Schlüssels und der Version

Führen Sie die folgenden Schritte aus, um den öffentlichen Schlüssel und die Version für den SQL-Adapter zu ermitteln.

  1. Navigieren Sie zum Windows-Verzeichnis, in der Regel C:\WINDOWS\assembly.

  2. Klicken Sie mit der rechten Maustaste auf die DLL, für die der öffentliche Schlüssel verwendet werden soll, und wählen Sie dann "Eigenschaften" aus. In der folgenden Tabelle sind die Namen der DLLs für den SQL-Adapter aufgeführt.

    Adapter Name der DLL
    SQL-Adapter Microsoft.Adapters.Sql.dll
  3. Auf der Registerkarte " Allgemein " gibt der Wert für die Bezeichnung " Public Key Token " den öffentlichen Schlüssel für die DLL an. Ebenso gibt der Wert für die Versionsbezeichnung die Versionsnummer für die DLL an.

  4. Kopieren Sie den öffentlichen Schlüssel, und klicken Sie dann auf 'Abbrechen'.

Aktualisieren oder Ändern der SQL-Adapterinstallation

Führen Sie die folgenden Schritte aus, um die SQL-Adapterinstallation zu ändern. Stellen Sie sicher, dass der SQL-Adapter installiert ist, bevor Sie den Setup-Assistenten ausführen, um die SQL-Adapterinstallation zu ändern.

Sie können die SQL-Adapterinstallation auf zwei Arten ändern:

  • Im interaktiven Modus durch Ausführen des Setup-Assistenten.

  • Im unbeaufsichtigten Modus mithilfe der Befehlszeile.

Aktualisieren der SQL-Adapterinstallation im interaktiven Modus

  1. Klicken Sie auf Start und dann auf Systemsteuerung.

  2. Doppelklicken Sie in der Systemsteuerung auf "Programme und Features".

  3. Wählen Sie im Fenster "Programme und Features " den Microsoft BizTalk-Adapter für SQL Server aus, und klicken Sie dann auf "Ändern".

  4. Lesen Sie die Informationen auf der Willkommensseite, und klicken Sie dann auf "Weiter".

  5. Klicken Sie im Dialogfeld "Ändern", "Reparieren" oder "Installation entfernen " auf "Reparieren".

  6. Klicken Sie im Dialogfeld "Bereit zum Reparieren des Microsoft BizTalk-Adapters für SQL Server " auf "Reparieren".

  7. Ändern Sie bei Bedarf Ihre Einstellungen hinsichtlich der Auswahl für CEIP, und klicken Sie dann auf "OK".

  8. Klicken Sie auf Fertig stellen.

Aktualisieren der SQL-Adapterinstallation im unbeaufsichtigten Modus

  1. Öffnen Sie eine Eingabeaufforderung, und navigieren Sie zum Stammverzeichnis des SQL-Adapterinstallationsprogramms.

  2. Führen Sie den folgenden Befehl aus:

    Hinweis

    Um die SQL-Adapterinstallation im unbeaufsichtigten Modus auf einer x64-basierten Plattform zu ändern, ersetzen Sie in den folgenden Befehlen SqlAdapterSetup.msi durch SqlAdapterSetup64.msi.

    msiexec /i SqlAdapterSetup.msi /qn /f  
    

    Von Bedeutung

    Beim Ändern der INSTALLATION des SQL-Adapters im unbeaufsichtigten Modus können Sie Ihre Einstellungen für das Anmelden oder Abmelden von CEIP nicht ändern. Die Einstellungen bleiben unverändert wie bei der Installation, auch wenn Sie die CEIP_OPTIN explizit auf "true" oder "false" festgelegt haben.

    Wenn Sie weitere Informationen zum msiexec Befehl wünschen, geben Sie msiexec in die Befehlszeile ein, und drücken Sie ENTER. Oder lesen Sie msiexec.

Deinstallieren oder Entfernen des SQL-Adapters

Führen Sie die folgenden Schritte aus, um den SQL-Adapter von Ihrem Computer zu entfernen. Stellen Sie sicher, dass das WCF LOB Adapter SDK installiert ist, bevor Sie den Setup-Assistenten ausführen, um den SQL-Adapter zu entfernen.

Sie können den SQL-Adapter auf zwei Arten entfernen:

  • Im interaktiven Modus durch Ausführen des Setup-Assistenten.

  • Im unbeaufsichtigten Modus mithilfe der Befehlszeile.

Deinstallieren im interaktiven Modus

  1. Klicken Sie auf Start und dann auf Systemsteuerung.

  2. Doppelklicken Sie in der Systemsteuerung auf "Programme und Features".

  3. Wählen Sie im Fenster "Programme hinzufügen oder entfernen " den Microsoft BizTalk-Adapter für SQL Server aus, und klicken Sie dann auf "Entfernen".

  4. Klicken Sie im Dialogfeld auf "Ja".

Deinstallation im unbeaufsichtigten Modus

  1. Öffnen Sie eine Eingabeaufforderung, und navigieren Sie zum Stammverzeichnis des SQL-Adapterinstallationsprogramms.

  2. Führen Sie den folgenden Befehl aus:

    Hinweis

    Um den SQL-Adapter im unbeaufsichtigten Modus auf einer x64-basierten Plattform zu entfernen, ersetzen Sie in den folgenden Befehlen SqlAdapterSetup.msi durch SqlAdapterSetup64.msi.

    msiexec /x SqlAdapterSetup.msi /qn  
    

    Mit diesem Befehl wird der SQL-Adapter vom Computer entfernt.

    Wenn Sie weitere Informationen zum msiexec Befehl wünschen, geben Sie msiexec in die Befehlszeile ein, und drücken Sie ENTER. Oder lesen Sie msiexec.

Aufgabe nach der Deinstallation

Wenn das Setup des SQL-Adapters beim Entfernen des SQL-Adapters die Adapterbindungen nicht entfernt, müssen Sie sie manuell entfernen. Im folgenden Abschnitt wird beschrieben, wie Sie die Bindungen für den SQL-Adapter manuell entfernen.

Manuelles Entfernen der Bindungen

Führen Sie diese Schritte nur aus, wenn der Setup-Assistent die Adapterbindungen nicht aus der datei machine.config entfernt.

  1. Navigieren Sie zur datei machine.config auf dem Computer. Beispielsweise ist die machine.config auf einer 32-Bit-Plattform unter <Systemlaufwerk>:\WINDOWS\Microsoft.NET\Framework\version>\<CONFIG verfügbar.

    • Für Microsoft .NET Framework 3.5 SP1 < ist die Version> v2.0.50727 des .NET Frameworks.

    • Für Microsoft .NET Framework 4.5 < ist die Version> v4.0.30319 von .NET Framework.

  2. Öffnen Sie die Datei mit einem Text-Editor.

  3. So entfernen Sie die Adapterbindungsregistrierung:

    1. Suchen Sie nach dem Element "system.serviceModel", und entfernen Sie Folgendes unter dem Element:

      <client>  
        <endpoint binding="sqlBinding" contract="IMetadataExchange" name="mssql" />  
      </client>  
      
      
    2. Suchen Sie unter "system.serviceModel\extensions" nach dem Element "bindingElementExtensions".

    3. Entfernen Sie den folgenden Abschnitt unter dem Knoten "bindingElementExtensions".

      Entfernen Sie für den SQL-Adapter Folgendes:

      <add name="sqlAdapter" type="Microsoft.Adapters.Sql.SqlAdapterBindingElementExtensionElement,Microsoft.Adapters.Sql, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />  
      
    4. Suchen Sie unter "system.serviceModel\extensions" nach dem Element "bindingExtensions".

    5. Entfernen Sie den folgenden Abschnitt unter dem Knoten "bindingExtensions".

      Entfernen Sie für den SQL-Adapter Folgendes:

      <add name="sqlBinding" type="Microsoft.Adapters.Sql.SqlAdapterBindingCollectionElement,Microsoft.Adapters.Sql, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />  
      
  4. Speichern und schließen Sie die machine.config Datei.

Siehe auch

Installieren des SQL-Adapters
Grundlegendes zum BizTalk-Adapter für SQL Server