Freigeben über

Konfigurieren des Verbindungs-URI für den SQL-Adapter

  • Artikel

Ein Verbindungs-URI ist ein Verbindungszeichenfolge, der Parameter enthält, die zum Herstellen einer Verbindung mit SQL Server erforderlich sind. Wenn Sie das Add-In "Adapterdienst nutzen" oder den Assistenten zum Hinzufügen von Adaptermetadaten in Visual Studio verwenden, müssen Sie den URI angeben, um eine Verbindung mit SQL Server herzustellen, um die Metadaten zu generieren. Beim Konfigurieren eines Sende- oder Empfangsports mithilfe der BizTalk Server-Verwaltungskonsole müssen Sie den URI angeben, um eine Verbindung mit SQL Server herzustellen, um Vorgänge auszuführen.

Geben Sie den Verbindungs-URI aus Visual Studio ein.

In Visual Studio können Sie den Verbindungs-URI mithilfe des Add-Ins "Adapterdienst nutzen" oder mit dem Assistenten zum Hinzufügen von Adaptermetadaten angeben.

Verwenden des Add-Ins "Adapterdienst nutzen"

  1. Klicken Sie mit der rechten Maustaste auf Ihr BizTalk-Projekt, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Generierte Elemente hinzufügen.

  2. Führen Sie im Dialogfeld Generierte Elemente hinzufügen die folgenden Schritte aus:

    Option Aufgabe
    Kategorien Klicken Sie auf Adapterdienst nutzen.
    Vorlagen Klicken Sie auf Adapterdienst nutzen.

  3. Um das Dialogfeld Adapterdienst nutzen zu starten, klicken Sie auf Hinzufügen.

  4. Wählen Sie im Dialogfeld Adapterdienst nutzen aus der Liste Bindung auswählendie Option sqlBinding aus, und klicken Sie dann auf Konfigurieren.

  5. Klicken Sie im Dialogfeld Adapter konfigurieren auf die Registerkarte Sicherheit . Führen Sie in der Liste Clientanmeldeinformationen einen der folgenden Schritte aus:

    Hinweis

    Wenn Sie über die Windows-Authentifizierung eine Verbindung mit SQL Server herstellen, muss der Windows-Benutzer, mit dem Sie angemeldet sind, SQL Server hinzugefügt werden, wie unter Herstellen einer Verbindung mit SQL Server Verwenden der Windows-Authentifizierung mit dem SQL-Adapter beschrieben.

    Klicken Sie darauf. Aufgabe
    None Die Verbindung mit SQL Server wird mithilfe der Windows-Authentifizierung hergestellt.
    Windows Die Verbindung mit SQL Server wird mithilfe der Windows-Authentifizierung hergestellt.
    Benutzername Geben Sie den Benutzernamen und das Kennwort zum Herstellen einer Verbindung mit SQL Server an, indem Sie die Anmeldeinformationen für einen Benutzer angeben, der in der SQL Server-Datenbank definiert ist. Beachten Sie, dass für den Benutzernamen und das Kennwort zwischen Groß- und Kleinschreibung unterschieden wird. Hinweis: Wenn Sie die Felder Benutzername und Kennwort leer lassen, stellt der Adapter mithilfe von Windows-Authentifizierung eine Verbindung mit SQL Server her.

  6. Klicken Sie auf die Registerkarte URI-Eigenschaften , und geben Sie Werte für verschiedene Parameter an. Weitere Informationen zum Verbindungs-URI für den SQL-Adapter finden Sie unter Erstellen des SQL Server-Verbindungs-URI.

  7. Klicken Sie auf die Registerkarte Bindungseigenschaften , und geben Sie ggf. Werte für die Bindungseigenschaften an, die vor dem Generieren des Schemas erforderlich sind. Weitere Informationen zu Bindungseigenschaften finden Sie unter Informationen zum BizTalk-Adapter für SQL Server Adapterbindungseigenschaften.

  8. Klicken Sie auf OK.

