Freigeben über

Konfigurieren einer physischen Portbindung mithilfe einer Portbindungsdatei für die Verwendung des SQL-Adapters

Wenn Sie das Add-In "Consume Adapter Service BizTalk Project" verwenden, um Metadaten für ein SQL Server-Artefakt zu generieren, generiert das Add-In "Consume Adapter Service" neben den Schemadateien auch eine Portbindungsdatei. Sie können diese Bindungsdatei in Ihre BizTalk-Anwendung importieren, um einen physischen Sende- oder Empfangsport zu erstellen. Anweisungen zum Importieren von Bindungsdateien finden Sie unter Wiederverwenden von Adapterbindungen. Wenn Sie diese Bindungsdatei importieren, müssen Sie keinen physischen Sende- oder Empfangsport manuell erstellen.

Von Bedeutung

Wenn Sie beim Verwenden des Add-Ins "Adapterdienst verbrauchen" keinen Wert für eine Bindungseigenschaft vom Typ "Zeichenfolge" angeben und deren Standardwert null ist, steht diese Bindungseigenschaft in der Bindungsdatei nicht zur Verfügung. Sie müssen die Bindungseigenschaft und den zugehörigen Wert in der Bindungsdatei bei Bedarf manuell hinzufügen.

Beim Erstellen eines Ports mithilfe der Portbindungsdatei wird immer ein bidirektionales Sendeport oder ein unidirektionaler Empfangsport erstellt. Wenn Sie einen unidirektionale Sendeport erstellen möchten, können Sie ihn manuell mithilfe der Schritte unter Manuelles Konfigurieren einer physischen Portbindung an den SQL-Adapter erstellen. Alternativ können Sie die in diesem Thema dokumentierten Problemumgehungen befolgen, um die Portbindungsdatei so zu ändern, dass sie unidirektionale Sendeports erstellt.

Hinweis

Bei eingehenden Vorgängen erstellt die Portbindungsdatei immer einen unidirektionalen Empfangsport. Dies liegt daran, dass der SQL-Adapter nur unidirektionale Empfangsports für eingehende Vorgänge unterstützt.

Von Bedeutung

Mithilfe des Assistenten zum Hinzufügen von Adaptermetadaten wird keine Portbindungsdatei erstellt, mit der Sie einen WCF-SQL Port erstellen können. Sie können jedoch einige Änderungen an der portbindungsdatei vornehmen, die vom Add-In "Verbrauchsadapterdienst" generiert wurde, und sie zum Erstellen eines WCF-SQL-Ports verwenden. Weitere Informationen finden Sie unter Konfigurieren eines WCF-SQL-Ports mit der von der Consume Adapter Service Add-in generierten Port-Bindungsdatei.

Im Folgenden sind einige wichtige Punkte aufgeführt, die Sie in Bezug auf die Bindungsdatei verstehen müssen, die das Add-In "Adapter-Dienst nutzen" generiert:

  • Die Dateien werden mit einer bestimmten Benennungskonvention erstellt. Wenn Sie Metadaten für ausgehende Vorgänge generiert haben, d. h. zum Senden von Nachrichten an SQL Server, wird der Name der Datei WcfSendPort_SqlAdapterBinding_Custom.bindinginfo.xml.

    Wenn Sie Metadaten für eingehende Vorgänge generiert haben, d. h. zum Empfangen von Nachrichten von SQL Server, wird der Name der Datei WcfReceivePort_SqlAdapterBinding_Custom.bindinginfo.xml.

  • Die Datei enthält Informationen über die Bindungskonfiguration, den Bindungstyp, den Endpunkt-URI und die Portaktion basierend auf den Vorgängen, für die Metadaten generiert wurden. Wenn Sie diese Bindungsdatei in Ihre BizTalk-Anwendung importieren, um einen Port zu erstellen, werden alle relevanten Informationen, die zum Konfigurieren eines physischen Ports erforderlich sind, automatisch für den Port festgelegt.

    Von Bedeutung

    Standardmäßig ist die Aktion für den Sendeport dem Vorgangsnamen zugeordnet, für den Sie Metadaten generiert haben. Wenn Sie beispielsweise Metadaten für den Vorgang "Einfügen" in der Tabelle "Kunde" generieren, wird die Aktion für den Port auf <Operation Name="Insert" Action="TableOp/Insert/dbo/CustomerTable" /> festgelegt. Der Vorgangsname des logischen Sendeports, den Sie in der BizTalk-Orchestrierung erstellen, ist jedoch möglicherweise nicht identisch. Sie müssen sicherstellen, dass der Vorgangsname im logischen Sendeport (im BizTalk-Orchestrierung) und der physische Sendeport (in der BizTalk Server-Verwaltungskonsole) identisch sind. Wenn nicht, erhalten Sie beim Senden von Nachrichten über den Sendeport eine Fehlermeldung an SQL Server.

  • Sie müssen nur die Anmeldeinformationen für den Port angeben, um eine Verbindung mit SQL Server herzustellen. Obwohl die Bindungsdatei den Benutzernamen behält, mit dem eine Verbindung hergestellt werden soll, enthält die Bindungsdatei aus Sicherheitsgründen nicht das Kennwort.

