Gestori di eventi in Integration Services

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 Aggiunta di gestori di eventi per i pacchetti.

È possibile creare gestori di eventi anche a livello di programmazione. 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 in Integration Services.
OnWarning	Gestore di evento per l'evento OnWarning. Questo evento viene generato da un eseguibile quando viene generato un avviso.

Configurazione di un gestore di evento

È possibile impostare le proprietà a livello di programmazione o nella finestra Proprietà di Business Intelligence Development Studio.

Per ulteriori informazioni su come impostare tali proprietà in Business Intelligence Development Studio, vedere Procedura: Impostazione delle proprietà di un'attività o di un contenitore.

Configurare un gestore di evento a livello di programmazione

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

Rimanere aggiornati con Integration Services Per informazioni sui download, gli articoli, gli esempi e i video Microsoft più recenti, nonché sulle soluzioni selezionate dalla community, visitare la pagina Integration Services su MSDN o Technet: Visitare la pagina relativa a Integration Services su MSDN Visitare la pagina relativa a Integration Services su TechNet Per ricevere notifica automatica su questi aggiornamenti, sottoscrivere i feed RSS disponibili nella pagina.

Vedere anche

Concetti

Informazioni sui componenti di un pacchetto di Integration Services