Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
gäller för:
SQL Server SSIS Integration Runtime i Azure Data Factory
gäller för:SQL Server
Lägger till ett datatryck i en specifik dataflödessökväg i ett paketdataflöde för en instans av körningen.
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
Argument
[ @execution_id = ] execution_id
Körnings-ID:t för körningen som innehåller paketet. Den execution_id är en bigint.
[ @dataflow_task_guid = ] dataflow_task_guid
ID:t för dataaktivitetsflödet i paketet som innehåller dataflödessökvägen som ska knackas.
dataflow_task_guid är enunikidentifierare.
[ @dataflow_path_id_string = ] dataflow_path_id_string
Identifieringssträngen för dataflödessökvägen. En sökväg ansluter två dataflödeskomponenter. Egenskapen IdentificationString för sökvägen anger strängen.
Om du vill hitta identifieringssträngen högerklickar du på sökvägen mellan två dataflödeskomponenter i SQL Server Data Tools och klickar sedan på Egenskaper. Egenskapen IdentificationString visas i fönstret Egenskaper.
dataflow_path_id_string är en nvarchar(4000).
[ @data_filename = ] data_filename
Namnet på den fil som lagrar de avlyssnade data. Om dataflödesaktiviteten körs i en Foreach-loop eller en For Loop-container lagrar separata filer knackade data för varje iteration av loopen. Varje fil är prefix med ett tal som motsvarar en iteration. Datatryckfiler skrivs till mappen "<SQL Server-installationsmappen>\130\DTS\".
data_filename är en nvarchar(4000).
[ @max_rows = ] max_rows
Antalet rader som samlas in under datatryckningen. Om det här värdet inte anges registreras alla rader. max_rows är en int.
[ @data_tap_id = ] data_tap_id
ID:t för datatryckningen. Den data_tap_id är en bigint.
Exempel
I följande exempel skapas ett datatryck på dataflödessökvägen, Paths[SRC DimDCVentor.OLE DB Source Output], i dataflödesaktiviteten {D978A2E4-E05D-4374-9B05-50178A8817E8}. De data som trycks på lagras i filen 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'
Anmärkningar
Om du vill lägga till datatryck måste körningsinstansen vara i det skapade tillståndet (värdet 1 i kolumnen status i kolumnen catalog.operations (SSISDB Database)) . Tillståndsvärdet ändras när du kör körningen. Du kan skapa en körning genom att anropa catalog.create_execution (SSISDB Database).
Följande är överväganden för den add_data_tap_by_guid lagrade proceduren.
När du lägger till ett datatryck verifieras det inte innan paketet körs.
Vi rekommenderar att du begränsar antalet rader som samlas in under datakranen för att undvika att generera stora datafiler. Om den dator där den lagrade proceduren körs, får slut på lagringsutrymme för datafilerna slutar den lagrade proceduren att köras.
Körningen av den add_data_tap_by_guid lagrade proceduren påverkar paketets prestanda. Vi rekommenderar att du bara kör den lagrade proceduren för att felsöka dataproblem.
För att få åtkomst till filen som lagrar avlyssnade data måste du ha administratörsbehörighet på den dator där den lagrade proceduren körs, eller så måste du vara den användare som startade körningen som innehåller paketet med datatryckningen.
Returkoder
0 (lyckades)
När den lagrade proceduren misslyckas utlöser den ett fel.
Resultatuppsättning
Ingen
Behörigheter
Den här lagrade proceduren kräver någon av följande behörigheter:
ÄNDRA behörigheter för körningsinstansen
Medlemskap i ssis_admin databasrollen
Medlemskap i serverrollen sysadmin
Fel och varningar
I följande lista beskrivs villkor som gör att den lagrade proceduren misslyckas.
Användaren har inte BEHÖRIGHET ATT ÄNDRA.
Datatappen för den angivna komponenten i det angivna paketet har redan lagts till.
Det angivna värdet för antalet rader som ska avbildas är ogiltigt.