Share via


Contenitori in Integration Services

Data aggiornamento: 14 aprile 2006

In SQL Server 2005 Integration Services (SSIS) i contenitori sono oggetti che forniscono a pacchetti e servizi la struttura necessaria per l'esecuzione delle 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 un insieme, 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 creazione dei pacchetti, elencati nella tabella seguente.

Contenitore Descrizione

Contenitore Ciclo Foreach

Esegue ripetutamente un determinato flusso di controllo utilizzando un enumeratore.

Contenitore Ciclo For

Esegue ripetutamente un determinato flusso di controllo verificando una condizione.

Contenitore Sequenza

Raggruppa attività e contenitori in flussi di controllo che costituiscono subset del flusso di controllo del pacchetto.

Contenitore Host delle attività

Fornisce servizi a una singola attività.

Anche i gestori dell'evento e i pacchetti sono tipi di contenitori. Per informazioni, vedere Pacchetti Integration Services e Gestori di eventi in Integration Services.

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

Indica se la convalida del contenitore viene posticipata fino alla fase di esecuzione. La proprietà contiene un valore booleano e il valore è False.

Description

Descrizione del contenitore. La proprietà contiene una stringa, ma può essere vuota.

Disable

Indica se il contenitore verrà eseguito. La proprietà contiene un valore booleano e il valore predefinito è False.

DisableEventHandlers

Indica se i gestori di eventi associati al contenitore verranno eseguiti. La proprietà contiene un valore booleano e il valore predefinito è False.

FailPackageOnFailure

Specifica se il pacchetto deve essere interrotto in caso di errore nel contenitore. La proprietà contiene un valore booleano e il valore predefinito è False.

FailParentOnFailure

Specifica se il contenitore padre deve essere interrotto in caso di errore nel contenitore. La proprietà contiene un valore booleano e il valore predefinito è False.

ForcedExecutionValue

Se la proprietà ForceExecutionValue è impostata su True, valore che specifica il valore di esecuzione restituito dal contenitore. Il valore predefinito della proprietà è 0.

ForcedExecutionValueType

Tipo di dati di ForcedExecutionValue.

ForceExecutionResult

Specifica se il valore di esecuzione del contenitore è forzato. La proprietà contiene un valore booleano e il valore predefinito è False.

ForceExecutionValue

Risultato dell'esecuzione del contenitore. I possibili valori sono None, Success, Failure e Completion. Il valore predefinito della proprietà è None. Per ulteriori informazioni, vedere T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult.

ID

GUID del contenitore, assegnato al momento della creazione del pacchetto. Questa proprietà è di sola lettura.

IsolationLevel

Livello di isolamento della transazione del contenitore. I possibili valori sono Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializable e Snapshot. Il valore predefinito della proprietà è Serializable. Per ulteriori informazioni, vedere IsolationLevel.

LocaleID

Impostazioni internazionali Microsoft Win32. Il valore predefinito di questa proprietà è costituito dalle impostazioni internazionali del sistema operativo sul computer locale.

LoggingMode

Valore che specifica il comportamento di registrazione del contenitore. I possibili valori sono Disabled, Enabled e UseParentSetting. Il valore predefinito della proprietà è UseParentSetting. Per ulteriori informazioni, vedere DTSLoggingMode.

MaximumErrorCount

Numero massimo di errori che si possono verificare prima che l'esecuzione del contenitore venga interrotta. Il valore predefinito della proprietà è 1.

Name

Nome del contenitore.

TransactionOption

Supporto delle transazioni da parte del contenitore. I possibili valori sono NotSupported, Supported e Required. Il valore predefinito della 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 programmazione, vedere gli argomenti relativi alle API di Integration Services seguenti:

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 dell'evento

I gestori dell'evento a livello di contenitore rispondono agli eventi generati dal contenitore o dagli altri oggetti inclusi al suo interno. Per ulteriori informazioni, vedere Gestori di eventi in Integration Services.

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 in Integration Services.

Cronologia delle modifiche

Versione Cronologia

14 aprile 2006

Nuovo contenuto:
  • Aggiunta della sezione in cui vengono descritte le proprietà dei contenitori.

Vedere anche

Concetti

Elementi del flusso di controllo

Guida in linea e informazioni

Assistenza su SQL Server 2005