Debug di un flusso di dati

Si applica a:SQL Server SSIS Integration Runtime in Azure Data Factory

Microsoft Integration Services e Progettazione SSIS includono funzionalità e strumenti che è possibile usare per risolvere i problemi relativi ai flussi di dati in un pacchetto di Integration Services.

Designer SSIS fornisce visualizzatori di dati.
Il designer SSIS e le trasformazioni di Integration Services forniscono il conteggio delle righe.
SSIS Designer fornisce informazioni sullo stato di avanzamento durante l'esecuzione.

Visualizzatori dati

I visualizzatori dati visualizzano i dati scambiati tra due componenti in un flusso di dati. I dati possono essere visualizzati quando vengono estratti da un'origine dei dati e immessi per la prima volta in un flusso di dati, prima e dopo l'aggiornamento da parte di una trasformazione e prima che vengano caricati nella destinazione.

Per visualizzare i dati è necessario collegare visualizzatori dati al percorso che connette i due componenti flusso di dati. La possibilità di visualizzare i dati scambiati tra due componenti flusso di dati semplifica l'identificazione di valori di dati imprevisti, consente di vedere come vengono modificati i valori delle colonne da parte di una trasformazione e di individuare i motivi per cui una trasformazione non riesce. Nel caso in cui, ad esempio, una ricerca in una tabella di riferimento abbia esito negativo, per risolvere il problema potrebbe essere necessario aggiungere una trasformazione che fornisce dati predefiniti per le colonne vuote.

Un visualizzatore consente di visualizzare i dati in una griglia. Se si utilizza una griglia, è possibile selezionare le colonne da visualizzare. I valori per le colonne selezionate verranno visualizzati in formato tabulare.

È inoltre possibile collegare più visualizzatori dati in uno stesso percorso e visualizzare gli stessi dati in formati diversi, creando ad esempio una vista grafico e una visualizzazione griglia, oppure creare visualizzatori dati diversi per colonne di dati diverse.

Quando si aggiunge un visualizzatore dati a un percorso, Progettazione SSIS aggiunge un'icona di visualizzatore dati all'area di progettazione della scheda Flusso di dati, accanto al percorso. Le trasformazioni che possono avere più output, come la trasformazione Suddivisione condizionale, possono includere un visualizzatore di dati su ogni percorso.

In fase di runtime viene visualizzata la finestra Visualizzatore dati in cui sono disponibili le informazioni specificate dal formato del visualizzatore dati. Un visualizzatore che utilizza un formato griglia, ad esempio, visualizza i dati per le colonne selezionate, il numero delle righe di output passate al componente flusso di dati e il numero delle righe visualizzate. Le informazioni vengono visualizzate un buffer dopo l'altro e il numero delle righe contenuto in ogni buffer dipende dalla larghezza delle righe nel flusso di dati.

Nella finestra di dialogo Visualizzatore dati è possibile copiare i dati negli Appunti, cancellare tutti i dati dalla tabella, riconfigurare il visualizzatore dati, riprendere il flusso di dati e collegare o scollegare il visualizzatore dati.

Per aggiungere un visualizzatore dati

Aggiungere un visualizzatore dati a un flusso di dati

Numero di righe

Il numero delle righe passate lungo un percorso viene visualizzato nell'area di progettazione della scheda Flusso di dati di Progettazione SSIS, accanto al percorso. Tale numero viene aggiornato periodicamente mentre i dati si spostano lungo il percorso.

Nel flusso di dati è inoltre possibile aggiungere una trasformazione Conteggio righe per l'acquisizione del conteggio di righe finale in una variabile. Per ulteriori informazioni, vedere Trasformazione conteggio righe.

Report sullo stato di avanzamento

