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.

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