catalog.add_data_tap_by_guid

[ @execution_id = ] execution_id

Identificador de ejecución correspondiente a la ejecución que contiene el paquete. El parámetro execution_id es de tipo bigint.

[ @dataflow_task_guid = ] dataflow_task_guid

El identificador del flujo de tarea de datos del paquete que contiene la ruta de flujo de datos que se va a derivar. El parámetro dataflow_task_guid es de tipo uniqueidentifier.

[ @dataflow_path_id_string = ] dataflow_path_id_string

Cadena de identificación de la ruta de flujo de datos. Una ruta de acceso conecta dos componentes de flujo de datos. La propiedad IdentificationString para la ruta de acceso especifica la cadena.

Para buscar la cadena de identificación, en SQL Server Data Tools haga clic con el botón secundario en la ruta de acceso entre dos componentes de flujo de datos y, a continuación, haga clic en Propiedades. La propiedad IdentificationString aparece en la ventana Propiedades.

El parámetro dataflow_path_id_string es de tipo nvarchar(4000).

[ @data_filename = ] data_filename

Nombre del archivo que almacena los datos derivados. Si la tarea Flujo de datos se ejecuta en un bucle Foreach o en un contenedor de bucles For, los datos derivados se almacenan en archivos diferentes para cada iteración del bucle. Cada archivo tiene como prefijo un número que corresponde a una iteración. Los archivos de derivación de datos se escriben en la carpeta "<SQL Server installation folder>\110\DTS\". El parámetro data_filename es de tipo nvarchar(4000).

[ @max_rows = ] max_rows

Número de filas que se capturan durante la derivación de datos. Si no se especifica este valor, se capturan todas las filas. El valor max_rows es de tipo int.

[ @data_tap_id = ] data_tap_id

Identificador de la derivación de datos. El parámetro data_tap_id es de tipo bigint.

En el ejemplo siguiente, se crea una derivación de datos en la ruta de flujo de datos, Paths[SRC DimDCVentor.OLE DB Source Output], en la tarea de flujo de datos {D978A2E4-E05D-4374-9B05-50178A8817E8}. Los datos derivados se almacenan en el archivo DCVendorOutput.csv.

exec catalog.add_data_tap_by_guid   @execution_id, 
'{D978A2E4-E05D-4374-9B05-50178A8817E8}', 
'Paths[SRC DimDCVentor.OLE DB Source Output]', 
'D:\demos\datafiles\DCVendorOutput.csv' 

Para agregar derivaciones de datos, la instancia de la ejecución debe estar en el estado creado (un valor 1 en la columna status de la vista catalog.operations (base de datos de SSISDB)). El valor de estado cambia cuando se ejecuta la ejecución. Puede crear una ejecución llamando a catalog.create_execution (base de datos de SSISDB).

A continuación se indican algunas consideraciones sobre el procedimiento almacenado add_data_tap_by_guid.

• Al agregar una derivación de datos, esta no se valida antes de que se ejecute el paquete.

• Se recomienda que limite el número de filas que se capturan durante la derivación de datos para evitar que se generen archivos de datos grandes. Si el equipo en el que se ejecuta el procedimiento almacenado se queda sin espacio para almacenar los archivos de datos, se detiene la ejecución del procedimiento almacenado.

• La ejecución del procedimiento almacenado add_data_tap_by_guid afecta al rendimiento del paquete. Se recomienda que ejecute el procedimiento almacenado solo para solucionar problemas de datos.

• Para tener acceso al archivo que almacena los datos derivados, debe tener permisos de administrador en el equipo en el que se ejecuta el procedimiento almacenado o debe ser el usuario que inició la ejecución que contiene el paquete con la derivación de datos.

0 (correcto)

Cuando se produce un error en el procedimiento almacenado, se genera un error.

Ninguno

Este procedimiento almacenado necesita uno de los permisos siguientes:

• Permisos MODIFY en la instancia de ejecución

• Pertenencia al rol de base de datos ssis_admin

• Pertenencia al rol de servidor sysadmin

En la lista siguiente se describen las condiciones que hacen que el procedimiento almacenado genere un error.

• El usuario no tiene permisos MODIFY.

• La derivación de datos para el componente especificado, en el paquete indicado, ya se ha agregado.

• El valor especificado para el número de filas para capturar no es válido.

Referencia