Foreach-Schleifencontainer

Der Foreach-Schleifencontainer definiert die Wiederholung einer Ablaufsteuerung in einem Paket. Die Schleifenimplementierung ist mit der Foreach-Schleifenstruktur in Programmiersprachen zu vergleichen. In einem Paket wird die Schleife mithilfe eines Foreach-Enumerators ermöglicht. Der Foreach-Schleifencontainer wiederholt die Ablaufsteuerung für jedes Mitglied eines angegebenen Enumerators.

SQL Server 2005 Integration Services (SSIS) stellt die folgenden Enumeratortypen bereit:

• Foreach-ADO-Enumerator zum Aufzählen von Zeilen in Tabellen. Beispielsweise können Sie die Zeilen in einem ADO-Recordset abrufen.
• Enumerator für Foreach-ADO.NET-Schemarowset zum Aufzählen der Schemainformationen zu einer Datenquelle. Beispielsweise können Sie die Tabellen in der AdventureWorks SQL Server-Datenbank aufzählen und eine Liste dafür abrufen.
• Foreach-Dateienumerator zum Aufzählen von Dateien in einem Ordner. Der Enumerator kann Unterordner durchsuchen. Beispielsweise können Sie alle Dateien mit der Dateinamenerweiterung LOG im Windows-Ordner und deren Unterordner lesen.
• Foreach-Enumerator für Daten aus Variable zum Aufzählen des aufzählbaren Objekts, das eine angegebene Variable enthält. Das aufzählbare Objekt kann z. B. ein Array, ein ADO.NET DataTable-Objekt oder ein Integration Services-Enumerator sein. Beispielsweise können Sie die Werte eines Arrays aufzählen, das den Namen der Server enthält.
• Foreach Item-Enumerator zum Aufzählen von Elementen, bei denen es sich um Auflistungen handelt. Beispielsweise können Sie die Namen der ausführbaren Dateien und Arbeitsverzeichnisse aufzählen, die ein Task Prozess ausführen verwendet.
• Foreach-NodeList-Enumerator zum Aufzählen des Resultsets eines XPATH-Ausdrucks (XML Path Language). Beispielsweise kann dieser Ausdruck alle Autoren der Klassik aufzählen und eine Liste dafür abrufen: /authors/author[@period='classical'].
• Foreach-SMO-Enumerator zum Aufzählen von SMO-Objekten (SQL Server Management Objects). Beispielsweise können Sie die Sichten in einer SQL Server-Datenbank aufzählen und eine Liste dafür abrufen.

Das folgende Diagramm zeigt einen Foreach-Schleifencontainer mit einem Task Dateisystem. Die Foreach-Schleife verwendet den Foreach-Dateienumerator, und der Task Dateisystem ist so konfiguriert, dass eine Datei kopiert wird. Falls der vom Enumerator angegebene Ordner vier Dateien enthält, wird die Schleife viermal wiederholt, und die vier Dateien werden kopiert.

Sie können eine Kombination aus Variablen und Eigenschaftsausdrücken verwenden, um für die Paketobjekteigenschaft den Enumeratorauflistungswert zu aktualisieren. Zunächst ordnen Sie den Auflistungswert einer benutzerdefinierten Variablen zu. Anschließend implementieren Sie einen Eigenschaftsausdruck für die Eigenschaft, die die Variable verwendet. Beispielsweise wird der Auflistungswert des Foreach-Dateienumerators der Variablen MyFile zugeordnet, und die Variable wird dann im Eigenschaftsausdruck für die Subject-Eigenschaft eines Tasks Mail senden verwendet. Beim Ausführen des Pakets wird die Subject-Eigenschaft bei jeder Wiederholung der Schleife mit dem Namen einer Datei aktualisiert. Weitere Informationen finden Sie unter Verwendung von Eigenschaftsausdrücken in Paketen.

Variablen, die dem Enumeratorauflistungswert zugeordnet sind, können ebenfalls in Ausdrücken und Skripts verwendet werden.

Ein Foreach-Schleifencontainer kann mehrere Tasks und Container einschließt, kann aber nur einen Enumeratortyp verwenden. Falls der Foreach-Schleifencontainer mehrere Tasks einschließt, können Sie den Enumeratorauflistungswert mehreren Eigenschaften jedes Tasks zuordnen.

Sie können ein Transaktionsattribut für den Foreach-Schleifencontainer festlegen, um eine Transaktion für eine Teilmenge der Paketablaufsteuerung zu definieren. Auf diese Weise können Sie Transaktionen statt auf der Paketebene auf der Ebene der Foreach-Schleife verwalten. Wenn z. B. ein Foreach-Schleifencontainer eine Ablaufsteuerung wiederholt, die Dimensions- und Faktentabellen in einem Sternschema aktualisiert, können Sie eine Transaktion konfigurieren, um sicherzustellen, dass entweder alle oder überhaupt keine Faktentabellen aktualisiert werden. Weitere Informationen finden Sie unter Integrieren von Transaktionen in Pakete.

