Partage via

Créer l’URI de connexion SQL Server

L’URI de connexion de l’adaptateur Microsoft BizTalk pour SQL Server contient les propriétés que l’adaptateur utilise pour établir une connexion à la base de données SQL Server. Cette rubrique fournit des informations sur l’URI de connexion SQL Server et fournit des liens vers d’autres rubriques qui expliquent comment spécifier un URI dans différents scénarios de programmation.

URI de connexion de l’adaptateur SQL

Un URI d’adresse de point de terminaison classique dans WCF est représenté comme : scheme://hostinfoparams?query_string, où :

  • scheme est le nom du protocole.

  • hostinfoparams est des informations requises pour établir la connexion à l’hôte ; par exemple, un nom de serveur.

  • query_string est une collection facultative nom-valeur de paramètres délimitée par un point d’interrogation ( ?).

    L’URI de connexion de l’adaptateur SQL respecte ce format de base et est implémenté comme suit :

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

où est mssql le schéma de l’URI de connexion SQL Server.

Le tableau suivant décrit les propriétés contenues dans l’URI de connexion.

Propriété : URI de connexion Catégorie Descriptif
[SERVER_NAME] hostinfoparams Nom du serveur sur lequel SQL Server est installé. Si vous ne spécifiez pas de valeur, l’adaptateur suppose que le nom du serveur est « localhost » et établit une connexion avec la base de données SQL Server sur le serveur local.
[PORTNO] hostinfoparams Numéro de port où la connexion est établie. Si vous ne spécifiez pas de valeur, l’adaptateur se connecte via le port par défaut.
[DATABASE_INSTANCE_NAME] hostinfoparams Nom de l’instance SQL Server à laquelle se connecter. Si vous ne spécifiez pas de valeur, l’adaptateur se connecte à l’instance de base de données par défaut.
[DATABASE_NAME] hostinfoparams Nom de la base de données à laquelle se connecter. Si vous ne spécifiez pas de valeur, l’adaptateur se connecte à la base de données par défaut.
[PARTNER_SERVER_NAME] chaîne de requête Nom de la base de données SQL Server de basculement à laquelle se connecter si la base de données SQL Server principale n’est pas disponible. Pour plus d’informations sur la haute disponibilité concernant SQL Server, consultez La mise en miroir de bases de données dans SQL Server.
[INBOUND_ID] query_string Identificateur que vous ajoutez à l’URI de connexion pour le rendre unique. Vous devez fournir ce paramètre de connexion si vous souhaitez générer des métadonnées pour l’opération entrante TypedPolling . En outre, dans une application BizTalk, si plusieurs emplacements de réception interrogent la même base de données, l’ID entrant rend l’URI de connexion unique, ce qui permet aux clients d’adaptateurs de recevoir des messages d’interrogation à partir de la même base de données sur différents emplacements de réception. Pour plus d’informations, consultez Recevoir des messages d’interrogation sur plusieurs ports de réception à partir de SQL à l’aide de BizTalk Server.

Remarque

Pour plus d’informations sur ces propriétés de chaîne de connexion, consultez La propriété SqlConnection.ConnectionString.

Informations d’identification SQL Server et URI de connexion

L’adaptateur SQL ne prend pas en charge la spécification des informations d’identification dans l’URI de connexion. Pour plus d’informations sur la spécification d’informations d’identification dans vos applications qui utilisent l’adaptateur SQL, consultez Sécuriser vos applications SQL.

Utilisation de caractères spéciaux dans l’URI de connexion

L’adaptateur SQL ne prend pas en charge la spécification d’un URI de connexion qui a des caractères spéciaux pour l’une des valeurs de paramètre. Si les valeurs des paramètres de connexion contiennent des caractères spéciaux, assurez-vous d’effectuer l’une des opérations suivantes :

  • Si vous spécifiez l’URI dans Visual Studio à l’aide du plug-in Ajouter une référence de service d’adaptateur ou du complément Consommer un service d’adaptateur, vous devez spécifier as-is dans l’onglet Propriétés de l’URI, autrement dit, sans utiliser de caractères d’échappement. Si vous spécifiez l’URI directement dans le champ Configurer un URI et que les paramètres de connexion contiennent des caractères spéciaux, vous devez spécifier les paramètres de connexion à l’aide de caractères d’échappement appropriés.

    Par exemple, si l’URI de connexion a un paramètre portant le nom sql server, vous devez le spécifier en tant que sql%20server.

  • Si vous spécifiez l’URI lors de la création d’un port d’envoi ou de réception dans la console Administration de BizTalk Server et que les paramètres de connexion contiennent des caractères spéciaux, vous devez spécifier les paramètres de connexion à l’aide de caractères d’échappement appropriés.

Utilisation de l’URI de connexion pour se connecter à la base de données SQL Server

Voici un exemple d’URI de connexion pour l’adaptateur SQL.

mssql://sql_server/sql_server_instance//

Dans l’exemple précédent, « sql_server » est le nom de l’ordinateur sur lequel SQL Server est installé, tandis que « sql_server_instance » est le nom de l’instance de base de données à laquelle se connecter. Étant donné qu’aucun nom de base de données n’est spécifié, l’adaptateur se connecte à la base de données par défaut.

Voici un exemple d’URI de connexion où la base de données SQL Server est installée sur le même ordinateur que l’adaptateur SQL. Dans cet exemple, l’adaptateur se connecte à la base de données « my_database » pour l’instance de base de données « sql_server_instance » sur l’ordinateur local.

mssql://localhost/sql_server_instance/my_database/

Dans cet exemple, l’adaptateur se connecte à la base de données par défaut pour l’instance par défaut s’exécutant sur l’ordinateur local.

mssql://localhost///

Pour plus d’informations sur la façon de spécifier une connexion à la base de données SQL Server lorsque vous :

Voir aussi

Développez vos applications SQL

  • Last updated on