Quando si esegue un pacchetto, Progettazione SSIS delinea i progressi compiuti nell'area di progettazione della scheda Flusso dati visualizzando ogni componente del flusso dati in un colore che ne indica lo stato. Quando ogni componente, inizialmente privo di colore, comincia a eseguire le operazioni previste, assume il colore giallo e, al termine, assume il colore verde. Tramite il colore rosso viene indicato che l'esecuzione del componente non è riuscita.

Il significato dei colori è descritto nella tabella seguente.

Colore	Descrizione
Nessun colore	In attesa di essere chiamato dal motore del flusso di dati.
Giallo	È in corso una trasformazione, un'operazione di estrazione o un'operazione di caricamento dei dati.
Verde	Eseguito correttamente.
rosso	Terminato con errori.

Analisi del flusso di dati

È possibile usare la vista catalog.execution_data_statistics del database SSISDB per analizzare il flusso di dati dei pacchetti. In questa vista viene visualizzata una riga ogni volta che un componente del flusso di dati invia dati a un componente a valle. Le informazioni possono essere utilizzate per acquisire una comprensione più approfondita delle righe inviate a ciascun componente.

Nota

Il livello di registrazione deve essere impostato su Verbose per acquisire informazioni tramite la vista catalog.execution_data_statistics.

Nell'esempio seguente viene visualizzato il numero di righe inviate tra i componenti di un pacchetto.

use SSISDB  
select package_name, task_name, source_component_name, destination_component_name, rows_sent  
from catalog.execution_data_statistics  
where execution_id = 132  
order by source_component_name, destination_component_name

Nell'esempio seguente viene calcolato il numero di righe per millisecondi inviate da ogni componente per un'esecuzione specifica. I valori calcolati sono:

total_rows : somma di tutte le righe inviate dal componente
wall_clock_time_ms: tempo totale di esecuzione trascorso, in millisecondi, per ogni componente
num_rows_per_millisecond: numero di righe per millisecondi inviate da ogni componente

La clausola HAVING viene usata per impedire un errore di divisione per zero nei calcoli.

use SSISDB  
select source_component_name, destination_component_name,  
    sum(rows_sent) as total_rows,  
    DATEDIFF(ms,min(created_time),max(created_time)) as wall_clock_time_ms,  
    ((0.0+sum(rows_sent)) / (datediff(ms,min(created_time),max(created_time)))) as [num_rows_per_millisecond]  
from [catalog].[execution_data_statistics]  
where execution_id = 132  
group by source_component_name, destination_component_name  
having (datediff(ms,min(created_time),max(created_time))) > 0  
order by source_component_name desc

Configurare un output di errore in un componente del flusso di dati

Molti componenti del flusso di dati supportano l'output degli errori. A seconda del componente, in Progettazione SSIS sono disponibili strumenti diversi per la configurazione di un output degli errori. Oltre a configurare un output di errore, è anche possibile configurarne le colonne. Ciò include la configurazione delle colonne ErrorCode e ErrorColumn aggiunte dal componente.

Configurazione di un output di errore

Per configurare un output degli errori sono disponibili due opzioni:

Usa la finestra di dialogo Configura output degli errori. È possibile usare questa finestra di dialogo per configurare un output di errore per qualsiasi componente del flusso di dati che supporti un output di errore.
Utilizzare la finestra di dialogo dell'editor per il componente. Alcuni componenti consentono di configurare gli output di errore direttamente dalla finestra di dialogo dell’editor. Non è tuttavia possibile configurare output degli errori dalla finestra di dialogo dell'editor per l'origine ADO NET, la trasformazione Importa colonna, la trasformazione Comando OLE DB o la destinazione SQL Server Compact.

Le procedure seguenti descrivono come utilizzare queste finestre di dialogo per configurare gli output di errore.

Per configurare un output di errore utilizzando la finestra di dialogo Configura output di errore

