Freigeben über

Erstellen des SQL Server Verbindungs-URI

  • Artikel

Der Microsoft BizTalk-Adapter für SQL Server Verbindungs-URI enthält Eigenschaften, die der Adapter verwendet, um eine Verbindung mit der SQL Server-Datenbank herzustellen. Dieses Thema enthält Informationen zum SQL Server Verbindungs-URI sowie Links zu anderen Themen, in denen erläutert wird, wie ein URI in verschiedenen Programmierszenarien angegeben wird.

Der Verbindungs-URI für den SQL-Adapter

Ein typischer Endpunktadress-URI in WCF wird wie folgt dargestellt: scheme://hostinfoparams?query_string

  • scheme ist der Schemaname.

  • hostinfoparams sind Informationen, die zum Herstellen der Verbindung mit dem Host erforderlich sind. z. B. ein Servername.

  • query_string ist eine optionale Name-Wert-Auflistung von Parametern, die durch ein Fragezeichen (?) getrennt sind.

    Der SQL-Adapterverbindungs-URI entspricht diesem grundlegenden Format und wird wie folgt implementiert:

  
mssql://[Server_Name[:Portno]]/[Database_Instance_Name]/[Database_Name]?FailoverPartner=[Partner_Server_Name]&InboundId=[Inbound_ID]

mssql wobei das Schema für den SQL Server Verbindungs-URI ist.

In der folgenden Tabelle werden die Im Verbindungs-URI enthaltenen Eigenschaften erläutert.

Verbindungs-URI-Eigenschaft Category BESCHREIBUNG
[SERVER_NAME] hostinfoparams Name des Servers, auf dem SQL Server installiert ist. Wenn Sie keinen Wert angeben, nimmt der Adapter den Servernamen als "localhost" an und stellt eine Verbindung mit der SQL Server Datenbank auf dem lokalen Server her.
[PORTNO] hostinfoparams Die Portnummer, an der die Verbindung hergestellt wird. Wenn Sie keinen Wert angeben, stellt der Adapter eine Verbindung über den Standardport her.
[DATABASE_INSTANCE_NAME] hostinfoparams Name des SQL Server instance, mit dem eine Verbindung hergestellt werden soll. Wenn Sie keinen Wert angeben, stellt der Adapter eine Verbindung mit der Standarddatenbank instance her.
[DATABASE_NAME] hostinfoparams Name der Datenbank, mit der eine Verbindung hergestellt werden soll. Wenn Sie keinen Wert angeben, stellt der Adapter eine Verbindung mit der Standarddatenbank her.
[PARTNER_SERVER_NAME] query_string Name des Failovers SQL Server Datenbank, mit der eine Verbindung hergestellt werden soll, wenn die primäre SQL Server Datenbank nicht verfügbar ist. Weitere Informationen zur Hochverfügbarkeit in Bezug auf SQL Server finden Sie unter Datenbankspiegelung in SQL Server.
[INBOUND_ID] query_string Ein Bezeichner, den Sie dem Verbindungs-URI hinzufügen, um ihn eindeutig zu machen. Sie müssen diesen Verbindungsparameter angeben, wenn Sie Metadaten für den Eingehenden TypedPolling-Vorgang generieren möchten. Wenn in einer BizTalk-Anwendung mehrere Empfangsorte die gleiche Datenbank abfragen, macht die eingehende ID den Verbindungs-URI eindeutig, sodass Adapterclients Abrufnachrichten aus derselben Datenbank an verschiedenen Empfangsstandorten empfangen können. Weitere Informationen finden Sie unter Empfangen von Abrufnachrichten über mehrere Empfangsports von SQL mit BizTalk Server.

Hinweis

Weitere Informationen zu diesen Verbindungszeichenfolge Eigenschaften finden Sie unter SqlConnection.ConnectionString-Eigenschaft.

SQL Server Anmeldeinformationen und den Verbindungs-URI

Der SQL-Adapter unterstützt die Angabe von Anmeldeinformationen im Verbindungs-URI nicht. Weitere Informationen zum Angeben von Anmeldeinformationen in Ihren Anwendungen, die den SQL-Adapter verwenden, finden Sie unter Schützen Ihrer SQL-Anwendungen.

Verwenden von Sonderzeichen im Verbindungs-URI

Der SQL-Adapter unterstützt die Angabe eines Verbindungs-URI mit Sonderzeichen für einen der Parameterwerte nicht. Wenn die Verbindungsparameterwerte Sonderzeichen enthalten, stellen Sie sicher, dass Sie eines der folgenden Schritte ausführen:

  • Wenn Sie den URI in Visual Studio mithilfe des Adapterdienstverweis-Plug-Ins hinzufügen oder das Adapterdienst-Add-In nutzen angeben, müssen Sie ihn unverändert auf der Registerkarte URI-Eigenschaften angeben, d. h. ohne Escapezeichen. Wenn Sie den URI direkt im Feld URI konfigurieren angeben und die Verbindungsparameter Sonderzeichen enthalten, müssen Sie die Verbindungsparameter mit geeigneten Escapezeichen angeben.

    Wenn der Verbindungs-URI beispielsweise über einen Parameter mit dem Namen sql serververfügt, müssen Sie ihn als sql%20serverangeben.

  • Wenn Sie den URI beim Erstellen eines Sende- oder Empfangsports in BizTalk Server Verwaltungskonsole angeben und die Verbindungsparameter Sonderzeichen enthalten, müssen Sie die Verbindungsparameter mithilfe der richtigen Escapezeichen angeben.

Verwenden des Verbindungs-URI zum Herstellen einer Verbindung mit der SQL Server-Datenbank

Im Folgenden wird ein Beispiel-Verbindungs-URI für den SQL-Adapter angezeigt.

mssql://sql_server/sql_server_instance//

Im vorherigen Beispiel ist "sql_server" der Name des Computers, auf dem SQL Server installiert ist, während "sql_server_instance" der Name der Datenbank ist, mit der instance eine Verbindung hergestellt werden soll. Da kein Datenbankname angegeben wird, stellt der Adapter eine Verbindung mit der Standarddatenbank her.

Im Folgenden sehen Sie ein Beispiel für einen Verbindungs-URI, bei dem die SQL Server-Datenbank auf demselben Computer wie der SQL-Adapter installiert ist. In diesem Beispiel stellt der Adapter eine Verbindung mit der Datenbank "my_database" für die datenbank "sql_server_instance" her, die auf dem lokalen Computer instance.

mssql://localhost/sql_server_instance/my_database/

In diesem Beispiel stellt der Adapter eine Verbindung mit der Standarddatenbank für die Standarddatenbank her, instance auf dem lokalen Computer ausgeführt wird.

mssql://localhost///

Informationen dazu, wie Sie eine Verbindung mit der SQL Server Datenbank angeben, wenn Sie:

Weitere Informationen

Entwickeln Ihrer SQL-Anwendungen