Wichtige Überlegungen zur Verwendung der Portbindungsdatei

  • Wenn Sie die Bindungsdatei importieren, wird möglicherweise eine Dialogfeldmeldung angezeigt, in der Sie darüber informiert werden, dass der Name der BizTalk-Anwendung in der Bindungsdatei nicht mit dem Anwendungsnamen übereinstimmt, in den Sie die Bindungsdatei importieren. Sie können diese Nachricht sicher ignorieren und fortfahren.

  • Die Bindungsdatei enthält auch Namen von Ports und Empfangsspeicherorten. Wenn die BizTalk-Anwendung, in die Sie die Bindungsdatei importieren, einen Port oder einen Empfangsspeicherort mit demselben Namen wie ein bereits vorhandener Port in derselben BizTalk-Anwendung erstellt, wird eine Fehlermeldung angezeigt. Sie müssen die Bindungsdatei manuell bearbeiten, um einen eindeutigen Namen für die Ports oder Empfangsorte anzugeben.

  • Die Bindungsdatei enthält auch Informationen zum Verbindungs-URI. Wenn die Bindungsdatei einen Empfangsspeicherort erstellt, der den gleichen Empfangs-URI wie einen bereits vorhandenen Empfangsspeicherort in derselben BizTalk-Anwendung aufweist, wird eine Fehlermeldung angezeigt. Sie müssen die Bindungsdatei manuell bearbeiten, um einen eindeutigen URI anzugeben.

  • Standardmäßig enthält die Portbindungsdatei für ausgehende Vorgänge immer Definitionen für einen bidirektionale Sendeport. Wenn Sie diese Datei in eine BizTalk-Anwendung importieren, wird ein bidirektionales Sendeport erstellt. Möglicherweise haben Sie jedoch eine Orchestrierung mit einem unidirektionalen Sendeport. Wenn Sie also eine solche Orchestrierung konfigurieren und den port verwenden, der durch Importieren der Bindungsdatei erstellt wurde, ist der Port in der Liste nicht verfügbar. Dies geschieht, weil der logische Port, den Sie als Teil der Orchestrierung erstellt haben, ein unidirektionaler Port ist, während der physische Port, der in der Orchestrierung erstellt wurde, ein bidirektionaler Port ist. In solchen Fällen können Sie die Bindungsdatei bearbeiten, um die folgenden Änderungen vorzunehmen:

    Hierfür Mach das
    So bearbeiten Sie die Portbindungsdatei zum Konfigurieren eines unidirektionalen Sendeports 1. Ändern Sie im folgenden Auszug den Wert der IsTwoWay-Eigenschaft in "false". Ursprünglich ist dies auf "true" festgelegt.
    <SendPort Name="port_name" IsStatic="true" IsTwoWay="false" BindingOption="0">
    2. Kommentieren Sie die folgenden Auszüge aus:
    <ReceivePipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLReceive" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLReceive, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken=token" Type="1" TrackingOption="None" Description=""/>
    <ReceivePipelineData xsi:nil="true" />

    Von Bedeutung

    Bei eingehenden Vorgängen erstellt die Portbindungsdatei immer einen unidirektionalen Empfangsport. Dies liegt daran, dass der SQL-Adapter nur unidirektionale Empfangsports für eingehende Vorgänge unterstützt.

Konfigurieren eines WCF-SQL Port mithilfe der Portbindungsdatei, die mithilfe des Add-Ins "Nutzungsadapterdienst" generiert wurde

Das Add-In "Adapterdienst verbrauchen" erstellt außerdem eine Portbindungsdatei, die Sie in der BizTalk Server-Verwaltungskonsole importieren können. Sie können dieselbe Portbindungsdatei verwenden, um auch den BizTalk-WCF-SQL-Port in der BizTalk Server-Verwaltungskonsole zu erstellen. Bevor Sie jedoch WCF-SQL Port erstellen, müssen Sie die folgenden Aufgaben ausführen, um die Portbindungsdatei zu ändern.

  1. Öffnen Sie die Portbindungsdatei in einem Text-Editor.

  2. Suchen und ersetzen Sie "WCF-Custom" durch den Namen, mit dem Sie den WCF-SQL Adapter in der BizTalk Server-Verwaltungskonsole hinzugefügt haben. Wenn Sie beispielsweise den WCF-SQL Adapter als "SQLAdapter" hinzugefügt haben, ersetzen Sie "WCF-Custom" durch "SQLAdapter".

  3. Suchen Sie nach dem Attribut "ConfigurationClsid", und ersetzen Sie den vorhandenen Wert des Attributs durch "59B35D03-6A06-4734-A249-EF561254ECF7".

  4. Speichern und schließen Sie die Bindungsdatei.

  5. Importieren Sie die Bindungsdatei in der BizTalk Server-Verwaltungskonsole. Anweisungen zum Importieren der Bindungsdatei finden Sie unter Wiederverwenden von Adapterbindungen.

Siehe auch

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