Share via

catalog.add_data_tap_by_guid

  • Статья

Применимо к: SQL Server Integration Runtime служб SSIS в Фабрика данных Azure

Применимо к:SQL Server

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

Синтаксис

catalog.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>>\130\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'

Remarks

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

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

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

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

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

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

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

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

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

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

None

Разрешения

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

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

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

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

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

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

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

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

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

Требования

См. также:

catalog.add_data_tap