In SQL Server Data Tools (SSDT) aprire il progetto di Integration Services che contiene il pacchetto desiderato.
In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.
In progettazione SSIS fare clic sulla scheda Flusso di dati.
Trascinare l'output degli errori, indicato dalla freccia rossa, dal componente che costituisce l'origine degli errori a un altro componente del flusso di dati.
Nella finestra di dialogo Configura output errori selezionare un'azione nelle colonne Errore e Troncamento per ogni colonna dell'input del componente.
Per salvare il pacchetto aggiornato, dal menu File scegliere Salva elementi selezionati.

Per aggiungere un output di errore utilizzando la finestra di dialogo dell'editor per il componente

In SQL Server Data Tools (SSDT) aprire il progetto di Integration Services che contiene il pacchetto desiderato.
In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.
In progettazione SSIS fare clic sulla scheda Flusso di dati.
Fare doppio clic sui componenti del flusso di dati in cui si desidera configurare un output degli errori e, a seconda del componente, eseguire una delle operazioni seguenti:
- Fare clic su Configura output degli errori.
- Fare clic su Output di errore.
Impostare l'opzione Errore per ogni colonna.
Imposta l'opzione Troncamento per ogni colonna.
Fare clic su OK.
Per salvare il pacchetto aggiornato, dal menu File scegliere Salva elementi selezionati.

Configurazione delle colonne di output degli errori

Per configurare le colonne di output degli errori, è necessario usare la scheda Proprietà input e output della finestra di dialogo Editor avanzato.

Per configurare le colonne dell'output degli errori

In SQL Server Data Tools (SSDT) aprire il progetto di Integration Services che contiene il pacchetto desiderato.
In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.
In progettazione SSIS fare clic sulla scheda Flusso di dati.
Fare clic con il pulsante destro del mouse sul componente di cui si desidera configurare le colonne dell'output degli errori, quindi scegliere Visualizza editor avanzato.
Fare clic sulla scheda Proprietà di input e di output ed espandere <nome del componente> Output degli errori, quindi espandere Colonne di output.
Fare clic su una colonna e aggiornarne le proprietà.

Nota

L'elenco di colonne include le colonne dell'input del componente, le colonne ErrorCode e ErrorColumn aggiunte dall'output degli errori precedente e le colonne ErrorCode e ErrorColumn aggiunte dal componente corrente.
Fare clic su OK.
Per salvare il pacchetto aggiornato, dal menu File scegliere Salva elementi selezionati.

Aggiungere un visualizzatore dati a un flusso di dati

In questo argomento viene descritta la procedura per l'aggiunta e la configurazione di un visualizzatore dati in un flusso di dati. In un visualizzatore dati vengono visualizzati i dati in transito tra due componenti flusso di dati, Ad esempio, un visualizzatore dati può visualizzare i dati estratti da un'origine dati prima che una trasformazione nel flusso di dati li modifichi.

Un percorso collega i componenti in un flusso di dati connettendo l'output di un componente all'input dell'altro.

Per poter aggiungere visualizzatori dati in un pacchetto, è necessario che il pacchetto includa un'attività Flusso di dati e almeno due componenti flusso di dati connessi tra di loro.

Aggiungere un visualizzatore dati a un output di errore per visualizzare la descrizione dell'errore e il nome della colonna in cui si è verificato l'errore. Per impostazione predefinita, l'output di errore include solo gli identificatori numerici dell'errore e della colonna.

Per aggiungere un visualizzatore dati in un flusso di dati

