Contenitori in Integration Services
I contenitori sono oggetti di SQL Server Integration Services che forniscono la struttura ai pacchetti e i servizi alle attività. Supportano la ripetizione dei flussi di controllo nei pacchetti e consentono di raggruppare attività e contenitori in unità di lavoro significative. Oltre alle attività, i contenitori possono includere anche altri contenitori.
Nei pacchetti i contenitori vengono utilizzati per gli scopi seguenti:
Ripetere determinate attività per ogni elemento di una raccolta, ad esempio i file in una cartella, schemi o oggetti SMO (SQL Server Management Objects). Un pacchetto può ad esempio eseguire istruzioni Transact-SQL disponibili in più file.
Ripetere determinate attività finché un'espressione specificata non restituisce false. Un pacchetto può ad esempio inviare un messaggio di posta elettronica diverso per sette volte, ovvero uno per ogni giorno della settimana.
Creare gruppi di attività e contenitori che devono avere esito positivo o negativo come singola unità. Un pacchetto può ad esempio raggruppare attività che eliminano e aggiungono righe in una tabella di database e quindi eseguire il commit o il rollback di tutte le attività quando una di queste non riesce.
Tipi di contenitori
In Integration Services sono disponibili quattro tipi di contenitori per la compilazione dei pacchetti, elencati nella tabella seguente.
Contenitore |
Descrizione |
|---|---|
Esegue ripetutamente un determinato flusso di controllo utilizzando un enumeratore. |
|
Esegue ripetutamente un determinato flusso di controllo verificando una condizione. |
|
Raggruppa attività e contenitori in flussi di controllo che costituiscono subset del flusso di controllo del pacchetto. |
|
Fornisce servizi a una singola attività. |
Anche i gestori dell'evento e i pacchetti sono tipi di contenitori. Per informazioni, vedere Pacchetti di Integration Services (SSIS) e Gestori eventi di Integration Services (SSIS).
Riepilogo delle proprietà dei contenitori
Tutti i tipi di contenitori dispongono di un set di proprietà comune. Se si creano pacchetti utilizzando gli strumenti grafici offerti da Integration Services, per i contenitori Ciclo Foreach, Ciclo For e Sequenza vengono elencate nella finestra Proprietà le proprietà seguenti. Le proprietà dei contenitori host delle attività vengono configurate nell'ambito della configurazione dell'attività incapsulata nell'host. Le proprietà degli host delle attività vengono impostate quando si configura l'attività.
Proprietà |
Descrizione |
|---|---|
DelayValidation |
Valore booleano che indica se la convalida del contenitore viene posticipata fino alla fase di esecuzione. Il valore predefinito di questa proprietà è False. Per ulteriori informazioni, vedere DelayValidation. |
Description |
Descrizione del contenitore. La proprietà contiene una stringa, ma può essere vuota. Per ulteriori informazioni, vedere Description. |
Disable |
Valore booleano che indica se il contenitore verrà eseguito. Il valore predefinito di questa proprietà è False. Per ulteriori informazioni, vedere Disable. |
DisableEventHandlers |
Valore booleano che indica se i gestori di eventi associati al contenitore verranno eseguiti. Il valore predefinito di questa proprietà è False. |
FailPackageOnFailure |
Valore booleano che specifica se il pacchetto deve essere interrotto in caso di errore nel contenitore. Il valore predefinito di questa proprietà è False. Per ulteriori informazioni, vedere FailPackageOnFailure. |
FailParentOnFailure |
Valore booleano che specifica se il contenitore padre deve essere interrotto in caso di errore nel contenitore. Il valore predefinito di questa proprietà è False. Per ulteriori informazioni, vedere FailParentOnFailure. |
ForcedExecutionValue |
Se la proprietà ForceExecutionValue è impostata su True, rappresenta l'oggetto che contiene il valore di esecuzione facoltativo restituito per il contenitore. Il valore predefinito della proprietà è 0. Per ulteriori informazioni, vedere ForcedExecutionValue. |
ForcedExecutionValueType |
Tipo di dati di ForcedExecutionValue. Il valore predefinito di questa proprietà è Int32. |
ForceExecutionResult |
Valore che specifica il risultato forzato dell'esecuzione del pacchetto o del contenitore. I valori sono None, Success, Failure e Completion. Il valore predefinito di questa proprietà è None. Per ulteriori informazioni, vedere ForceExecutionResult. |
ForceExecutionValue |
Valore booleano che specifica se il valore di esecuzione facoltativo del contenitore deve essere forzato in modo da contenere un valore specifico. Il valore predefinito di questa proprietà è False. Per ulteriori informazioni, vedere ForceExecutionValue. |
ID |
GUID del contenitore, assegnato al momento della creazione del pacchetto. Questa proprietà è in sola lettura. ID. |
IsolationLevel |
Livello di isolamento della transazione del contenitore. I possibili valori sono Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializable e Snapshot. Il valore predefinito di questa proprietà è Serializable. Per ulteriori informazioni, vedere IsolationLevel. |
LocaleID |
Impostazioni locali Microsoft Win32. Il valore predefinito di questa proprietà è costituito dalle impostazioni locali del sistema operativo sul computer locale. Per ulteriori informazioni, vedere LocaleID. |
LoggingMode |
Valore che specifica il comportamento di registrazione del contenitore. I possibili valori sono Disabled, Enabled e UseParentSetting. Il valore predefinito di questa proprietà è UseParentSetting. Per ulteriori informazioni, vedere DTSLoggingMode. |
MaximumErrorCount |
Numero massimo di errori che possono verificarsi prima che l'esecuzione del contenitore venga arrestata. Il valore predefinito di questa proprietà è 1. Per ulteriori informazioni, vedere MaximumErrorCount. |
Name |
Nome del contenitore. Per ulteriori informazioni, vedere Name. |
TransactionOption |
Supporto delle transazioni da parte del contenitore. I possibili valori sono NotSupported, Supported e Required. Il valore predefinito di questa proprietà è Supported. Per ulteriori informazioni, vedere DTSTransactionOption. |
Per ulteriori informazioni su tutte le proprietà disponibili per i contenitori Ciclo Foreach, Ciclo For, Sequenza e host delle attività durante la relativa configurazione a livello di codice, vedere gli argomenti relativi alle API di Integration Services seguenti:
T:Microsoft.SqlServer.Dts.Runtime.ForEachLoop
T:Microsoft.SqlServer.Dts.Runtime.ForLoop
T:Microsoft.SqlServer.Dts.Runtime.Sequence
T:Microsoft.SqlServer.Dts.Runtime.TaskHost
Oggetti che estendono le funzionalità dei contenitori
I contenitori includono flussi di controllo costituiti da eseguibili e vincoli di precedenza. Possono inoltre utilizzare variabili e gestori di eventi. Il contenitore Host attività costituisce un'eccezione perché, dal momento che incapsula una singola attività, non utilizza vincoli di precedenza.
Eseguibili
Il termine eseguibile si riferisce alle attività a livello di contenitore e a qualsiasi contenitore all'interno del contenitore in considerazione. Un eseguibile può essere costituito da uno dei contenitori e delle attività disponibili in Integration Services oppure da un'attività personalizzata. Per ulteriori informazioni, vedere Attività di Integration Services e Contenitori in Integration Services.
Vincoli di precedenza
I vincoli di precedenza collegano in un flusso di controllo ordinato i contenitori e le attività presenti in uno stesso contenitore padre. Per ulteriori informazioni, vedere Vincoli di precedenza.
Gestori di eventi
I gestori di eventi a livello di contenitore rispondono agli eventi generati dal contenitore o dagli altri oggetti inclusi al suo interno. Per ulteriori informazioni, vedere Gestori eventi di Integration Services (SSIS).
Variabili
Le variabili utilizzate nei contenitori includono le variabili di sistema a livello di contenitore disponibili in Integration Services e le variabili definite dall'utente utilizzate dal contenitore. Per ulteriori informazioni, vedere Variabili di Integration Services (SSIS).
Punti di interruzione
Quando si imposta un punto di interruzione in un contenitore e la condizione di interruzione è Interrompi quando il contenitore riceve l'evento OnVariableValueChanged, definire la variabile nell'ambito del contenitore.
Contenuto correlato
|
.gif "Icona di Integration Services (piccola)")
Rimanere aggiornati con Integration Services