Strumenti per la risoluzione dei problemi di sviluppo di pacchetti

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

Integration Services include funzionalità e strumenti per la risoluzione dei problemi che possono verificarsi durante lo sviluppo di pacchetti in SQL Server Data Tools (SSDT).

Risoluzione dei problemi relativi alla convalida in fase di progettazione

Nella versione corrente di Integration Services, all'apertura di un pacchetto il sistema convalida tutte le connessioni prima di convalidare tutti i componenti del flusso di dati e imposta tutte le connessioni che sono lente o non disponibili per il funzionamento offline. In questo modo è possibile ridurre il ritardo nella convalida del flusso di dati del pacchetto.

Dopo aver aperto un pacchetto, è possibile disattivare una connessione anche facendo clic con il pulsante destro del mouse sulla gestione connessione nell'area Gestioni connessioni e scegliendo quindi Offline. In questo modo è possibile velocizzare le operazioni in Progettazione SSIS.

Le connessioni impostate per funzionare offline, rimarranno tali fino a quando non viene effettuata una delle operazioni seguenti:

Testare la connessione facendo clic con il pulsante destro del mouse sulla gestione connessione nell'area Gestioni connessioni di Progettazione SSIS e scegliendo quindi Test connettività.

Ad esempio, una connessione è impostata inizialmente per funzionare offline quando viene aperto il pacchetto. Modificare la stringa di connessione per risolvere il problema e fare clic su Test connettività per testare la connessione.
Aprire di nuovo il pacchetto o il progetto contenente il pacchetto. La convalida viene eseguita nuovamente su tutte le connessioni nel pacchetto.

Integration Services include le seguenti funzionalità aggiuntive per evitare errori di convalida:

Impostare l'intero pacchetto e tutte le connessioni per lavorare offline quando le origini dati non sono disponibili. È possibile abilitare Lavora offline dal menu SSIS. A differenza della proprietà DelayValidation, l'opzione Lavora offline è disponibile anche prima di aprire un pacchetto. È anche possibile abilitare l'opzione Offline per rendere più veloci le operazioni di progettazione e disabilitarla solo quando si vuole convalidare il pacchetto.
Configurare la proprietà DelayValidation sugli elementi del pacchetto che non sono validi fino al momento dell'esecuzione. È possibile impostare la proprietà DelayValidation su True per gli elementi del pacchetto la cui configurazione non è valida in fase di progettazione, per impedire gli errori di convalida. Potrebbe ad esempio essere presente un'attività Flusso di dati in cui viene utilizzata una tabella di destinazione che non esiste fino a quando non viene creata in fase di esecuzione da un'attività Esegui SQL. La proprietà DelayValidation può essere abilitata a livello di pacchetto oppure delle singole attività e dei singoli contenitori del pacchetto. In genere, è necessario lasciare impostata questa proprietà su True negli stessi elementi del pacchetto quando si distribuisce il pacchetto, per impedire gli stessi errori di convalida in fase di esecuzione.

La proprietà DelayValidation può essere impostata in un'attività Flusso di dati ma non nei singoli componenti flusso di dati. È possibile ottenere un risultato simile impostando la proprietà ValidateExternalMetadata dei singoli componenti flusso di dati su false. Quando, tuttavia, il valore di questa proprietà è impostato su false, il componente non riconosce le modifiche apportate ai metadati delle origini dati esterne.

Se gli oggetti di database utilizzati dal pacchetto risultano bloccati durante la convalida, è possibile che il processo di convalida si arresti. In questi casi, anche il Designer SSIS smette di rispondere. È possibile riprendere la convalida usando Management Studio per chiudere le sessioni associate in SQL Server. Questo problema può essere evitato anche utilizzando le impostazioni descritte in questa sezione.

Risoluzione dei problemi del flusso di controllo

Integration Services include gli strumenti e le funzionalità seguenti per la risoluzione dei problemi relativi al flusso di controllo nei pacchetti che possono verificarsi durante lo sviluppo di pacchetti:

Impostare punti di interruzione in attività, contenitori e pacchetti. È possibile impostare punti di interruzione tramite gli strumenti grafici disponibili in Progettazione SSIS. I punti di interruzione possono essere abilitati a livello di pacchetto oppure delle singole attività e dei singoli contenitori del pacchetto. Alcune attività e contenitori includono condizioni di interruzione aggiuntive per l'impostazione dei punti di interruzione. Ad esempio, è possibile abilitare una condizione di interruzione nel contenitore For Loop che sospende l'esecuzione all'inizio di ogni iterazione del ciclo.
Usare le finestre di debug. Quando si esegue un pacchetto che include punti di interruzione, tramite le finestre di debug di SQL Server Data Tools (SSDT) è possibile accedere ai valori di variabili e ai messaggi di stato.
Esaminare le informazioni nella scheda Avanzamento. SSIS Designer fornisce ulteriori informazioni sul flusso di controllo quando si esegue un pacchetto in SQL Server Data Tools (SSDT). Nella scheda Stato sono elencati i contenitori e le attività in ordine di esecuzione, nonché l'ora di inizio e di fine, gli avvisi e i messaggi di errore per ogni contenitore e attività, inclusi quelli relativi al pacchetto stesso.

