Freigeben über

Erstellen des SQL Server-Verbindungs-URI

Der Microsoft BizTalk-Adapter für SQL Server-Verbindungs-URI enthält Eigenschaften, die der Adapter zum Herstellen einer Verbindung mit der SQL Server-Datenbank verwendet. Dieses Thema enthält Informationen zum SQL Server-Verbindungs-URI und enthält 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 Endpunktadressen-URI in WCF wird wie folgt dargestellt: scheme://hostinfoparams?query_string

  • Der Schemaname ist der Name des Schemas.

  • hostinfoparams sind Informationen, die erforderlich sind, um die Verbindung mit dem Host herzustellen; z. B. ein Servername.

  • query_string ist eine optionale Namenswertauflistung 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 dabei handelt es sich um das Schema für den SQL Server-Verbindungs-URI.

In der folgenden Tabelle werden die Eigenschaften erläutert, die im Verbindungs-URI enthalten sind.

Connection URI-Eigenschaft Kategorie 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, unter der die Verbindung hergestellt wird. Wenn Sie keinen Wert angeben, verbindet sich der Adapter über den Standardport.
[DATABASE_INSTANCE_NAME] hostinfoparams Name der SQL Server-Instanz, mit der eine Verbindung hergestellt werden soll. Wenn Sie keinen Wert angeben, stellt der Adapter eine Verbindung mit der Standarddatenbankinstanz 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 bereit.
[PARTNER_SERVER_NAME] Abfragezeichenfolge Name der SQL Server-Failoverdatenbank, mit der eine Verbindung hergestellt werden soll, wenn die primäre SQL Server-Datenbank nicht verfügbar ist. Weitere Informationen zur hohen Verfügbarkeit in Bezug auf SQL Server finden Sie unter Datenbankspiegelung in SQL Server.
[INBOUND_ID] Abfragezeichenfolge 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 TypdPolling-eingehenden Vorgang generieren möchten. In einer BizTalk-Anwendung, wenn Sie mehrere Empfangsstellen haben, die dieselbe Datenbank abfragen, sorgt die eingehende ID dafür, dass der Verbindungs-URI eindeutig wird. Dadurch können Adapter-Clients Polling-Nachrichten aus derselben Datenbank an verschiedenen Empfangsstellen empfangen. Weitere Informationen finden Sie unter Empfangen von Polling-Nachrichten über mehrere Empfangsports von SQL mithilfe von BizTalk Server.

Hinweis

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

SQL Server-Anmeldeinformationen und der 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 Sichern Ihrer SQL-Anwendungen.

Verwenden von Sonderzeichen im Verbindungs-URI

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

  • Wenn Sie den URI in Visual Studio mithilfe des Add-Adapter Service Reference Plug-Ins oder des Verbrauchsadapterdienst-Add-Ins angeben, müssen Sie diese as-is 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 mithilfe der richtigen Escapezeichen angeben.

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

  • Wenn Sie den URI beim Erstellen eines Sende- oder Empfangsports in der 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

Nachfolgend sehen Sie einen Beispielverbindungs-URI für den SQL-Adapter.

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 Datenbankinstanz ist, mit dem eine Verbindung hergestellt werden soll. Da kein Datenbankname angegeben ist, stellt der Adapter eine Verbindung mit der Standarddatenbank her.

Nachfolgend sehen Sie ein Beispiel für einen Verbindungs-URI, auf dem die SQL Server-Datenbank auf demselben Computer wie der SQL-Adapter installiert ist. In diesem Beispiel verbindet der Adapter sich mit der Datenbank "my_database" für die Datenbankinstanz "sql_server_instance" auf dem lokalen Computer.

mssql://localhost/sql_server_instance/my_database/

In diesem Beispiel stellt der Adapter eine Verbindung mit der Standarddatenbank für die Standardinstanz auf dem lokalen Computer bereit.

mssql://localhost///

Informationen darüber, wie Sie eine Verbindung mit der SQL Server-Datenbank herstellen, wenn Sie:

Siehe auch

Entwickeln Ihrer SQL-Anwendungen