Sql Server Custom Connection Manager (ejemplo)

  • Artículo

Actualizado: 14 de abril de 2006

En el ejemplo SQL Server Custom Connection Manager se muestra cómo crear un administrador de conexión personalizado (el administrador de conexión SQL) y su interfaz de usuario asociada. Este ejemplo no es compatible con los sistemas operativos basados en Itanium.

Para obtener más información acerca de cómo crear un administrador de conexión personalizado, vea Creating a Custom Connection Manager. Para obtener información acerca del uso de los administradores de conexión en Integration Services, vea Conexiones de Integration Services y Administradores de conexión.

Este administrador de conexión personalizado se conecta a una instancia de Microsoft SQL Server disponible con el proveedor de datos de .NET Framework SqlClient; se devuelve un objeto SqlConnection abierto a partir de su método AcquireConnection. Cuando cree una nueva instancia del administrador de conexión SQL en un paquete, su interfaz de usuario personalizada le pide el nombre del servidor y de una base de datos. El ejemplo sólo se conecta a una instancia predeterminada de SQL Server y únicamente usa la autenticación de Windows.

Este ejemplo de código implementa la siguiente funcionalidad:

ms345276.note(es-es,SQL.90).gifImportante:
Los ejemplos se proporcionan exclusivamente con fines formativos. No se han diseñado para utilizarse en un entorno de producción y no se han probado en ningún entorno de este tipo. Microsoft no ofrece soporte técnico para estos ejemplos.

Ejecutar el ejemplo

Si ya sabe cómo ubicar, generar e instalar los ejemplos de código, puede pasar directamente a la sección Probar el ejemplo y leer acerca de la configuración y ejecución del ejemplo de código

Requisitos previos

Este ejemplo requiere que estén instalados los siguientes componentes.

  • Microsoft Visual Studio 2005
  • Microsoft SQL Server 2005 Integration Services

Ubicación

Si el ejemplo de código se ha instalado en la ubicación predeterminada, el ejemplo se encuentra en el siguiente directorio:

C:\Archivos de programa\Microsoft SQL Server\100\Ejemplos\Integration Services\\Programming Samples\Control Flow\SqlConnectionManager Sample

La solución C# del ejemplo de código se encuentra en el directorio SqlConnMgrCS, mientras que la solución Visual Basic se encuentra en el directorio SqlConnMgrVB.

Para obtener información acerca del proceso de dos pasos necesario para instalar los ejemplos, vea Instalar ejemplos. Para obtener la última versión de los ejemplos, incluidos aquéllos comercializados tras la versión comercial original de SQL Server 2005, vea el artículo acerca de ejemplos y bases de datos de ejemplo de SQL Server 2005 publicado en abril de 2006.

Generar el ejemplo

Si aún no ha generado un archivo de clave de nombre seguro en la carpeta Samples, siga este procedimiento para generarlo. Los proyectos de ejemplo se configuran en la ficha Firma del cuadro de diálogo Propiedades del proyecto para firmar los ensamblados en tiempo de generación con este archivo de clave.

Para generar un archivo de clave de nombre seguro

  1. Para abrir un símbolo del sistema de Microsoft Visual Studio 2005, haga clic en Inicio, seleccione Todos los programas, Microsoft Visual Studio 2005, Visual Studio Tools y, después, haga clic en Símbolo del sistema de Visual Studio 2005.

    O bien

    Para abrir un símbolo del sistema de Microsoft .NET Framework, haga clic en Inicio, seleccione Todos los programas, seleccione Microsoft .NET Framework SDK v2.0 y haga clic en Símbolo del sistema de SDK.

  2. En el símbolo del sistema, utilice el comando de cambio de directorio (CD) para cambiar la carpeta actual de la ventana del símbolo del sistema a la carpeta Samples. El archivo de clave que cree en esta carpeta se usará en todos los ejemplos de código de SQL Server 2005.

    [!NOTA] Para determinar la carpeta donde se encuentran los ejemplos, haga clic en Inicio, seleccione Todos los programas, Microsoft SQL Server 2005, Documentación y tutoriales y, a continuación, haga clic en el directorio Ejemplos. Si se usó la ubicación de instalación predeterminada, los ejemplos se encuentran en <unidadDelSistema>:\Archivos de programa\Microsoft SQL Server\90\Samples.

  3. En el símbolo del sistema, ejecute el comando siguiente para generar el archivo de clave:

    sn -k SampleKey.snk
    ms345276.note(es-es,SQL.90).gifImportante:
    Para obtener más información acerca del par de claves de nombre seguro, vea el apartado sobre informes de seguridad de nombres seguros y seguridad en .NET Framework en el centro de desarrollo de .NET de MSDN.

  4. Necesitará el símbolo (token) de clave pública del archivo de clave en un paso posterior. Para obtener el símbolo de clave pública, extraiga primero la clave pública del archivo de clave en un archivo nuevo ejecutando el comando siguiente en el símbolo del sistema:

    sn -p SampleKey.snk SampleKeyPublic.snk

    Ahora muestre el símbolo de clave pública del nuevo archivo ejecutando el comando siguiente en el símbolo del sistema:

    sn -t SampleKeyPublic.snk

    Copie el símbolo de clave pública al Portapapeles o guárdelo para usarlo posteriormente.