In SQL Server Data Tools (SSDT) aprire il progetto di Integration Services che contiene il pacchetto desiderato.
In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.
Fare clic sulla scheda Control Flow, se non è già attiva.
Fare clic sull'attività Flusso di dati nel cui flusso di dati si vuole aggiungere un visualizzatore dati e quindi dare clic sulla scheda Flusso di dati .
Fare clic con il pulsante destro del mouse su un percorso tra due componenti del flusso di dati e quindi scegliere Modifica.
Nella pagina Generale è possibile visualizzare e modificare le proprietà del percorso. Ad esempio, nell'elenco a discesa PathAnnotation è possibile selezionare l'annotazione visualizzata accanto al percorso.
Nella pagina Metadati è possibile visualizzare i metadati delle colonne e copiarli negli Appunti.
Nella pagina Visualizzatore dati fare clic su Abilita visualizzatore dati.
Nell'area Colonne da visualizzare selezionare le colonne che si desidera visualizzare nel visualizzatore dati. Per impostazione predefinita, nell'elenco Colonne visualizzate sono elencate e selezionate tutte le colonne disponibili. Spostare le colonne da non usare nell'elenco Colonne inutilizzate selezionandole e facendo clic sulla freccia sinistra.

Nota

I valori nella griglia che rappresentano i tipi di dati DT_DATE, DT_DBTIME2, DT_FILETIME, DT_DBTIMESTAMP, DT_DBTIMESTAMP2 e DT_DBTIMESTAMPOFFSET vengono visualizzati come stringhe in formato ISO 8601. Uno spazio separatore sostituisce il separatore T . I valori che rappresentano i tipi di dati DT_DATE e DT_FILETIME includono sette cifre per i secondi frazionari. Poiché il tipo di dati DT_FILETIME memorizza solo tre cifre dei secondi frazionari, nella griglia viene visualizzato zero per le quattro cifre rimanenti. I valori che rappresentano il tipo di dati DT_DBTIMESTAMP comprendono tre cifre per le frazioni di secondo. Per i valori che rappresentano i tipi di dati DT_DBTIME2, DT_DBTIMESTAMP2 e DT_DBTIMESTAMPOFFSET, il numero di cifre dei secondi frazionari corrisponde alla scala specificata per il tipo di dati della colonna. Per altre informazioni sui formati ISO 8601, vedere Formati di data e ora. Per altre informazioni sui tipi di dati, vedere Tipi di dati di Integration Services.
Fare clic su OK.

Punti di intercettazione del flusso di dati

È possibile aggiungere un punto di prelievo dati su un percorso del flusso di dati di un pacchetto in fase di esecuzione e indirizzare l'output del punto di prelievo dati a un file esterno. Per utilizzare questa funzionalità, è necessario distribuire il progetto SSIS utilizzando il modello di distribuzione del progetto in un server SSIS. Dopo aver distribuito il pacchetto nel server, è necessario eseguire script T-SQL nel database SSISDB per aggiungere i data tap prima di eseguire il pacchetto. Di seguito è riportato uno scenario di esempio:

Creare un'istanza di esecuzione di un pacchetto usando la stored procedure catalog.create_execution (database SSISDB).
Aggiungi un tap di dati usando la stored procedure catalog.add_data_tap oppure catalog.add_data_tap_by_guid.
Avviare l'istanza di esecuzione del pacchetto usando catalog.start_execution (database SSISDB).

Di seguito è riportato uno script SQL di esempio tramite cui vengono eseguiti i passaggi descritti nello scenario sopra indicato:

Declare @execid bigint  
EXEC [SSISDB].[catalog].[create_execution] @folder_name=N'ETL Folder', @project_name=N'ETL Project', @package_name=N'Package.dtsx', @execution_id=@execid OUTPUT  
EXEC [SSISDB].[catalog].add_data_tap @execution_id = @execid, @task_package_path = '\Package\Data Flow Task', @dataflow_path_id_string = 'Paths[Flat File Source.Flat File Source Output]', @data_filename = 'output.txt'  
EXEC [SSISDB].[catalog].[start_execution] @execid

I parametri del nome della cartella, del nome del progetto e del nome del pacchetto della stored procedure create_execution corrispondono ai nomi della cartella, del progetto e del pacchetto nel catalogo di Integration Services. È possibile ottenere i nomi della cartella, del progetto e del pacchetto da utilizzare nella chiamata a create_execution da SQL Server Management Studio come illustrato nella figura riportata di seguito. Se non viene visualizzato il progetto SSIS in questo punto, non può ancora essere distribuito nel server SSIS. Fare clic con il pulsante destro del mouse sul progetto SSIS in Visual Studio e scegliere Distribuisci per distribuire il progetto nel server SSIS previsto.