Verwenden des Assistenten zum Hinzufügen von Adaptermetadaten

  1. Klicken Sie mit der rechten Maustaste auf das BizTalk-Projekt, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Generierte Elemente hinzufügen.

  2. Führen Sie im Dialogfeld Generierte Elemente hinzufügen die folgenden Schritte aus:

    Option Aufgabe
    Kategorien Klicken Sie auf Adapter hinzufügen.
    Vorlagen Klicken Sie auf Adaptermetadaten hinzufügen.

  3. Klicken Sie auf Hinzufügen. Der Assistent zum Hinzufügen von Adaptermetadaten wird geöffnet.

  4. Wählen Sie im Assistenten zum Hinzufügen von Adaptern die Option WCF-SQL aus. Wählen Sie den Computer aus, auf dem BizTalk Server installiert ist, und den Namen der BizTalk-Datenbank.

    Wichtig

    Wenn Sie bereits einen WCF-SQL-Port in BizTalk konfiguriert haben, wählen Sie den Port aus der Liste Port aus.

  5. Klicken Sie auf Weiter.

  6. Wählen Sie im Dialogfeld Adapterdienst nutzen aus der Dropdownliste Bindung auswählendie Option sqlBinding aus, und klicken Sie dann auf Konfigurieren.

  7. Klicken Sie im Dialogfeld Adapter konfigurieren auf die Registerkarte Sicherheit , und führen Sie im Dropdownfeld Clientanmeldeinformationentyp eine der folgenden Aktionen aus:

    Hinweis

    Wenn Sie über die Windows-Authentifizierung eine Verbindung mit SQL Server herstellen, muss der Windows-Benutzer, mit dem Sie angemeldet sind, SQL Server hinzugefügt werden, wie unter Herstellen einer Verbindung mit SQL Server Verwenden der Windows-Authentifizierung mit dem SQL-Adapter beschrieben.

    Klicken Sie darauf. Aufgabe
    None Die Verbindung mit SQL Server wird mithilfe der Windows-Authentifizierung hergestellt.
    Windows Die Verbindung mit SQL Server wird mithilfe der Windows-Authentifizierung hergestellt.
    Benutzername Geben Sie den Benutzernamen und das Kennwort zum Herstellen einer Verbindung mit SQL Server an, indem Sie die Anmeldeinformationen für einen Benutzer angeben, der in der SQL Server-Datenbank definiert ist. Beachten Sie, dass für den Benutzernamen und das Kennwort zwischen Groß- und Kleinschreibung unterschieden wird. Hinweis: Wenn Sie die Felder Benutzername und Kennwort leer lassen, stellt der Adapter mithilfe von Windows-Authentifizierung eine Verbindung mit SQL Server her.

  8. Klicken Sie auf die Registerkarte URI-Eigenschaften , und geben Sie dann Werte für die Verbindungsparameter an. Weitere Informationen zum Verbindungs-URI für den SQL-Adapter finden Sie unter Erstellen des SQL Server-Verbindungs-URI.

  9. Klicken Sie auf die Registerkarte Bindungseigenschaften , und geben Sie dann werte für die Bindungseigenschaften an, falls vorhanden, die für die Vorgänge erforderlich sind, die Sie als Ziel verwenden möchten. Weitere Informationen zu Bindungseigenschaften finden Sie unter Informationen zum BizTalk-Adapter für SQL Server Adapterbindungseigenschaften.

    Hinweis

    Wenn Sie einen vorhandenen WCF-SQL-Sendeport ausgewählt haben, müssen Sie die Bindungseigenschaften nicht angeben. Die Bindungseigenschaften werden aus der Sendeportkonfiguration ausgewählt. Sie können jedoch die Bindungseigenschaften angeben, die zur Entwurfszeit erforderlich sind, falls vorhanden. In diesem Fall werden die neuen Werte für Bindungseigenschaften zur Entwurfszeit beim Generieren der Metadaten verwendet. Zur Laufzeit gelten jedoch die Werte, die für Bindungseigenschaften in der Sendeportkonfiguration angegeben sind.

  10. Klicken Sie auf OK.

Geben Sie den Verbindungs-URI über die BizTalk Server-Verwaltungskonsole ein.

In der BizTalk Server-Verwaltungskonsole können Sie den Verbindungs-URI als Teil der WCF-Custom oder einer WCF-SQL-Portkonfiguration angeben.

