catalog.add_data_tap_by_guid
platí pro:
SQL Server SSIS Integration Runtime ve službě Azure Data Factory
platí pro:SQL Server
Přidá klepnutí na data do konkrétní cesty toku dat v toku dat balíčku pro instanci spuštění.
Syntax
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
Argumenty
[ @execution_id = ] execution_id
ID spuštění pro spuštění, které obsahuje balíček.
execution_id je bigint.
[ @dataflow_task_guid = ] dataflow_task_guid
ID toku úlohy dat v balíčku, který obsahuje cestu toku dat, na kterou chcete klepnout.
dataflow_task_guid jeuniqueidentifier.
[ @dataflow_path_id_string = ] dataflow_path_id_string
Identifikační řetězec pro cestu toku dat. Cesta spojuje dvě komponenty toku dat. Vlastnost IdentificationString cesty určuje řetězec.
Pokud chcete najít identifikační řetězec, klikněte v nástrojích SQL Server Data Tools pravým tlačítkem myši na cestu mezi dvěma komponentami toku dat a potom klikněte na Vlastnosti. Vlastnost IdentificationString se zobrazí v okně Vlastnosti.
dataflow_path_id_string je nvarchar(4000).
[ @data_filename = ] data_filename
Název souboru, který ukládá klepaná data. Pokud se úloha toku dat spustí uvnitř smyčky Foreach nebo kontejneru For Loop, samostatné soubory ukládají data, která se klepla na data pro každou iteraci smyčky. Každý soubor má předponu čísla, která odpovídá iteraci. Soubory klepněte na data se zapisují do složky "<instalační složka SQL Serveru>\130\DTS\".
data_filename je nvarchar(4000).
[ @max_rows = ] max_rows
Počet řádků zachycených během klepnutí na data Pokud tato hodnota není zadaná, zachytí se všechny řádky. Max_rows je .
[ @data_tap_id = ] data_tap_id
ID klepnutí na data
data_tap_id je bigint.
Příklad
V následujícím příkladu se na cestě toku dat vytvoří klepnutí na data Paths[SRC DimDCVentor.OLE DB Source Output]v úloze toku dat {D978A2E4-E05D-4374-9B05-50178A8817E8}. Klepaná data jsou uložená v souboru 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'
Poznámky
Pokud chcete přidat klepnutí na data, musí být instance spuštění ve vytvořeném stavu (hodnota 1 ve sloupci stavu ve sloupci catalog.operations (databáze SSISDB) zobrazení). Hodnota stavu se po spuštění provádění změní. Spuštění můžete vytvořit voláním catalog.create_execution (databáze SSISDB).
Následující informace jsou důležité pro add_data_tap_by_guid uloženou proceduru.
Když přidáte klepnutí na data, před spuštěním balíčku se neověří.
Doporučujeme omezit počet řádků zachycených během klepnutí na data, abyste se vyhnuli generování velkých datových souborů. Pokud počítač, na kterém je uložená procedura spuštěna, vyčerpá prostor úložiště pro datové soubory, uložená procedura přestane běžet.
Spuštění add_data_tap_by_guid uložené procedury ovlivňuje výkon balíčku. Doporučujeme spustit uloženou proceduru pouze pro řešení problémů s daty.
Pokud chcete získat přístup k souboru, který ukládá klepaná data, musíte mít oprávnění správce na počítači, na kterém je uložená procedura spuštěná, nebo musíte být uživatel, který spustil provádění obsahující balíček s klepnutím na data.
Návratové kódy
0 (úspěch)
Když uložená procedura selže, vyvolá chybu.
Sada výsledků
Žádný
Dovolení
Tato uložená procedura vyžaduje jedno z následujících oprávnění:
ÚPRAVA oprávnění k instanci provádění
Členství v roli databáze ssis_admin
Členství v roli serveru správce systému
Chyby a upozornění
Následující seznam popisuje podmínky, které způsobují selhání uložené procedury.
Uživatel nemá oprávnění MODIFY.
Klepnutí na data pro zadanou komponentu v zadaném balíčku již bylo přidáno.
Hodnota zadaná pro počet řádků, které se mají zachytit, není platná.