catalog.add_data_tap_by_guid

van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

van toepassing op:SQL Server-

Voegt een gegevenstik toe aan een specifiek gegevensstroompad in een pakketgegevensstroom, voor een exemplaar van de uitvoering.

Syntaxis

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  

Argumenten

[ @execution_id = ] execution_id
De uitvoerings-id voor de uitvoering die het pakket bevat. De execution_id is een grote.

[ @dataflow_task_guid = ] dataflow_task_guid
De id voor de gegevenstaakstroom in het pakket dat het gegevensstroompad bevat waarop moet worden getikt. De dataflow_task_guid is eenuniqueidentifier-.

[ @dataflow_path_id_string = ] dataflow_path_id_string
De identificatietekenreeks voor het gegevensstroompad. Een pad verbindt twee gegevensstroomonderdelen. De eigenschap IdentificationString voor het pad geeft de tekenreeks op.

Als u de identificatietekenreeks wilt vinden, klikt u in SQL Server Data Tools met de rechtermuisknop op het pad tussen twee gegevensstroomonderdelen en klikt u vervolgens op Eigenschappen. De eigenschap IdentificationString wordt weergegeven in het venster Eigenschappen.

De dataflow_path_id_string is een nvarchar(4000).

[ @data_filename = ] data_filename
De naam van het bestand waarin de getikte gegevens worden opgeslagen. Als de gegevensstroomtaak wordt uitgevoerd in een Foreach-lus of een For Loop-container, worden getikte gegevens opgeslagen voor elke herhaling van de lus. Elk bestand wordt voorafgegaan door een getal dat overeenkomt met een iteratie. Gegevenstikbestanden worden geschreven naar de map '<SQL Server-installatiemap>\130\DTS\'. De data_filename is een nvarchar(4000).

[ @max_rows = ] max_rows
Het aantal rijen dat wordt vastgelegd tijdens de gegevenstik. Als deze waarde niet is opgegeven, worden alle rijen vastgelegd. De max_rows is een int.

[ @data_tap_id = ] data_tap_id
De id van de gegevenstik. De data_tap_id is een .

Voorbeeld

In het volgende voorbeeld wordt een gegevenstik gemaakt op het gegevensstroompad, Paths[SRC DimDCVentor.OLE DB Source Output], in de gegevensstroomtaak {D978A2E4-E05D-4374-9B05-50178A8817E8}. De getikte gegevens worden opgeslagen in het DCVendorOutput.csv-bestand.

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'  

Opmerkingen

Als u gegevenstikken wilt toevoegen, moet het exemplaar van de uitvoering de status gemaakt hebben (een waarde van 1 in de kolom status kolom van de catalog.operations (SSISDB-database) weergave). De statuswaarde wordt gewijzigd zodra u de uitvoering uitvoert. U kunt een uitvoering maken door catalog.create_execution (SSISDB Database) aan te roepen.

Hier volgen overwegingen voor de add_data_tap_by_guid opgeslagen procedure.

• Wanneer u een gegevenstik toevoegt, wordt deze niet gevalideerd voordat het pakket wordt uitgevoerd.

• Het wordt aanbevolen om het aantal rijen dat tijdens de gegevenstik wordt vastgelegd, te beperken om te voorkomen dat grote gegevensbestanden worden gegenereerd. Als de computer waarop de opgeslagen procedure wordt uitgevoerd, onvoldoende opslagruimte voor de gegevensbestanden heeft, wordt de opgeslagen procedure niet meer uitgevoerd.

• Het uitvoeren van de add_data_tap_by_guid opgeslagen procedure is van invloed op de prestaties van het pakket. Het is raadzaam om de opgeslagen procedure alleen uit te voeren om gegevensproblemen op te lossen.

• Als u toegang wilt krijgen tot het bestand waarin de getikte gegevens zijn opgeslagen, moet u beheerdersmachtigingen hebben op de computer waarop de opgeslagen procedure wordt uitgevoerd, of moet u de gebruiker zijn die de uitvoering heeft gestart die het pakket bevat met de gegevenstik.

Retourcodes

0 (geslaagd)

Wanneer de opgeslagen procedure mislukt, treedt er een fout op.

Resultatenset

Geen

Machtigingen

Voor deze opgeslagen procedure zijn een van de volgende machtigingen vereist:

• MACHTIGINGEN WIJZIGEN voor het exemplaar van uitvoering

• Lidmaatschap van de ssis_admin-databaserol

• Lidmaatschap van de sysadmin serverfunctie

Fouten en waarschuwingen

In de volgende lijst worden voorwaarden beschreven waardoor de opgeslagen procedure mislukt.

• De gebruiker heeft geen MACHTIGINGEN VOOR WIJZIGEN.

• De gegevenstik voor het opgegeven onderdeel, in het opgegeven pakket, is al toegevoegd.

• De waarde die is opgegeven voor het aantal rijen dat moet worden vastgelegd, is ongeldig.

Eisen

Zie ook

catalog.add_data_tap