Compartir a través de

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

El URI de conexión del adaptador de Microsoft BizTalk para SQL Server contiene propiedades que el adaptador usa para establecer una conexión a la base de datos de 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 diferentes 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 se adhiere a 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 de URI de conexión Categoría 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] parámetrosdeinformacióndelhost 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] parámetros de información del host 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] cadena_de_consulta Nombre de la base de datos de conmutación por error de SQL Server a la que se va a conectar si la base de datos principal de SQL Server no está disponible. Para obtener más información sobre la alta disponibilidad con respecto a SQL Server, vea Creación de reflejo de la base de datos en SQL Server.
[INBOUND_ID] cadena de consulta Un identificador que añades 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 ubicaciones de recepción diferentes. Para obtener más información, vea Recibir mensajes de sondeo en 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.

Uso de 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 ninguno 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 el complemento "Agregar referencia de servicio de adaptador" o el complemento "Consumir servicio de adaptador", debe especificarlo as-is 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 la consola de administración de BizTalk Server 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 donde se instala la base de datos de SQL Server 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 de SQL Server cuando:

Véase también

Desarrollo de aplicaciones SQL