catalog.add_data_tap_by_guid
Si applica a: 
SQL Server SSIS Integration Runtime in Azure Data Factory
Si applica a: SQL Server
Aggiunge una scelta dei dati a uno specifico percorso del flusso di dati in un flusso di dati del pacchetto, per un'istanza dell'esecuzione.
Sintassi
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
Argomenti
[ @execution_id = ] execution_id
ID dell'esecuzione che contiene il pacchetto. execution_id è di tipo bigint.
[ @dataflow_task_guid = ] dataflow_task_guid
ID dell'attività Flusso di dati nel pacchetto che contiene il percorso del flusso di dati da scegliere. dataflow_task_guid è di tipo uniqueidentifier.
[ @dataflow_path_id_string = ] dataflow_path_id_string
Stringa di identificazione per il percorso del flusso di dati. Un percorso connette due componenti flusso di dati. La proprietà IdentificationString per il percorso specifica la stringa.
Per individuare la stringa di identificazione, in SQL Server Data Tools fare clic con il pulsante destro del mouse sul percorso tra due componenti flusso dati e quindi scegliere Proprietà. La proprietà IdentificationString viene visualizzata nella finestra Proprietà.
dataflow_path_id_string è di tipo nvarchar(4000).
[ @data_filename = ] data_filename
Nome del file in cui sono archiviati i data tap. Se l'attività Flusso di dati viene eseguita in un contenitore Ciclo Foreach o Ciclo For, i data tap per ogni iterazione del ciclo vengono archiviati in file separati. Ogni file ha un prefisso dato da un numero corrispondente a un'iterazione. I file di scelta dei dati vengono scritti nella cartella "<cartella di installazione di SQL Server>\130\DTS". data_filename è di tipo nvarchar(4000).
[ @max_rows = ] max_rows
Numero di righe acquisite durante la scelta dei dati. Se questo valore non è specificato, vengono acquisite tutte le righe. Il valore max_rows è di tipo int.
[ @data_tap_id = ] data_tap_id
L'ID della scelta dei dati. data_tap_id è di tipo bigint.
Esempio
Nell'esempio seguente viene creata una scelta dei dati nel percorso del flusso di dati Paths[SRC DimDCVentor.OLE DB Source Output] nell'attività Flusso di dati {D978A2E4-E05D-4374-9B05-50178A8817E8}. I dati scelti vengono archiviati nel file 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'
Osservazioni:
Per aggiungere i tap di dati, l'istanza dell'esecuzione deve trovarsi nello stato creato (valore 1 nella colonna stato della vista catalog.operations (database SSISDB) . Il valore dello stato viene modificato in seguito all'esecuzione. È possibile creare un'esecuzione chiamando catalog.create_execution (database SSISDB).
Di seguito sono riportate alcune considerazioni relative alla stored procedure add_data_tap_by_guid.
Quando si aggiunge la scelta dei dati, la convalida non avviene prima dell'esecuzione del pacchetto.
È consigliabile limitare il numero di righe acquisite durante la scelta dei dati per evitare di generare file di dati di grandi dimensioni. Se nel computer in cui viene eseguita la stored procedure si esaurisce lo spazio di archiviazione per i file di dati, l'esecuzione della stored procedure viene arrestata.
L'esecuzione della stored procedure add_data_tap_by_guid influisce sulle prestazioni del pacchetto. È consigliabile eseguire la stored procedure solo per risolvere problemi relativi ai dati.
Per accedere al file in cui vengono archiviati i dati scelti, è necessario disporre delle autorizzazioni di amministratore sul computer in cui viene eseguita la stored procedure o essere l'utente che ha avviato l'esecuzione che contiene il pacchetto con la scelta dei dati.
Codici restituiti
0 (esito positivo)
Quando la stored procedure ha esito negativo viene generato un errore.
Set di risultati
None
Autorizzazioni
Per questa stored procedure è necessaria una delle autorizzazioni seguenti:
Autorizzazione MODIFY per l'istanza di esecuzione
Appartenenza al ruolo del database ssis_admin
Appartenenza al ruolo del server sysadmin
Errori e avvisi
Nell'elenco seguente vengono descritte le condizioni che causano la mancata riuscita della stored procedure.
L'utente non dispone delle autorizzazioni MODIFY.
Il data tap per il componente specificato, nel pacchetto specificato, è già stato aggiunto.
Il valore specificato per il numero di righe da acquisire non è valido.