Cómo documentar el flujo de datos de un paquete SSIS

El elemento de flujo de datos es una parte de un paquete SSIS que contiene diferentes tipos de componentes de flujo de datos:

• Componentes fuente – vuelven disponibles datos de diferentes tipos de fuentes para un flujo de datos
• Componentes transformacionales – agregan, combinan, distribuyen y modifican los datos dentro de una corriente de datos y
• Componentes destino – cargan los datos desde un flujo de datos en diferentes tipos de fuentes de datos o crean datos en conjuntos de datos en memoria

Aparte de esto, el componente Path (conexión) entre componentes de entrada y salida define la secuencia de componentes y permite añadir anotaciones al flujo de datos. Una ruta conecta dos componentes en un flujo de datos conectando la salida de un componente de flujo a la entrada de otro componente:

En desarrollo, la tarea de documentar el flujo de datos significa especificar un nombre de tarea descriptivo, adicionar una anotación o explicar la tarea adicionalmente en el campo Description. El problema es que cada vez que esta información necesita ser usada o editada, el paquete tiene que ser reabierto en desarrollo. Esto se vuelve complicado si el paquete es complejo de una manera que contiene múltiples tareas de control de flujo con múltiples diagramas de flujo de datos.

También, no hay opción en desarrollo para exportar el diagrama de flujo de datos, ni como imagen ni en ninguna otra forma. Una simple captura de pantalla puede ser útil, pero está limitada a tareas de visibilidad en la pestaña Data flow. Cuando hay una necesidad de exportar, en algunos casos el diagrama de flujo de datos no es completamente visible ya que podría contener numerosas tareas. Para sobreponerse a esto, el diagrama necesita ser ampliado para mostrar todas las tareas. Sin embargo, disminuir el tamaño del diagrama puede hacer que las tareas no se muestren apropiadamente y puede hacer que el diagrama sea difícil de explorar.

Otro problema es que el flujo de datos en sí mismo no contiene toda la información necesaria y la documentación requiere datos adicionales a ser recolectados. Esto también es un problema, ya que no hay una manera para grabar toda la información en un documento amigable para el usuario.

ApexSQL Doc es una herramienta de documentación de paquetes SSIS y bases de datos que genera documentación detallada y amigable al usuario en varios formatos: CHM, HTML, DOC, DOCX y PDF.

Esta documentación de paquetes SSIS incluye flujos de datos y diagramas de control de flujo, y todas las propiedades para los componentes especificados del paquete. ApexSQL Doc puede documentar paquetes desde el archivo del sistema, SQL Server y SSIS Package Store. En adición a esto, el proceso de documentación puede ser programado a través de la Interface de Línea de Comandos y correr desatendido. Para documentar un paquete SSIS:

1. Inicie ApexSQL Doc como administrador
2. Bajo la pestaña Home en el grupo Projects, haga clic en el botón New para iniciar un nuevo proyecto

3. Abra el diálogo de conexión para paquetes SSIS seleccionado la pestaña Integration services, y haga clic en el botón Add:



4. En el diálogo Add integration services seleccione una fuente de paquete apropiada, navegue al paquete que desea documentar y haga clic en el botón Connect:



5. Una vez conectado, el paquete está listado en la sección Package selection:



6. En la sección Package details, seleccione los atributos del paquete a incluir en la documentación:



7. Cuando esto esté configurado, desde la pestaña Home en el grupo Actions, haga clic en el botón Generate:



8. Cuando la documentación esté finalizada, navegue a un nodo apropiado en la documentación para encontrar el diagrama de flujo de datos:

Traductor: Daniel Calbimonte