Enumeratortypen

Enumeratoren sind konfigurierbar, und je nach Enumerator müssen Sie unterschiedliche Informationen bereitstellen.

In der folgenden Tabelle sind die Informationen zusammengefasst, die für jeden Enumeratortyp erforderlich sind.

Enumerator	Konfigurationsanforderungen
Foreach-ADO-Enumerator	Geben Sie die ADO-Objektquellvariable und den Enumeratormodus an.
Enumerator für Foreach-ADO.NET-Schemarowset	Geben Sie die Verbindung mit einer Datenbank und das aufzuzählende Schema an.
Foreach-Dateienumerator	Geben Sie einen Ordner sowie die aufzuzählenden Dateien und das Format des Dateinamens der abgerufenen Dateien an. Geben Sie darüber hinaus an, ob Unterordner durchsucht werden sollen.
Foreach-Enumerator für Daten aus Variable	Geben Sie die Variable an, die die aufzuzählenden Objekte enthält.
Foreach Item-Enumerator	Definieren Sie die Elemente in der Foreach Item-Auflistung, einschließlich der Spalten und Spaltendatentypen.
Foreach-NodeList-Enumerator	Geben Sie die Quelle des XML-Dokuments an, und konfigurieren Sie den XPath-Vorgang.
Foreach-SMO-Enumerator	Geben Sie die Verbindung mit einer Datenbank und die aufzuzählenden SMO-Objekte an.

Verwenden von Eigenschaftsausdrücken in Foreach-Schleifencontainern

Pakete können so konfiguriert werden, dass mehrere ausführbare Dateien gleichzeitig ausgeführt werden. Diese Konfiguration sollte mit Vorsicht verwendet werden, wenn das Paket einen Foreach-Schleifencontainer enthält, der Eigenschaftsausdrücke implementiert.

Es ist häufig nützlich, einen Eigenschaftsausdruck zu implementieren, um den Wert der ConnectionString-Eigenschaft des Verbindungs-Managers, den die Foreach-Schleifenenumeratoren verwenden, festzulegen. Der Eigenschaftsausdruck der ConnectionString-Eigenschaft wird durch eine Variable festgelegt, die dem Auflistungswert des Enumerators zugeordnet ist und bei jeder Iteration der Schleife aktualisiert wird.

Das Paket sollte so konfiguriert sein, dass jeweils nur eine ausführbare Datei ausgeführt wird, um in der Schleife negative Auswirkungen einer unbestimmten Zeitvorgabe der parallelen Taskausführung zu vermeiden. Wenn beispielsweise ein Paket mehrere Tasks gleichzeitig ausführen kann, können bei einem Foreach-Schleifencontainer, der im Ordner vorhandene Dateien aufzählt, die Dateinamen abruft und dann mithilfe eines Tasks SQL ausführen die Dateinamen in eine Tabelle einfügt, Schreibkonflikte auftreten, wenn zwei Instanzen des Tasks SQL ausführen versuchen, zur selben Zeit zu schreiben. Weitere Informationen finden Sie unter Verwendung von Eigenschaftsausdrücken in Paketen.

Konfigurieren des Foreach-Schleifencontainers

Eigenschaften können Sie mit dem SSIS-Designer oder programmgesteuert festlegen.

Klicken Sie auf eines der folgenden Themen, um weitere Informationen zu den Eigenschaften zu erhalten, die Sie im SSIS-Designer festlegen können:

• Foreach-Schleifen-Editor (Seite Allgemein)
• Foreach-Schleifen-Editor (Seite Auflistung)
• Foreach-Schleifen-Editor (Seite Variablenzuordnungen)
• Seite Ausdrücke

Klicken Sie auf eines der folgenden Themen, um weitere Informationen zum Festlegen dieser Eigenschaften im SSIS-Designer zu erhalten:

• Vorgehensweise: Konfigurieren eines Foreach-Schleifencontainers
• Vorgehensweise: Festlegen von Containereigenschaften

Programmgesteuertes Konfigurieren des Foreach-Schleifencontainers

Klicken Sie auf das folgende Thema, um weitere Informationen zum programmgesteuerten Festlegen dieser Eigenschaften zu erhalten:

• ForEachLoop

Siehe auch

Konzepte

Erstellen einer Paketablaufsteuerung
SQL Server Integration Services-Container

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf

Version	Verlauf
05. Dezember 2005	Neuer Inhalt: Informationen zum Verwenden von Variablen und Eigenschaftsausdrücken in der Foreach-Schleife wurden hinzugefügt.