Поделиться через


catalog.add_data_tap_by_guid

Добавляет отвод данных к определенному пути потока данных в потоке данных пакета для экземпляра выполнения.

Синтаксис

add_data_tap_by_guid [ @execution_id = ] execution_id
[ @dataflow_task_guid = ] dataflow_task_guid 
[ @dataflow_path_id_string = ] dataflow_path_id_string
[ @data_filename = ] data_filename
[ @max_rows = ] max_rows
[ @data_tap_id = ] data_tap_id

Аргументы

  • [ @execution\_id = ] execution_id
    Идентификатор выполнения для выполнения, содержащего пакет. Параметр execution_id имеет тип bigint.

  • [ @dataflow\_task\_guid = ] dataflow_task_guid
    Идентификатор задачи потока данных в пакете, который содержит путь потока данных для отвода. Параметр dataflow_task_guid имеет тип uniqueidentifier.

  • [ @dataflow\_path\_id\_string = ] dataflow_path_id_string
    Строка идентификации для пути потока данных. Путь соединяет два компонента потока данных. Свойство IdentificationString для пути определяет строку.

    Чтобы найти строку идентификации, в SQL Server Data Tools щелкните правой кнопкой мыши путь между двумя компонентами потока данных, а затем выберите Свойства. Свойство IdentificationString отображается в окне Свойства.

    Параметр dataflow_path_id_string имеет тип nvarchar(4000).

  • [ @data\_filename = ] data_filename
    Имя файла, в котором хранятся полученные данные. Если задача потока данных выполняется внутри контейнера «цикл по каждому элементу» или «цикл по элементам», то полученные данные для каждого прохода цикла хранятся в отдельных файлах. Каждому файлу добавляется префикс с номером, соответствующим итерации. Файлы отвода данных записываются в папку «<SQL Server installation folder>\110\DTS\». Параметр data_filename имеет тип nvarchar(4000).

  • [ @max\_rows = ] max_rows
    Количество строк, полученных при отводе данных. Если это значение не задано, фиксируются все строки. Параметр max_rows имеет тип int.

  • [ @data\_tap\_id = ] data_tap_id
    Идентификатор отвода данных. Параметр data_tap_id имеет тип bigint.

Пример

В следующем примере отвод данных создан в пути потока данных Paths[SRC DimDCVentor.OLE DB Source Output], в задаче потока данных {D978A2E4-E05D-4374-9B05-50178A8817E8}. Полученные данные хранятся в файле 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' 

Замечания

Чтобы добавить отводы данных, экземпляр выполнения должен быть создан (значение 1 в столбце status представления catalog.operations (база данных SSISDB)). Значения состояния изменяются после запуска выполнения. Выполнение вы можете создать путем вызова catalog.create_execution (база данных SSISDB).

Далее приведены замечания по использованию хранимой процедуры add_data_tap_by_guid.

  • Добавленный отвод данных не проверяется перед запуском пакета.

  • Рекомендуется ограничить число строк, полученных во время прослушивания данных, чтобы избежать формирования больших файлов данных. Если на компьютере, на котором выполняется хранимая процедура, не хватает места для хранения файлов данных, выполнение хранимой процедуры прекращается.

  • Выполнение хранимой процедуры add_data_tap_by_guid влияет на производительность пакета. Поэтому рекомендуется запускать эту хранимую процедуру только для диагностики проблем с данными.

  • Чтобы открыть файл, в котором хранятся отведенные данные, требуются разрешения администратора на том компьютере, где выполняется хранимая процедура, либо нужно быть пользователем, запустившим выполнение, которое содержит пакет с отводом данных.

Коды возврата

0 (успешное завершение)

В случае отказа хранимой процедуры выдается ошибка.

Результирующий набор

Нет

Разрешения

Эта хранимая процедура требует применения одного из следующих разрешений:

  • Разрешения MODIFY на экземпляр выполнения

  • Членство в роли базы данных ssis_admin

  • Членство в роли сервера sysadmin

Ошибки и предупреждения

В следующем списке описываются условия, приводящие к сбою хранимой процедуры.

  • Пользователь не имеет разрешений MODIFY.

  • Отвод данных для указанного компонента, в указанном пакете, уже был добавлен.

  • Указано неправильное число получаемых строк.

См. также

Справочник

catalog.add_data_tap