Gestori eventi di Integration Services (SSIS)

Durante la fase di esecuzione gli eseguibili, costituiti da pacchetti e contenitori Ciclo Foreach, Ciclo For, Sequenza e Host attività, generano eventi. Quando si verifica un errore, ad esempio, viene generato l'evento OnError. È possibile creare gestori di eventi personalizzati per tali eventi, per estendere le funzionalità dei pacchetti e semplificarne la gestione in fase di esecuzione. I gestori di eventi possono eseguire varie attività, ad esempio:

• Cancellare l'archivio dati temporaneo al termine dell'esecuzione di un pacchetto o attività.

• Recuperare informazioni di sistema per verificare la disponibilità delle risorse prima dell'esecuzione di un pacchetto.

• Aggiornare dati in una tabella quando una ricerca in una tabella di riferimento non riesce.

• Inviare un messaggio di posta elettronica quando viene generato un errore o un avviso oppure quando un'attività non riesce.

Se per un evento non esiste alcun gestore, tale evento verrà passato al contenitore di livello immediatamente superiore nella gerarchia dei contenitori del pacchetto. Se il contenitore dispone di un gestore di evento, quest'ultimo verrà eseguito in risposta all'evento, in caso contrario l'evento verrà passato al contenitore di livello immediatamente superiore nella gerarchia dei contenitori.

Nella figura seguente viene illustrato un semplice pacchetto che include un contenitore Ciclo For contenente un'attività Esegui SQL.

Solo il pacchetto dispone di un gestore di evento per il proprio evento OnError. Se si verifica un errore mentre viene eseguita l'attività Esegui SQL, verrà eseguito il gestore dell'evento OnError del pacchetto. Nella figura seguente viene illustrata la sequenza di chiamate che provoca l'esecuzione del gestore dell'evento OnError per il pacchetto.

I gestori di eventi sono membri di un insieme di gestori di eventi, disponibile in tutti i contenitori. Se si crea un pacchetto utilizzando Progettazione SSIS, sarà possibile visualizzare i membri dell'insieme dei gestori di eventi nelle cartelle Gestori eventi della scheda Esplora pacchetti di Progettazione SSIS.

Per configurare il contenitore di un gestore di evento, procedere nel modo seguente:

• Specificare un nome e una descrizione per il gestore di evento.

• Indicare se il gestore di evento viene eseguito, se il pacchetto deve generare un errore in caso di errore del gestore di evento e il numero di errori che possono verificarsi prima che il gestore di evento generi a sua volta un errore.

• Specificare il risultato di esecuzione da restituire al posto di quello effettivamente restituito dal gestore di evento in fase di esecuzione.

• Specificare l'opzione relativa alle transazioni per il gestore di evento.

• Specificare la modalità di registrazione utilizzata dal gestore di evento.

Contenuto di un gestore di evento

La creazione di un gestore di evento è simile alla compilazione di un pacchetto. Un gestore di evento include attività e contenitori, ordinati in sequenza in modo da formare un flusso di controllo, e può includere anche flussi di dati. In Progettazione SSIS è disponibile la scheda Gestori eventi, che consente di creare gestori di eventi personalizzati. Per ulteriori informazioni, vedere Gestori eventi di Integration Services (SSIS).

È possibile creare gestori di eventi anche a livello di codice. Per ulteriori informazioni, vedere Gestione degli eventi a livello di programmazione.

Eventi di run-time

Nella tabella seguente vengono elencati i gestori di eventi disponibili in Integration Services e vengono descritti gli eventi di run-time che ne provocano l'esecuzione.

Gestore di evento	Evento
OnError	Gestore di evento per l'evento OnError. Questo evento viene generato da un eseguibile quando si verifica un errore.
OnExecStatusChanged	Gestore di evento per l'evento OnExecStatusChanged. Questo evento viene generato da un eseguibile quando cambia il suo stato di esecuzione.
OnInformation	Gestore di evento per l'evento OnInformation. Questo evento viene generato durante la convalida e l'esecuzione di un eseguibile, allo scopo di fornire informazioni. Questo evento fornisce solo informazioni, non errori o avvisi.
OnPostExecute	Gestore di evento per l'evento OnPostExecute. Questo evento viene generato da un eseguibile immediatamente dopo la fine dell'esecuzione.
OnPostValidate	Gestore di evento per l'evento OnPostValidate. Questo evento viene generato da un eseguibile al termine della convalida.
OnPreExecute	Gestore di evento per l'evento OnPreExecute. Questo evento viene generato da un eseguibile immediatamente prima della sua esecuzione.
OnPreValidate	Gestore di evento per l'evento OnPreValidate. Questo evento viene generato da un eseguibile all'inizio della sua convalida.
OnProgress	Gestore di evento per l'evento OnProgress. Questo evento viene generato da un eseguibile quando compie un avanzamento misurabile.
OnQueryCancel	Gestore di evento per l'evento OnQueryCancel. Questo evento viene generato da un eseguibile per determinare se l'esecuzione deve essere arrestata.
OnTaskFailed	Gestore di evento per l'evento OnTaskFailed. Questo evento viene generato da un'attività quando non riesce.
OnVariableValueChanged	Gestore di evento per l'evento OnVariableValueChanged. Questo evento viene generato da un eseguibile quando il valore di una variabile viene modificato. L'evento viene generato dall'eseguibile in cui è definita la variabile. Se la proprietà RaiseChangeEvent della variabile è impostata su False, questo evento non verrà generato. Per ulteriori informazioni, vedere Variabili di Integration Services (SSIS).
OnWarning	Gestore di evento per l'evento OnWarning. Questo evento viene generato da un eseguibile quando viene generato un avviso.

Configurazione di un gestore dell'evento

È possibile impostare le proprietà a livello di codice o nella finestra Proprietà di SQL Server Data Tools (SSDT).

Per informazioni su come impostare queste proprietà in SQL Server Data Tools (SSDT), vedere Impostazione delle proprietà di un'attività o di un contenitore.

Per informazioni sull'impostazione di queste proprietà a livello di codice, vedere DtsEventHandler.

Attività correlate

Per informazioni sull'aggiunta di un gestore dell'evento a un pacchetto, vedere Aggiunta di un gestore eventi a un pacchetto.

Contenuto correlato

Rimanere aggiornati con Integration Services Per i download, gli articoli, gli esempi e i video Microsoft più recenti, oltre alle soluzioni selezionate dalla community, visitare la pagina Integration Services sul sito MSDN: Visitare la pagina relativa a Integration Services su MSDN Per ricevere notifica automatica su questi aggiornamenti, sottoscrivere i feed RSS disponibili nella pagina.