Freigeben über


SQL Server Integration Services-Container

Gilt für: SQL Server SSIS Integration Runtime in Azure Data Factory

Bei Containern handelt es sich um Objekte in SQL Server Integration Services, die eine Struktur für Pakete, Dienste sowie Tasks bereitstellen. Sie unterstützen das Wiederholen von Ablaufsteuerungen in Paketen und sie gruppieren Tasks und Container zu sinnvollen Arbeitseinheiten. Container können neben Tasks andere Container einschließen.

Container werden von Paketen für folgende Zwecke verwendet:

  • Wiederholen von Tasks für jedes Element in einer Auflistung, z. B. Dateien in einem Ordner, Schemas oder SMO-Objekte ( SQL Server Management Objects). Beispielsweise kann ein Paket Transact-SQL-Anweisungen ausführen, die in mehreren Dateien vorhanden sind.

  • Wiederholen von Tasks, bis ein angegebener Ausdruck zu falseausgewertet wird. Beispielsweise kann von einem Paket siebenmal eine unterschiedliche E-Mail-Nachricht gesendet werden, einmal für jeden Wochentag.

  • Gruppieren von Tasks und Containern, die als Einheit erfolgreich ausgeführt werden oder einen Fehler erzeugen müssen. Beispielsweise kann ein Paket Tasks gruppieren, mit denen Zeilen in einer Datenbanktabelle gelöscht und hinzugefügt werden, und anschließend einen Commit oder ein Rollback für alle Tasks ausführen, wenn bei einem Task ein Fehler auftritt.

Containertypen

Integration Services stellt vier verschiedene Containertypen zum Erstellen von Paketen bereit. In der folgenden Tabelle sind die Containertypen aufgeführt.

Container BESCHREIBUNG
Foreach-Schleifencontainer Führt eine Ablaufsteuerung wiederholt mithilfe eines Enumerators aus.
For-Schleifencontainer Führt eine Ablaufsteuerung wiederholt durch Testen einer Bedingung aus.
Sequenzcontainer Gruppiert Tasks und Container zu Ablaufsteuerungen, die Teilmengen der Paketablaufsteuerung sind.
Taskhostcontainer Stellt Dienste für einen einzelnen Task bereit.

Pakete und Ereignishandler sind ebenfalls Containertypen. Weitere Informationen finden Sie unter Integration Services-Pakete (SSIS) und Integration Services-Ereignishandler (SSIS).

Zusammenfassung der Containereigenschaften

Alle Containertypen haben einen Teil der Eigenschaften gemeinsam. Wenn Sie Pakete mithilfe des grafischen Tools erstellen, das von Integration Services bereitgestellt wird, werden im Eigenschaftenfenster die folgenden Eigenschaften für die Foreach-Schleife, die For-Schleife und die Sequenzcontainer aufgelistet. Die Eigenschaften für den Host-Container des Tasks werden als Teil des Tasks konfiguriert, den der Host für den Task kapselt. Sie legen die Eigenschaften des Tasks für den Host fest, wenn Sie den Task konfigurieren.

Eigenschaft BESCHREIBUNG
DelayValidation Ein boolescher Wert, der angibt, ob die Überprüfung des Containers bis zur Ausführungszeit ausgesetzt wird. Der Standardwert dieser Eigenschaft ist False.

Weitere Informationen finden Sie unter DelayValidation.
Beschreibung Die Containerbeschreibung. Die Eigenschaft enthält eine Zeichenfolge, die aber möglicherweise leer ist.

Weitere Informationen finden Sie unter Description.
Deaktivieren Ein boolescher Wert, der angibt, ob der Container ausgeführt wird. Der Standardwert dieser Eigenschaft ist False.

Weitere Informationen finden Sie unter Disable.
DisableEventHandlers Ein boolescher Wert, der angibt, ob der Ereignishandler mit dem ausgeführten Container verbunden ist. Der Standardwert dieser Eigenschaft ist False.
FailPackageOnFailure Ein boolescher Wert, der angibt, ob ein Paketfehler auftritt, wenn der Container fehlerhaft ist. Der Standardwert dieser Eigenschaft ist False.

Weitere Informationen finden Sie unter FailPackageOnFailure.
FailParentOnFailure Ein boolescher Wert, der angibt, ob ein Fehler beim übergeordneten Container auftritt, wenn der Container fehlerhaft ist. Der Standardwert dieser Eigenschaft ist False.

Weitere Informationen finden Sie unter FailParentOnFailure.
ForcedExecutionValue Ein Objekt, das den optionalen Ausführungswert für den Container enthält, falls ForceExecutionValue auf Truefestgelegt ist. Der Standardwert dieser Eigenschaft ist 0.