Geben Sie den Verbindungs-URI für den WCF-Custom-Port ein.

  1. Starten Sie die BizTalk Server-Verwaltungskonsole.

  2. Erweitern Sie in der Konsolenstruktur die BizTalk-Gruppe, dann Anwendungen, und erweitern Sie dann die Anwendung, unter der Sie einen Port erstellen möchten, und klicken Sie auf Ports senden oder Ports empfangen. Im rechten Bereich können Sie einen Port erstellen oder einen vorhandenen Port auswählen.

  3. Wählen Sie im Dialogfeld Porteigenschaften in der Dropdownliste Typ die Option WCF-Custom aus, und klicken Sie dann auf Konfigurieren.

    Hinweis

    Um das Dialogfeld Standorteigenschaften für einen Empfangsport anzuzeigen, klicken Sie im linken Bereich des Dialogfelds Porteigenschaften auf die Registerkarte Empfangsspeicherort , und klicken Sie dann auf Neu.

  4. Klicken Sie im Dialogfeld WCF-Benutzerdefinierte Transporteigenschaften auf die Registerkarte Allgemein .

  5. Geben Sie im Textfeld Adresse (URI) den Verbindungs-URI an, um eine Verbindung mit SQL Server herzustellen. Weitere Informationen zum Verbindungs-URI für den SQL-Adapter finden Sie unter Erstellen des SQL Server-Verbindungs-URI.

  6. Klicken Sie im Dialogfeld WCF-Benutzerdefinierte Transporteigenschaften auf die Registerkarte Bindung . Wählen Sie in der Dropdownliste Bindungstypdie Option sqlBinding aus.

  7. Wenn Sie einen Sendeport erstellen, klicken Sie im Dialogfeld WCF-Benutzerdefinierte Transporteigenschaften auf die Registerkarte Anmeldeinformationen , und führen Sie eine der folgenden Aktionen aus:

    • Wählen Sie die Option Einmaliges Anmelden nicht verwenden aus, und geben Sie den Benutzernamen und das Kennwort an, um eine Verbindung mit SQL Server herzustellen. Beachten Sie, dass für den Benutzernamen und das Kennwort zwischen Groß- und Kleinschreibung unterschieden wird.

      Hinweis

      Wenn Sie mithilfe von Windows-Authentifizierung eine Verbindung mit SQL Server herstellen möchten, geben Sie einen leeren Benutzernamen und ein leeres Kennwort an. Bevor Sie dies tun, muss der Windows-Benutzer, mit dem Sie angemeldet sind, SQL Server hinzugefügt werden, wie unter Herstellen einer Verbindung mit SQL Server Verwenden der Windows-Authentifizierung mit dem SQL-Adapter beschrieben.

    • Wählen Sie die Option Einmaliges Anmelden verwenden aus, und geben Sie eine verbundene Enterprise-Anwendung für einmaliges Anmelden (Single Sign-On, SSO) an.

  8. Wenn Sie einen Empfangsport erstellen, klicken Sie im Dialogfeld WCF-Benutzerdefinierte Transporteigenschaften auf die Registerkarte Andere , und führen Sie eine der folgenden Aktionen aus:

    • Wählen Sie die Option Benutzerkonto aus, und geben Sie den Benutzernamen und das Kennwort für die Verbindung mit SQL Server an. Beachten Sie, dass für den Benutzernamen und das Kennwort zwischen Groß- und Kleinschreibung unterschieden wird.

      Hinweis

      Wenn Sie mithilfe von Windows-Authentifizierung eine Verbindung mit SQL Server herstellen möchten, geben Sie einen leeren Benutzernamen und ein leeres Kennwort an. Bevor Sie dies tun, muss der Windows-Benutzer, mit dem Sie angemeldet sind, SQL Server hinzugefügt werden, wie unter Herstellen einer Verbindung mit SQL Server Verwenden der Windows-Authentifizierung mit dem SQL-Adapter beschrieben.

    • Wählen Sie Die Option Anmeldeinformationen von Partneranwendung abrufen aus , und geben Sie eine Partner-SSO-Anwendung an.

  9. Klicken Sie auf OK.