Per altre informazioni su queste funzionalità, vedere Debug del flusso di controllo.

Risoluzione dei problemi del flusso di dati

Integration Services include gli strumenti e le funzionalità seguenti per la risoluzione dei problemi relativi ai flussi di dati nei pacchetti che possono verificarsi durante lo sviluppo di pacchetti:

Eseguire test con solo un subset di dati. Se si desidera risolvere i problemi del flusso di dati in un pacchetto utilizzando solo un campione del set di dati, è possibile includere una trasformazione Campionamento percentuale o Campionamento righe per creare un campione di dati in linea in fase di esecuzione. Per altre informazioni, vedere Trasformazione campionamento in percentuale e Trasformazione campionamento di righe.
Usare visualizzatori dati per il monitoraggio dei dati durante il passaggio nel flusso di dati. Nei visualizzatori dati vengono visualizzati i valori dei dati durante il trasferimento tra origini, trasformazioni e destinazioni. Un visualizzatore consente di visualizzare i dati in una griglia. È possibile copiare i dati da un visualizzatore dati negli Appunti e quindi incollarli in un file o in un foglio di calcolo Excel. Per altre informazioni, vedere Debug di un flusso di dati.
Configurare gli output di errore sui componenti del flusso di dati che li supportano. Molte origini, trasformazioni e destinazioni del flusso di dati supportano anche gli output di errore. Configurando l'output degli errori di un componente del flusso di dati, è possibile indirizzare i dati che contengono errori a una destinazione diversa. È ad esempio possibile acquisire in un file di testo distinto i dati che hanno generato un errore o che sono stati troncati. È inoltre possibile associare visualizzatori dati agli output degli errori ed esaminare solo i dati errati. Durante la progettazione, gli output di errore catturano valori di dati problematici per aiutare a sviluppare pacchetti che gestiscano in modo efficace i dati del mondo reale. A differenza, tuttavia, di altri strumenti e caratteristiche per la risoluzione di problemi utili solo in fase di progettazione, gli output degli errori sono utili nell'ambiente di produzione. Per altre informazioni, vedere Gestione degli errori nei dati.
Acquisisci il conteggio delle righe elaborate. Quando si esegue un pacchetto in Progettazione SSIS, nella finestra di progettazione del flusso di dati viene visualizzato il numero di righe che sono state spostate lungo un determinato percorso. Tale numero viene aggiornato periodicamente quando i dati vengono spostati lungo tale 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.
Esaminare le informazioni sulla scheda Avanzamento. La finestra Progettazione SSIS fornisce ulteriori informazioni sui flussi di dati quando si esegue un pacchetto in SQL Server Data Tools (SSDT). Nella scheda Avanzamento sono elencati i componenti del flusso di dati in ordine di esecuzione e sono incluse informazioni sull'avanzamento di ogni fase del pacchetto, indicato come percentuale di completamento, nonché il numero di righe scritte nella destinazione.

Per altre informazioni su queste funzionalità, vedere Debug del flusso di dati.

Risoluzione dei problemi relativi agli script

Microsoft Visual Studio Tools for Applications (VSTA) è l'ambiente di sviluppo in cui scrivere gli script che vengono usati dall'attività Script e dal componente script. In VSTA sono disponibili gli strumenti e le caratteristiche seguenti per la risoluzione dei problemi relativi agli script durante lo sviluppo dei pacchetti:

Impostazione dei punti di interruzione negli script delle attività Script. VSTA fornisce supporto per il debug degli script esclusivamente nell'attività Script. I punti di interruzione impostati nell'attività Script vengono integrati con i punti di interruzione impostati sia nei pacchetti che nelle attività e nei contenitori dei pacchetti in modo da consentire il debug di tutti gli elementi del pacchetto.

Nota

Quando si esegue il debug di un pacchetto che contiene più attività Script, il debugger rileva i punti di interruzione in una sola attività Script, ignorando i punti di interruzione nelle altre attività Script. Se un'attività Script fa parte di un contenitore Foreach Loop o For Loop, il debugger ignora i punti di interruzione nell'attività Script a partire dalla seconda iterazione del ciclo.

Per altre informazioni, vedere Debug degli script. Per suggerimenti su come eseguire il debug del componente script, vedere Codifica e debug del componente script.

Risoluzione degli errori senza descrizione

Se durante lo sviluppo di un pacchetto viene visualizzato un numero di errore di Integration Services senza una descrizione, è possibile ottenere la descrizione in Guida di riferimento ai messaggi e agli errori di Integration Services. Al momento, nell'elenco non sono incluse informazioni per la risoluzione dei problemi.

Last updated on 2026-08-24