Anziché digitare le istruzioni SQL, è possibile generare lo script di esecuzione del pacchetto effettuando i passaggi seguenti:

Fare clic con il pulsante destro del mouse su Package.dtsx , quindi scegliere Esegui.
Fare clic sul pulsante della barra degli strumenti Script per generare lo script.
Ora, aggiungi l'istruzione add_data_tap prima della chiamata a start_execution.

Il parametro task_package_path della stored procedure add_data_tap corrisponde alla proprietà PackagePath dell'attività Flusso di dati in Visual Studio. In Visual Studio fare clic con il pulsante destro del mouse su Attività Flusso di datie scegliere Proprietà per avviare la relativa finestra. Annotare il valore della proprietà PackagePath da usare come valore del parametro task_package_path nella chiamata alla stored procedure add_data_tap.

Il parametro dataflow_path_id_string della stored procedure add_data_tap corrisponde alla proprietà IdentificationString del percorso del flusso di dati a cui si desidera aggiungere un data tap. Per ottenere dataflow_path_id_string, fare clic sul percorso del flusso di dati (la freccia tra le attività nel flusso di dati) e prendere nota del valore della proprietà IdentificationString nella finestra Proprietà.

Quando si esegue lo script, il file di output viene archiviato in <Programmi>\Microsoft SQL Server\110\DTS\DataDumps. Se esiste già un file con il nome, viene creato un nuovo file con un suffisso, ad esempio output[1].txt.

Come accennato in precedenza, è inoltre possibile usare la stored procedure catalog.add_data_tap_by_guid anziché la stored procedure add_data_tap. Questa stored procedure accetta come parametro l'ID dell'attività di flusso di dati invece di task_package_path. È possibile ottenere l'ID dell'attività Flusso di dati dalla finestra delle proprietà di Visual Studio.

Rimozione di un derivatore dati

È possibile rimuovere un tap di dati prima di avviare l'esecuzione utilizzando la stored procedure catalog.remove_data_tap. Questa stored procedure accetta come parametro l'ID del data tap, che puoi ottenere come output della stored procedure add_data_tap.

DECLARE @tap_id bigint  
EXEC [SSISDB].[catalog].add_data_tap @execution_id = @execid, @task_package_path = '\Package\Data Flow Task', @dataflow_path_id_string = 'Paths[Flat File Source.Flat File Source Output]', @data_filename = 'output.txt' @data_tap_id=@tap_id OUTPUT  
EXEC [SSISDB].[catalog].remove_data_tap @tap_id

Elenco di tutti i punti di prelievo dati

È inoltre possibile elencare tutti i data tap utilizzando la vista catalog.execution_data_taps. Nell'esempio seguente vengono estratte le scelte dei dati per un'istanza di esecuzione specifica (ID: 54).

select * from [SSISDB].[catalog].execution_data_taps where execution_id=@execid

Considerazioni sulle prestazioni

L'abilitazione del livello di log dettagliato e l'aggiunta di punti di prelievo dei dati aumentano le operazioni di I/O eseguite dalla soluzione di integrazione dei dati. Pertanto, raccomandiamo di aggiungere punti di intercettazione dei dati solo per la risoluzione dei problemi.

Video

In questo video su TechNet viene illustrato come aggiungere/usare i data tap nel catalogo SSISDB di SQL Server 2012, che consentono di eseguire il debug dei pacchetti tramite codice e di acquisire i risultati parziali durante l'esecuzione. Descrive anche come elencare/rimuovere questi data taps e le procedure consigliate per l'utilizzo dei data taps nei pacchetti SSIS.

Gestione degli errori nei dati

Last updated on 2026-08-25