catalog.add_data_tap_by_guid

  • Articolo

Si applica a:SQL Server Integration Runtime SSIS 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 scelte dei dati, l'istanza di esecuzione deve essere nello stato di creazione (valore 1 nella colonna status 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

nessuno

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.

Requisiti

Vedere anche

catalog.add_data_tap