catalog.add_data_tap
Aggiunge una scelta dei dati sull'output di un componente in un flusso di dati del pacchetto, per un'istanza dell'esecuzione.
Sintassi
add_data_tap [ @execution_id = ] execution_id
[ @task_package_path = ] task_package_path
[ @dataflow_path_id_string = ] dataflow_path_id_string
[ @data_filename = ] data_filename
[ @max_rows = ] max_rows
[ @data_tap_id = ] data_tap_id
OUTPUT
Argomenti
[ @execution\_id = ] execution_id
ID dell'esecuzione che contiene il pacchetto. execution_id è bigint.[ @task\_package\_path = ] task_package_path
Percorso del pacchetto per l'attività Flusso di dati. La proprietà PackagePath per l'attività Flusso di dati specifica il percorso. Per il percorso viene applicata la distinzione tra maiuscole e minuscole. Per individuare il percorso del pacchetto, in SQL Server Data Tools fare clic con il pulsante destro del mouse sull'attività Flusso di dati e scegliere Proprietà. La proprietà PackagePath viene visualizzata nella finestra Proprietà.task_package_path è nvarchar(max).
[ @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 scegliere Proprietà. La proprietà IdentificationString viene visualizzata nella finestra Proprietà.
dataflow_path_id_string è 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.Per impostazione predefinita, il file viene archiviato nella cartella <unità>:\Programmi\Microsoft SQL Server\110\DTS\DataDumps.
data_filename è 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. max_rows è di tipo int.[ @data\_tap\_id = ] data_tap_id
Restituisce 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[OLE DB Source.OLE DB Source Output] nell'attività Flusso di dati \Package\Data Flow Task. Le scelte dei dati vengono archiviate nel file output0.txt nella cartella DataDumps (<unità>:\Programmi\Microsoft SQL Server\110\DTS\DataDumps).
Declare @execution_id bigint
Exec SSISDB.Catalog.create_execution @folder_name='Packages',@project_name='SSISPackages', @package_name='Package.dtsx',@reference_id=Null, @use32bitruntime=False, @execution_id=@execution_id OUTPUT
Exec SSISDB.Catalog.set_execution_parameter_value @execution_id,50, 'LOGGING_LEVEL', 0
Exec SSISDB.Catalog.add_data_tap @execution_id, @task_package_path='\Package\Data Flow Task', @dataflow_path_id_string = 'Paths[OLE DB Source.OLE DB Source Output]', @data_filename = 'output0.txt'
Exec SSISDB.Catalog.start_execution @execution_id
Osservazioni
Per aggiungere scelte dei dati, l'istanza di esecuzione deve essere nello stato di creazione (valore di 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.
Se un'esecuzione contiene un pacchetto padre e uno o più pacchetti figlio, è necessario aggiungere un data tap per ogni pacchetto per il quale si desidera creare data tap.
Se un pacchetto contiene più di un'attività Flusso di dati con lo stesso nome, task_package_path identifica in modo univoco l'attività Flusso di dati che contiene l'output del componente di cui è stato creato un data tap.
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 del pacchetto viene arrestata e nel log viene scritto un messaggio di errore.
L'esecuzione della stored procedure add_data_tap influisce sulle prestazioni del pacchetto. È consigliabile eseguire la stored procedure solo per risolvere problemi relativi ai dati.
Per accedere al file in cui sono archiviati i data tap, è necessario essere un amministratore nel computer in cui viene eseguita la stored procedure. È anche necessario essere l'utente che ha avviato l'esecuzione che contiene il pacchetto con il data tap.
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 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.
Risorse esterne
Intervento nel blog relativo alle scelte dei dati in SSIS 2012 sul sito Web rafael-salas.com.