Remove Duplicates with UI Component (ejemplo)

Artículo
12/15/2008

El ejemplo Remove Duplicates muestra la implementación de un componente de transformación de flujo de datos con salidas asincrónicas. Los componentes que tienen salidas asincrónicas reciben una entrada PipelineBuffer y una salida PipelineBuffer que se corresponden con la entrada y la salida del objeto, respectivamente. Los búferes de entrada contienen filas proporcionadas por componentes requeridos. El búfer de salida se encuentra vacío y lo llena el componente, normalmente mediante las filas del búfer de entrada, durante una llamada al método ProcessInput. Una vez que se han recibido todas las filas, se ordenan y, a continuación, las filas distintas se envían a una salida y las filas duplicadas a la otra. Este ejemplo no es compatible con los sistemas operativos basados en Itanium.

Importante:
Los ejemplos de código de programación de flujo de datos de Integration Services tienen como objetivo mostrar la funcionalidad básica que se debe implementar para crear un componente de flujo de datos personalizado. Los ejemplos no incluyen compatibilidad completa para permitir su personalización en el Editor avanzado. Por ejemplo, no puede usar el Editor avanzado para agregar o quitar entradas y salidas ni para configurar columnas. 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.

Los ejemplos de código de programación de flujo de datos de Integration Services tienen como objetivo mostrar la funcionalidad básica que se debe implementar para crear un componente de flujo de datos personalizado. Los ejemplos no incluyen compatibilidad completa para permitir su personalización en el Editor avanzado. Por ejemplo, no puede usar el Editor avanzado para agregar o quitar entradas y salidas ni para configurar columnas. 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 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

Para este ejemplo, es necesario instalar los siguientes componentes.

Microsoft Visual Studio 2005
Microsoft SQL Server 2005 Integration Services

Ubicación

Si los ejemplos de código se instalaron en la ubicación de instalación predeterminada, la versión C# del ejemplo de código se encuentra en la siguiente carpeta:

C:\Archivos de programa\Microsoft SQL Server\100\Ejemplos\Integration Services\\Programming Samples\Data Flow\RemoveDuplicatesWithUI Component Sample\CS

[!NOTA] La versión del ejemplo RemoveDuplicates que incluye una interfaz de usuario personalizada se proporciona únicamente en el lenguaje de programación C#.

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 están configurados para firmar los ensamblados en tiempo de generación con este archivo de clave. Puede ver las propiedades de firma en la ficha Firma del cuadro de diálogo Propiedades del proyecto.

Para generar un archivo de clave de nombre seguro

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 SDK Command Prompt.
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.

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

sn -k SampleKey.snk

Importante:
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.

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

En el menú Archivo | Abrir, haga clic en Proyecto y abra RemoveDuplicatesWithUI.sln.
Busque el atributo DtsPipelineComponent antes de la declaración de clase en el archivo RemoveDuplicates.cs o el archivo RemoveDuplicates.vb, y reemplace el valor alfanumérico de símbolo (token) de clave pública en la propiedad UITypeName del atributo con el símbolo (token) de clave pública obtenido anteriormente en el archivo de clave.
En el menú Generar, haga clic en Generar RemoveDuplicatesWithUI para generar la solución.

Instalar el ejemplo

Este ejemplo sólo se proporciona en C#. Una vez que haya generado correctamente el componente, siga los pasos que se indican a continuación para agregarlo a una tarea Flujo de datos en Business Intelligence Development Studio.

Para copiar el componente en la carpeta PipelineComponents

Abra el Explorador de Windows o la aplicación que prefiera para trabajar en el sistema de archivos.
Copie el ensamblado (RemoveDuplicatesWithUICS.dll) en la carpeta PipelineComponents 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 el ensamblado

Abra el Explorador de Windows o la aplicación que prefiera para trabajar en el sistema de archivos.
Arrastre el ensamblado desde la carpeta PipelineComponents a la carpeta donde 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

Abra una ventana del símbolo del sistema.
Escriba el siguiente comando para ejecutar gacutil.exe e instale la versión C# del componente en la GAC:

gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\RemoveDuplicatesWithUICS.dll"

Para agregar el componente al cuadro de herramientas

Abra Business Intelligence Development Studio.
Haga clic con el botón secundario en el cuadro de herramientas y, a continuación, haga clic en Elegir elementos.
En el cuadro de diálogo Elegir elementos del cuadro de herramientas, haga clic en la ficha Elementos de flujo de datos SSIS.
Haga clic en la casilla de verificación junto al componente y, después, haga clic en Aceptar.

[!NOTA] Si el componente no se muestra en la lista, puede hacer clic en Examinar para buscarlo. No obstante, en este caso puede que no esté instalado correctamente.

Después de completar estos pasos, el componente queda visible en la ficha Elementos de flujo de datos del Cuadro de herramientas y se puede agregar a la tarea Flujo de datos en el Diseñador SSIS.

Probar el ejemplo

Después de agregar el componente a una tarea Flujo de datos de un paquete y conectarlo a un componente que le proporcionará filas, puede configurarlo de la manera siguiente en el Diseñador de SSIS.

Para configurar el componente de ejemplo en un paquete

Seleccione las columnas que va a usar el componente en el editor personalizado del componente. Sólo se pasan al siguiente componente del flujo de datos las columnas seleccionadas. El contenido de cada columna se evalúa para determinar si una fila coincide con otras filas.