Strumenti per la risoluzione dei problemi relativi all'esecuzione dei pacchetti

  • Articolo

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 quando si eseguono i pacchetti dopo averli completati e distribuiti.

In fase di progettazione, SQL Server Data Tools (SSDT) offre punti di interruzione che consentono di sospendere l'esecuzione dei pacchetti, una finestra di stato e visualizzatori dati che consentono di visualizzare il passaggio dei dati nel flusso di dati. Queste funzionalità non sono tuttavia disponibili quando si eseguono i pacchetti distribuiti. Le tecniche principali per la risoluzione dei problemi relativi ai pacchetti distribuiti sono le seguenti:

  • Intercettazione e gestione degli errori dei pacchetti tramite gestori di eventi.

  • Acquisizione dei dati errati tramite output degli errori.

  • Registrazione dei passaggi dell'esecuzione dei pacchetti.

Per evitare problemi relativi all'esecuzione di pacchetti, è inoltre possibile utilizzare le tecniche e i suggerimenti seguenti.

Intercettazione e gestione degli errori dei pacchetti tramite gestori di eventi

I gestori degli eventi consentono di rispondere ai molti eventi generati dal pacchetto e dai relativi oggetti.

  • Creazione di un gestore dell'evento per l'evento OnError. Nel gestore dell'evento è possibile utilizzare un'attività Invia messaggi per inviare a un amministratore una notifica dell'errore, utilizzare un'attività Script e la logica personalizzata per ottenere informazioni di sistema per la risoluzione dei problemi oppure eliminare le risorse temporanee o l'output incompleto. Per altre informazioni, vedere Gestori eventi di Integration Services (SSIS).

Risoluzione dei problemi relativi ai dati errati tramite output degli errori

È possibile utilizzare l'output degli errori disponibile in numerosi componenti flusso di dati per indirizzare le righe contenenti errori a una destinazione distinta, per un'analisi successiva. Per altre informazioni, vedere Gestione degli errori nei dati.

  • Acquisizione dei dati errati tramite output degli errori. È possibile inviare le righe contenenti errori a una destinazione distinta, ad esempio una tabella degli errori o un file di testo. Tramite l'output degli errori vengono aggiunte automaticamente due colonne numeriche contenenti il numero dell'errore a causa del quale la riga è stata rifiutata e l'ID della colonna in cui si è verificato l'errore.

  • Aggiunta di informazioni descrittive agli output degli errori. Per semplificare l'analisi dell'output degli errori, oltre ai due identificatori numerici specificati dall'output stesso è possibile aggiungere il messaggio di errore e il nome della colonna. Per un esempio di come aggiungere queste due colonne supplementari mediante scripting, vedere Ottimizzazione di un output degli errori con il componente script.

  • In alternativa, ottenere i nomi delle colonne registrando l'evento DiagnosticEx. Questo evento scrive una mappa di derivazione del flusso di dati nel log. È quindi possibile cercare il nome della colonna in questa mappa di derivazione usando l'identificatore della colonna acquisito da un output degli errori. Per altre informazioni, vedere Gestione degli errori nei dati.

    Il valore della colonna di messaggio per DiagnosticEx è testo XML. Per visualizzare il testo del messaggio per un'esecuzione del pacchetto, eseguire una query nella vista catalog.operation_messages (database SSISDB). Notare che l'evento DiagnosticEx non mantiene gli spazi vuoti nel relativo output XML per ridurre le dimensioni del log. Per migliorare la leggibilità, copiare il log in un editor XML come Visual Studio, che supporta la formattazione XML e l'evidenziazione della sintassi.

Risoluzione dei problemi relativi all'esecuzione di pacchetti tramite i report delle operazioni

In SQL Server Management Studio sono disponibili due report relativi alle operazioni standard per il monitoraggio dei pacchetti di Integration Services distribuiti nel catalogo di Integration Services. Con i report relativi ai pacchetti è possibile visualizzare lo stato e la cronologia dei pacchetti e, se necessario, identificare la causa di eventuali errori.

Per altre informazioni, vedere Risoluzione dei problemi relativi ai report per l'esecuzione del pacchetto.

Risoluzione dei problemi relativi all'esecuzione di pacchetti tramite viste SSISDB

Sono disponibili diverse viste di database SSISDB su cui è possibile eseguire una query per monitorare l'esecuzione dei pacchetti e altre informazioni sulle operazioni. Per altre informazioni, vedere Esecuzione di pacchetti e altre operazioni di monitoraggio.

Risoluzione dei problemi relativi all'esecuzione di pacchetti tramite la registrazione