Geben Sie den Verbindungs-URI für den WCF-SQL-Port ein.

  1. Starten Sie die BizTalk Server-Verwaltungskonsole.

  2. Fügen Sie den WCF-SQL-Adapter der BizTalk Server-Verwaltungskonsole hinzu. Anweisungen finden Sie unter Hinzufügen des SQL-Adapters zu BizTalk Server Verwaltungskonsole.

  3. Erweitern Sie in der Konsolenstruktur die Option BizTalk-Gruppe, dann Anwendungen, und erweitern Sie dann die Anwendung, unter der Sie einen Port erstellen möchten, und klicken Sie auf Ports senden oder Empfangensports senden. Im rechten Bereich können Sie einen Port erstellen oder einen vorhandenen Port auswählen.

  4. Wählen Sie im Dialogfeld Porteigenschaften in der Dropdownliste Typ den WCF-SQL-Adapter aus, den Sie zuvor hinzugefügt haben, und klicken Sie dann auf Konfigurieren.

    Hinweis

    Klicken Sie zum Anzeigen des Dialogfelds Standorteigenschaften für einen Empfangsport im linken Bereich des Dialogfelds Porteigenschaften auf die Registerkarte Empfangsspeicherort , und klicken Sie dann auf Neu.

  5. Klicken Sie im Dialogfeld Transporteigenschaften auf die Registerkarte Allgemein .

  6. Klicken Sie auf die Schaltfläche Konfigurieren , und geben Sie Werte für die Verbindungsparameter an. Weitere Informationen zum Verbindungs-URI für den SQL-Adapter finden Sie unter Erstellen des SQL Server Verbindungs-URI.

  7. Klicken Sie im Dialogfeld Transporteigenschaften auf die Registerkarte Bindung , und geben Sie Werte für Bindungseigenschaften an.

    Hinweis

    Die Bindungseigenschaften werden basierend darauf angezeigt, ob Sie einen Sendeport oder einen Empfangsport konfigurieren. Beispielsweise sind Bindungseigenschaften im Zusammenhang mit Benachrichtigungen beim Konfigurieren eines Sendeports nicht verfügbar, da Benachrichtigungen eingehende Vorgänge sind und eine Empfangsportkonfiguration erfordern.

  8. Wenn Sie einen Sendeport erstellen, klicken Sie im Dialogfeld Transporteigenschaften auf die Registerkarte Anmeldeinformationen , und führen Sie eine der folgenden Aktionen aus:

    • Wählen Sie die Option Einmaliges Anmelden nicht verwenden aus, und geben Sie den Benutzernamen und das Kennwort für die Verbindung mit SQL Server an. Beachten Sie, dass für den Benutzernamen und das Kennwort zwischen Groß- und Kleinschreibung unterschieden wird.

      Hinweis

      Wenn Sie mithilfe von Windows-Authentifizierung eine Verbindung mit SQL Server herstellen möchten, geben Sie einen leeren Benutzernamen und ein leeres Kennwort an. Bevor Sie dies tun, muss der Windows-Benutzer, mit dem Sie angemeldet sind, SQL Server hinzugefügt werden, wie unter Herstellen einer Verbindung mit SQL Server Verwenden der Windows-Authentifizierung mit dem SQL-Adapter beschrieben.

    • Wählen Sie die Option Einmaliges Anmelden verwenden aus, und geben Sie eine Partneranwendung für einmaliges Anmelden (Single Sign-On, SSO) für Enterprise an.

  9. Wenn Sie einen Empfangsport erstellen, klicken Sie im Dialogfeld Transporteigenschaften auf die Registerkarte Andere , und führen Sie eine der folgenden Aktionen aus:

    • Wählen Sie die Option Benutzerkonto aus, und geben Sie den Benutzernamen und das Kennwort für die Verbindung mit SQL Server an. Beachten Sie, dass für den Benutzernamen und das Kennwort zwischen Groß- und Kleinschreibung unterschieden wird.

      Hinweis

      Wenn Sie mithilfe von Windows-Authentifizierung eine Verbindung mit SQL Server herstellen möchten, geben Sie einen leeren Benutzernamen und ein leeres Kennwort an. Bevor Sie dies tun, muss der Windows-Benutzer, mit dem Sie angemeldet sind, SQL Server hinzugefügt werden, wie unter Herstellen einer Verbindung mit SQL Server Verwenden der Windows-Authentifizierung mit dem SQL-Adapter beschrieben.

    • Wählen Sie Die Option Anmeldeinformationen von Partneranwendung abrufen aus , und geben Sie eine Partner-SSO-Anwendung an.

  10. Klicken Sie auf OK.

Weitere Informationen

Bausteine zum Entwickeln von BizTalk-Anwendungen mit dem SQL-Adapter