Partager via

Créer l’URI de connexion SQL Server

  • Article

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 pour l’adaptateur SQL

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

  • scheme est le nom du schéma.

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

  • query_string est une collection nom-valeur facultative de paramètres délimités 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ù, mssql est 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 Category Description
[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 du SQL Server instance auquel se connecter. Si vous ne spécifiez pas de valeur, l’adaptateur se connecte à la base de données par défaut instance.
[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] query_string Nom de la base de données de basculement SQL Server à laquelle se connecter si la base de données SQL Server principale n’est pas disponible. Pour plus d’informations sur la haute disponibilité en ce qui concerne les SQL Server, consultez 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 vous avez plusieurs emplacements de réception interrogeant la même base de données, l’ID entrant rend l’URI de connexion unique, ce qui permet aux clients d’adaptateur de recevoir des messages d’interrogation 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 de SQL à l’aide de BizTalk Server.

Notes

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

SQL Server informations d’identification et l’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 des 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 comportant des caractères spéciaux pour les 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 Add Adapter Service Reference plug-in ou Consume Adapter Service Add-in, vous devez le spécifier tel quel dans l’onglet Propriétés de l’URI , c’est-à-dire 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 des caractères d’échappement appropriés.

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

  • Si vous spécifiez l’URI lors de la création d’un port d’envoi ou de réception dans BizTalk Server console Administration et que les paramètres de connexion contiennent des caractères spéciaux, vous devez spécifier les paramètres de connexion à l’aide des 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 la base de données à laquelle se connecter instance. É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 la base de données « sql_server_instance » 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 le 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évelopper vos applications SQL