Compartir a través de

Creación del URI de conexión de SQL Server

  • Artículo

El adaptador de Microsoft BizTalk para SQL Server URI de conexión contiene propiedades que usa el adaptador para establecer una conexión con la base de datos SQL Server. En este tema se proporciona información sobre el URI de conexión de SQL Server y se proporcionan vínculos a otros temas que explican cómo especificar un URI en distintos escenarios de programación.

URI de conexión para el adaptador de SQL

Un URI de dirección de punto de conexión típico en WCF se representa como: scheme://hostinfoparams?query_string, donde:

  • scheme es el nombre del esquema.

  • hostinfoparams es información necesaria para establecer la conexión con el host; por ejemplo, un nombre de servidor.

  • query_string es una colección opcional name-value de parámetros delimitados por un signo de interrogación (?).

    El URI de conexión del adaptador de SQL cumple este formato básico y se implementa de la siguiente manera:

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

donde, mssql es el esquema para el URI de conexión de SQL Server.

En la tabla siguiente se explican las propiedades contenidas en el URI de conexión.

Propiedad URI de conexión Category Descripción
[SERVER_NAME] hostinfoparams Nombre del servidor en el que está instalado SQL Server. Si no especifica un valor, el adaptador asume el nombre del servidor como "localhost" y establece una conexión con la base de datos de SQL Server en el servidor local.
[PORTNO] hostinfoparams Número de puerto donde se establece la conexión. Si no especifica un valor, el adaptador se conecta a través del puerto predeterminado.
[DATABASE_INSTANCE_NAME] hostinfoparams Nombre de la instancia de SQL Server a la que se va a conectar. Si no especifica un valor, el adaptador se conecta a la instancia de base de datos predeterminada.
[DATABASE_NAME] hostinfoparams Nombre de la base de datos a la que se va a conectar. Si no especifica un valor, el adaptador se conecta a la base de datos predeterminada.
[PARTNER_SERVER_NAME] query_string Nombre de la base de datos de SQL Server de conmutación por error a la que se va a conectar si la base de datos de SQL Server principal no está disponible. Para obtener más información sobre la alta disponibilidad con respecto a SQL Server, consulte Creación de reflejo de la base de datos en SQL Server.
[INBOUND_ID] query_string Identificador que se agrega al URI de conexión para que sea único. Debe proporcionar este parámetro de conexión si desea generar metadatos para la operación de entrada TypedPolling . Además, en una aplicación de BizTalk, si tiene varias ubicaciones de recepción sondeando la misma base de datos, el identificador de entrada hace que el URI de conexión sea único, lo que permite a los clientes del adaptador recibir mensajes de sondeo de la misma base de datos en diferentes ubicaciones de recepción. Para obtener más información, consulte Recepción de mensajes de sondeo entre varios puertos de recepción de SQL mediante BizTalk Server.

Nota

Para obtener más información sobre estas propiedades de cadena de conexión, vea Propiedad SqlConnection.ConnectionString.

credenciales de SQL Server y el URI de conexión

El adaptador de SQL no admite la especificación de credenciales en el URI de conexión. Para obtener más información sobre cómo especificar credenciales en las aplicaciones que usan el adaptador de SQL, consulte Protección de las aplicaciones SQL.

Usar caracteres especiales en el URI de conexión

El adaptador de SQL no admite la especificación de un URI de conexión que tenga caracteres especiales para cualquiera de los valores de parámetro. Si los valores del parámetro de conexión contienen caracteres especiales, asegúrese de realizar una de las siguientes acciones:

  • Si va a especificar el URI en Visual Studio mediante agregar complemento de referencia de servicio de adaptador o consumir complemento de servicio de adaptador, debe especificarlos tal como está en la pestaña Propiedades del URI , es decir, sin usar caracteres de escape. Si especifica el URI directamente en el campo Configurar un URI y los parámetros de conexión contienen caracteres especiales, debe especificar los parámetros de conexión mediante caracteres de escape adecuados.

    Por ejemplo, si el URI de conexión tiene un parámetro con el nombre sql server, debe especificarlo como sql%20server.

  • Si va a especificar el URI al crear un puerto de envío o recepción en BizTalk Server consola de administración y los parámetros de conexión contienen caracteres especiales, debe especificar los parámetros de conexión mediante caracteres de escape adecuados.

Uso del URI de conexión para conectarse a la base de datos de SQL Server

A continuación se muestra un URI de conexión de ejemplo para el adaptador de SQL.

mssql://sql_server/sql_server_instance//

En el ejemplo anterior, "sql_server" es el nombre del equipo en el que se instala SQL Server, mientras que "sql_server_instance" es el nombre de la instancia de base de datos a la que conectarse. Dado que no se especifica ningún nombre de base de datos, el adaptador se conectará a la base de datos predeterminada.

A continuación se muestra un ejemplo de un URI de conexión en el que la base de datos de SQL Server está instalada en el mismo equipo que el adaptador de SQL. En este ejemplo, el adaptador se conecta a la base de datos "my_database" para la instancia de base de datos "sql_server_instance" en el equipo local.

mssql://localhost/sql_server_instance/my_database/

En este ejemplo, el adaptador se conecta a la base de datos predeterminada para la instancia predeterminada que se ejecuta en el equipo local.

mssql://localhost///

Para obtener información sobre cómo especificar una conexión a la base de datos SQL Server cuando:

Consulte también

Desarrollar las aplicaciones SQL