Weitere Informationen finden Sie unter ForcedExecutionValue.
ForcedExecutionValueType Der Datentyp von ForcedExecutionValue. Der Standardwert dieser Eigenschaft ist Int32.
ForceExecutionResult Ein Wert, der das Ergebnis der erzwungenen Ausführung des Pakets oder Containers angibt. Mögliche Werte sind None, Success, Failureund Completion. Der Standardwert dieser Eigenschaft ist None.

Weitere Informationen finden Sie unter ForceExecutionResult.
ForceExecutionValue Ein boolescher Wert, der angibt, ob ein bestimmter optionaler Ausführungswert des Containers erzwungen werden soll. Der Standardwert dieser Eigenschaft ist False.

Weitere Informationen finden Sie unter ForceExecutionValue.
ID Der Container-GUID, der dem Paket beim Erstellen zugewiesen wird. Diese Eigenschaft ist schreibgeschützt.

ID.
IsolationLevel Die Isolationsstufe der Containertransaktion. Mögliche Werte sind Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableReadSerializableund Snapshot. Der Standardwert dieser Eigenschaft ist Serializable. Weitere Informationen finden Sie unter IsolationLevel.
LocaleID Ein Microsoft Win32-Gebietsschema. Der Standardwert dieser Eigenschaft ist das Gebietsschema des Betriebssystems auf dem lokalen Computer.

Weitere Informationen finden Sie unter LocaleID.
LoggingMode Ein Wert, der das Protokollierungsverhalten des Containers angibt. Mögliche Werte sind Disabled, Enabledund UseParentSetting. Der Standardwert dieser Eigenschaft ist UseParentSetting. Weitere Informationen finden Sie unter DTSLoggingMode.
MaximumErrorCount Die maximal zulässige Anzahl von Fehlern, nach der die Ausführung eines Containers beendet wird. Der Standardwert dieser Eigenschaft ist 1.

Weitere Informationen finden Sie unter MaximumErrorCount.
Name Der Name des Containers,

Weitere Informationen finden Sie unter Name.
TransactionOption Die Transaktionsteilnahme des Containers. Mögliche Werte sind NotSupported, Supportedund Required. Der Standardwert dieser Eigenschaft ist Supported. Weitere Informationen finden Sie unter DTSTransactionOption.

Weitere Informationen zu Eigenschaften, die in Foreach-Schleifencontainer, For-Schleifencontainer, Sequenzcontainer und Taskhostcontainer verfügbar sind, wenn Sie sie programmgesteuert konfigurieren, finden Sie unter dem API-Thema von Integration Services :

  • T:Microsoft.SqlServer.Dts.Runtime.ForEachLoop

  • T:Microsoft.SqlServer.Dts.Runtime.ForLoop

  • T:Microsoft.SqlServer.Dts.Runtime.Sequence

  • T:Microsoft.SqlServer.Dts.Runtime.TaskHost

Objekte, die die Containerfunktionalität erweitern

Container enthalten Ablaufsteuerungen, die aus ausführbaren Dateien und Rangfolgeneinschränkungen bestehen und Ereignishandler und Variablen verwenden können. Der Taskhostcontainer ist eine Ausnahme, da er einen einzelnen Task kapselt und deshalb keine Rangfolgeneinschränkungen verwendet.

Ausführbare Dateien

Ausführbare Dateien beziehen sich auf die Tasks auf Containerebene und Container innerhalb des Containers. Eine ausführbare Datei kann einer der Tasks und Container sein, die Integration Services bereitstellt, oder ein benutzerdefinierter Task. Weitere Informationen finden Sie unter Integration Services-Tasks.

Rangfolgeneinschränkungen

Rangfolgeneinschränkungen verlinken Container und Tasks innerhalb desselben übergeordneten Containers zu einer geordneten Ablaufsteuerung. Weitere Informationen finden Sie unter Rangfolgeneinschränkungen.

Ereignishandler

Ereignishandler auf Containerebene entsprechen Ereignissen, die vom Container oder den darin enthaltenen Objekten ausgelöst werden. Weitere Informationen finden Sie unter Integration Services-Ereignishandler (SSIS).

Variablen

Zu Variablen, die in Containern verwendet werden, zählen die Systemvariablen auf Containerebene, die von Integration Services bereitgestellt werden, und die benutzerdefinierten Variablen, die der Container verwendet. Weitere Informationen finden Sie unter Integration Services-Variablen (SSIS).

Breakpoints

Wenn Sie einen Breakpoint für einen Container festlegen und die Unterbrechungsbedingung Unterbrechen, wenn der Container das OnVariableValueChanged-Ereignis empfängtlautet, definieren Sie die Variable im Containerbereich.

Siehe auch

Ablaufsteuerung