Abilitando la registrazione è possibile tenere traccia di ciò che avviene durante l'esecuzione dei pacchetti. I provider di log consentono di acquisire informazioni sugli eventi specificati da utilizzare per un'analisi successiva e di salvare tali informazioni in una tabella di database, in un file flat, in un file XML o in un altro formato di output supportato.

  • Abilitazione della registrazione. È possibile ottimizzare l'output di registrazione selezionando solo gli eventi e le informazioni che si desidera acquisire. Per altre informazioni, vedere Registrazione di Integration Services (SSIS).

  • Selezionare l'evento Diagnostic del pacchetto per risolvere i problemi relativi al provider. Sono presenti messaggi di registrazione per il supporto della risoluzione dei problemi relativi all'interazione di un pacchetto con origini dati esterne. Per altre informazioni, vedere Risoluzione dei problemi relativi alla connettività dei pacchetti degli strumenti.

  • Miglioramento dell'output di registrazione predefinito. La registrazione comporta in genere l'accodamento di righe alla destinazione di registrazione ogni volta che viene eseguito un pacchetto. Sebbene ogni riga dell'output di registrazione identifichi il pacchetto in base al nome e all'identificatore univoco e identifichi inoltre l'esecuzione del pacchetto tramite un identificatore ExecutionID univoco, una grande quantità di output di registrazione in un unico elenco può essere difficile da analizzare.

    L'approccio seguente consente di migliorare l'output di registrazione predefinito e semplificare la generazione di report:

    1. Creare una tabella padre per la registrazione di ogni esecuzione di un pacchetto. In questa tabella padre è inclusa una singola riga per ogni esecuzione di un pacchetto e viene utilizzato l'identificatore ExecutionID per il collegamento ai record figlio nella tabella di registrazione di Integration Services. È possibile utilizzare un'attività Esegui SQL all'inizio di ogni pacchetto per creare questa nuova riga e registrare l'ora di inizio. È quindi possibile utilizzare un'altra attività Esegui SQL alla fine del pacchetto per aggiornare la riga con ora di fine, durata e stato.

    2. Aggiungere informazioni di controllo al flusso di dati. È possibile utilizzare la trasformazione Controllo per aggiungere alle righe del flusso di dati informazioni sull'esecuzione del pacchetto che ha creato o modificato ogni riga. La trasformazione Controllo rende disponibili nove informazioni, incluse quelle relative a PackageName ed ExecutionInstanceGUID. Per altre informazioni, vedere Trasformazione Controllo. Se si desidera includere in ogni riga informazioni personalizzate a scopo di controllo, è possibile aggiungere le informazioni desiderate alle righe del flusso di dati utilizzando una trasformazione Colonna derivata. Per altre informazioni, vedere Trasformazione Colonna derivata.

    3. Valutare l'opportunità di acquisire i dati sul conteggio delle righe. Prendere in considerazione la creazione di una tabella separata per le informazioni sul conteggio delle righe, in cui ogni istanza di esecuzione di un pacchetto è identificata tramite il relativo ExecutionID. Utilizzare la trasformazione Conteggio righe per salvare il conteggio delle righe in una serie di variabili in punti critici del flusso di dati. Al termine del flusso di dati, utilizzare un'attività Esegui SQL per inserire le serie di valori in una riga della tabella, per operazioni successive di analisi e creazione di report.

    Per altre informazioni su questo approccio, vedere la sezione relativa a registrazione e controllo ETL nel white paper Microsoft Project REAL: Business Intelligence ETL Design Practices.

Risoluzione dei problemi relativi all'esecuzione di pacchetti tramite i file di dump del debug

In Integration Services è possibile creare file di dump del debug contenenti informazioni sull'esecuzione di un pacchetto. Per altre informazioni, vedere Generazione di file di dump per l'esecuzione del pacchetto.

Risoluzione dei problemi relativi alla convalida in fase di esecuzione

A volte potrebbe non essere possibile connettersi alle origini dati o convalidare parte dei pacchetti prima di aver eseguito alcune attività nei pacchetti. Integration Services include le funzionalità seguenti per permettere di evitare gli errori di convalida che altrimenti si verificherebbero in queste condizioni:

  • Configurazione della proprietà DelayValidation per gli elementi del pacchetto non validi quando il pacchetto viene caricato. È possibile impostare la proprietà DelayValidation su True per gli elementi del pacchetto con configurazione non valida, per impedire errori di convalida quando il pacchetto viene caricato. 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.

    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. Impostando la proprietà truesu ValidateExternalMetadata , è possibile evitare problemi causati da blocchi nel database, in particolare quando nel pacchetto vengono usate transazioni.

Risoluzione dei problemi relativi alle autorizzazioni in fase di esecuzione

Se si verificano errori quando si cerca di eseguire pacchetti distribuiti tramite SQL Server Agent, è possibile che gli account usati non dispongano delle autorizzazioni necessarie. Per informazioni su come risolvere i problemi legati all'esecuzione di pacchetti dai processi di SQL Server Agent, vedere Il pacchetto SSIS non viene eseguito quando viene chiamato da un passaggio del processo di SQL Server Agent. Per altre informazioni sull'esecuzione di pacchetti da SQL Server Agent, vedere Processi di SQL Server Agent per i pacchetti.

Per connettersi a origini dati Excel o Access, SQL Server Agent richiede un account con autorizzazione di lettura, scrittura, creazione ed eliminazione dei file temporanei nella cartella specificata dalle variabili di ambiente TEMP e TMP.

Risoluzione dei problemi relativi ai componenti a 64 bit

  • Alcuni provider di dati non sono disponibili nella piattaforma a 64 bit. In particolare, il provider OLE DB di Microsoft Jet necessario per la connessione alle origini dati Excel o Access non è disponibile in una versione a 64 bit.

Risoluzione dei problemi relativi agli errori senza descrizione

Se viene generato un errore di Integration Services c sui non è associata una descrizione, è possibile individuare la descrizione in Guida di riferimento ai messaggi e agli errori di Integration Services cercando l'errore in base al numero. Al momento, nell'elenco non sono incluse informazioni per la risoluzione dei problemi.

Debug di un flusso di dati