Capture Data Lineage (ejemplo de paquete)

El ejemplo Capture Data Lineage es un paquete que captura información de auditoría. Cuando se ejecuta el paquete, carga cinco archivos configurados de forma idéntica, agrega columnas de información histórica, como nombres de archivos, usando la transformación Auditar y luego carga los datos en una tabla de la base de datos AdventureWorks usando un destino de OLE DB. La tarea Ejecutar SQL crea la tabla Lineage_Fact_Table. Además, trunca la tabla cada vez que se ejecuta el paquete.

Si ejecuta el ejemplo en una versión de Windows que no sea en inglés, es posible que tenga que sustituir el nombre de la carpeta Archivos de programa por el nombre traducido para abrir o ejecutar el ejemplo.

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

Requisitos

La ejecución de este paquete de ejemplo requiere lo siguiente:

• El paquete de ejemplo y los archivos de datos que usa deben instalarse en la unidad local de disco duro.
• Debe haber instalado y tener permisos administrativos para la base de datos AdventureWorks.
• Si tiene la intención de ejecutar el paquete de ejemplo sólo desde la línea de comandos, debe instalar SQL Server 2005 Integration Services (SSIS).
• Si tiene la intención de abrir el paquete en el Diseñador SSIS y ejecutar el paquete de ejemplo, debe instalar Business Intelligence Development Studio.

Para obtener más información sobre cómo instalar los ejemplos, vea el tema relativo a la instalación de paquetes de ejemplo de Integration Services en los Libros en pantalla de SQL Server 2005. 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.

Ubicación del paquete de ejemplo

Si los ejemplos se instalaron en la ubicación de instalación predeterminada, el paquete del ejemplo Capture Data Lineage, CaptureDataLineage.dtsx, se encuentra en la siguiente carpeta:

C:\Archivos de programa\Microsoft SQL Server\90\Samples\Integration Services\Package Samples\CaptureDataLineage Sample\Capture Data Lineage\

Se necesitan los siguientes archivos para ejecutar este paquete de ejemplo.

Archivo	Descripción
CaptureDataLineage.dtsx	Paquete de ejemplo.
Data732.txt	Datos de ejemplo en un archivo plano.
Data733.txt	Datos de ejemplo en un archivo plano.
Data734.txt	Datos de ejemplo en un archivo plano.
Data735.txt	Datos de ejemplo en un archivo plano.
Data736.txt	Datos de ejemplo en un archivo plano.

Ejecutar el ejemplo

El paquete se puede ejecutar desde la línea de comandos mediante la utilidad dtexec, o bien se puede ejecutar en Business Intelligence Development Studio.

Si está utilizando una versión de Windows que no sea en inglés, es posible que tenga que actualizar la propiedad ConnectionString de los administradores de conexión de archivos utilizados en el paquete para poder ejecutar el paquete correctamente. Debe comprobar que la ruta de acceso utilizada en el administrador de conexión es válida en el equipo y, si fuera necesario, modificarla para utilizar el nombre traducido de la carpeta Archivos de programa.

En este ejemplo, quizás tenga que actualizar "Archivos de programa" en la propiedad ConnectionString para el administrador de conexión Datos de ejemplo.

Para ejecutar el paquete mediante dtexec

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

2. Cambie el directorio a C:\Archivos de programa\Microsoft SQL Server\90\DTS\Binn, la ubicación de dtexec.

3. Escriba el siguiente comando:

   dtexec /f "C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Package Samples\CaptureDataLineage Sample\CaptureDataLineage\CaptureDataLineage.dtsx"
   

4. Presione ENTRAR.

Para obtener más información acerca de la ejecución del paquete mediante la utilidad dtexec, vea el tema que trata sobre la utilidad dtexec en los Libros en pantalla de SQL Server 2005.

Para ejecutar el paquete en Business Intelligence Development Studio

1. Abra Business Intelligence Development Studio.

2. En el menú Archivo, seleccione Abrir y haga clic en Proyecto o solución.

3. Busque la carpeta del ejemplo CaptureDataLineage y haga doble clic en el archivo denominado CaptureDataLineage.sln.

4. En el Explorador de soluciones, haga clic con el botón secundario en CaptureDataLineage.dtsx en la carpeta SSIS Packages y, a continuación, haga clic en Ejecutar paquete.

Componentes del ejemplo

La siguiente tabla enumera las tareas, contenedores, adaptadores de datos y transformaciones de Integration Services que se utilizan en el ejemplo.

Elemento

Finalidad

Tarea Ejecutar SQL

La tarea de ejecución de SQL Create Lineage_Fact_Table ejecuta una instrucción SQL que crea la tabla Lineage_Fact_Table la primera vez que se ejecuta el paquete, y luego trunca la tabla cuando se vuelve a ejecutar el paquete.

Tarea Flujo de datos

La tarea de flujo de datos Get Data Lineage Information ejecuta el flujo de datos en el paquete.

Origen de archivo plano

El origen de archivo plano, Extract Data from Files, carga los datos del origen de archivo plano y agrega una columna para el nombre de archivo a cada fila de salida.

Transformación Auditar

La transformación Auditar, Add Data Lineage Information, agrega dos nuevas columnas para la información de linaje a cada fila de salida. Las columnas contienen el nombre de usuario y la hora de inicio.

Nota:

La longitud predeterminada de la columna para el nombre de usuario es de 64 caracteres. Si la organización puede tener nombres de usuario que superen los 64 caracteres, debe actualizar la longitud de la columna mediante el cuadro de diálogo Editor avanzado.

Destino de OLE DB

El destino de OLE DB, Load Data into Lineage_Fact_Table, carga los resultados en la tabal Lineage_Fact_Table de la base de datos AdventureWorks.

Administrador de conexión de varios archivos planos

El administrador de conexión para varios archivos planos Sample Data se conecta a los archivos que tienen la extensión .txt.

Administrador de conexión OLE DB

El administrador de conexión OLE DB (local).AdventureWorks se conecta a la base de datos AdventureWorks en el servidor local.

Resultados del ejemplo

Para ver los resultados de la ejecución del paquete de ejemplo Capture Data Lineage, ejecute la siguiente consulta de Transact-SQL:

Select * from AdventureWorks.dbo.Lineage_Fact_Table

En estos resultados, verá las columnas llenas con los datos recuperados de los archivos planos, con la adición de información de linaje generada en las columnas File Name, User Name y Execution Start Time.