Para generar el ejemplo en Microsoft Visual Studio 2005

  1. En el menú Archivo | Abrir, haga clic en Proyecto y abra el archivo de solución SqlConnMgrVB.sln o SqlConnMgrCS.sln.

  2. En el Explorador de soluciones, seleccione el proyecto SqlConnMgrVB o SqlConnMgrCS.

  3. Busque el atributo DtsConnection antes de la declaración de clase en el archivo SqlConnMgrCS.cs o el archivo SqlConnMgrVB.vb y reemplace el valor alfanumérico del símbolo (token) de clave pública en la propiedad UITypeName del atributo con el símbolo de clave pública obtenido anteriormente en el archivo de clave.

  4. En el menú Generar, haga clic en Generar solución.

Instalar el ejemplo

Este ejemplo se proporciona en Visual Basic y C#. Para distinguir los ensamblados para cada versión del ejemplo, el nombre del ensamblado de salida lleva anexado CS o VB. Una vez que haya generado correctamente el componente, siga los pasos que se indican a continuación para agregarlo como administrador de conexión en un paquete en Business Intelligence Development Studio.

Para copiar el componente en la carpeta Connections

  1. Abra el Explorador de Windows o la aplicación que prefiera para trabajar en el sistema de archivos.

  2. Copie los ensamblados (SqlConnMgrCS.dll y SqlConnMgrUICS.dll, o SqlConnMgrVB.dll y SqlConnMgrUIVB.dll) en la carpeta Connections que se encuentra en %system%\Archivos de programa\Microsoft SQL Server\90\DTS.

Para instalar el componente en la caché de ensamblados global (GAC) al arrastrar los ensamblados

  1. Abra el Explorador de Windows o la aplicación que prefiera para trabajar en el sistema de archivos.

  2. Arrastre los ensamblados desde la carpeta Connections hasta la carpeta en la que se encuentra la caché de ensamblados global (GAC), en %sistema%\assembly.

Para instalar el componente en la caché de ensamblados global (GAC) mediante gacutil.exe

  1. Abra una ventana del símbolo del sistema.

  2. Escriba los siguientes comandos para instalar la versión C# del componente y la interfaz de usuario en la GAC:

    gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrCS\bin\Debug\SqlConnMgrCS.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrCS\bin\Debug\SqlConnMgrUICS.dll"

    O bien

    Escriba los siguientes comandos para instalar la versión de Visual Basic del componente y la interfaz de usuario en la GAC:

    gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrVB\bin\Debug\SqlConnMgrVB.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrVB\bin\Debug\SqlConnMgrUIVB.dll"

Probar el ejemplo

Ahora puede probar el administrador de conexión personalizado en un paquete.

Para usar el administrador de conexión de ejemplo en un paquete

  1. En el área de administradores de conexión del Diseñador SSIS, haga clic con el botón secundario, seleccione Nueva conexión y, en la lista de los tipos de conexión disponibles, seleccione SQL. Haga clic en Aceptar.

  2. Edite el administrador de conexión nuevo. En el editor del administrador de conexión SQL, indique el nombre de una instancia predeterminada disponible del motor de base de datos de SQL Server y de una base de datos disponible.

Historial de cambios

Versión Historial

14 de abril de 2006
Contenido modificado:
  • Se corrigieron los nombres de archivo y carpeta.