Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Verfahren wird das Konfigurieren eines Foreach-Schleifencontainers beschrieben, einschließlich der Eigenschaftsausdrücke auf Enumerator- und Containerebene.
So konfigurieren Sie den Foreach Loop-Container
Öffnen Sie in SQL Server Data Tools (SSDT) das Integration Services-Projekt mit dem gewünschten Paket.
Klicken Sie auf die Registerkarte Ablaufsteuerung, und doppelklicken Sie auf die Foreach-Schleife.
Klicken Sie im Dialogfeld Foreach-Schleifen-Editor auf Allgemein, und ändern Sie optional den Namen und die Beschreibung der Foreach-Schleife.
Klicken Sie auf Sammlung, und wählen Sie aus der Liste Enumerator einen Enumeratortyp aus.
Geben Sie einen Enumerator an, und legen Sie die Enumeratoroptionen wie folgt fest:
Um den Foreach File Enumerator zu verwenden, geben Sie den Ordner an, der die zu aufzählenden Dateien enthält, geben Sie einen Filter für den Dateinamen und den Typ an, und geben Sie an, ob der vollqualifizierte Dateiname zurückgegeben werden soll. Bestimmen Sie außerdem, ob Unterordner nach weiteren Dateien durchsucht werden sollen.
Wenn Sie den Foreach-Element-Enumerator verwenden möchten, klicken Sie auf Spalten, und klicken Sie im Dialogfeld For Each Item-Spalten auf Hinzufügen, um Spalten hinzuzufügen. Wählen Sie in der Liste Datentyp einen Datentyp für jede Spalte aus, und klicken Sie auf OK.
Geben Sie Werte in die Spalten ein, oder wählen Sie Werte in Listen aus.
Hinweis
Klicken Sie an einer beliebigen Stelle außerhalb der Zelle, in die Sie Werte eingegeben haben, um eine neue Zeile hinzuzufügen.
Hinweis
Falls ein Wert nicht mit dem Spaltendatentyp kompatibel ist, wird der Text hervorgehoben dargestellt.
Wenn Sie den Foreach-ADO-Enumerator verwenden möchten, wählen Sie eine vorhandene Variable aus, oder Sie klicken in der Liste ADO-Objektquellvariable auf Neue Variable, um die Variable anzugeben, die den Namen des aufzuzählenden ADO-Objekts enthält, und wählen dann eine Option für den Enumerationsmodus aus.
Wenn Sie eine neue Variable erstellen, legen Sie die Variableneigenschaften im Dialogfeld Variable hinzufügen fest.
Wenn Sie den Enumerator für Foreach-ADO.NET-Schemarowsets verwenden möchten, wählen Sie eine vorhandene ADO.NET-Verbindung aus, oder klicken Sie in der Liste Verbindung auf Neue Verbindung, und wählen Sie ein Schema aus.
Klicken Sie optional auf Einschränkungen festlegen, und wählen Sie Schemaeinschränkungen aus, wählen Sie die Variable aus, die den Einschränkungswert enthält, oder geben Sie den Einschränkungswert ein, und klicken Sie auf OK.
Wenn Sie einen Foreach-Enumerator für Daten aus Variablen verwenden möchten, wählen Sie aus der Liste Variable eine Variable aus.
Um den Foreach-NodeList-Enumerator zu verwenden, klicken Sie auf „DocumentSourceType“ und wählen den Quelltyp aus der Liste aus. Anschließend klicken Sie auf „DocumentSource“. Je nach dem für „DocumentSourceType“ ausgewählten Wert wählen Sie eine Variable bzw. eine Dateiverbindung aus der Liste aus, erstellen eine neue Variable bzw. Dateiverbindung oder geben die XML-Quelle in den Dokumentquellen-Editor ein.
Klicken Sie anschließend auf „EnumerationType“, und wählen Sie einen Enumerationstyp aus der Liste aus. Wenn „EnumerationType“ den Wert Navigator, Node oder NodeText hat, klicken Sie auf „OuterXPathStringSourceType“, wählen den Quelltyp aus und klicken dann auf „OuterXPathString“. Je nach dem für „OuterXPathStringSourceType“ festgelegten Wert wählen Sie eine Variable bzw. eine Dateiverbindung aus der Liste aus, erstellen eine neue Variable bzw. Dateiverbindung oder geben die Zeichenfolge für den äußeren XPath-Ausdruck (XML Path Language) ein.
Wenn EnumerationType ElementCollection ist, legen Sie outerXPathStringSourceType und OuterXPathString wie oben beschrieben fest. Klicken Sie anschließend auf „InnerElementType“, und wählen Sie einen Enumerationstyp für die inneren Elemente aus. Klicken Sie dann auf „InnerXPathStringSourceType“. Je nachdem, welchen Wert Sie für „InnerXPathStringSourceType“ festgelegt haben, wählen Sie eine Variable bzw. eine Dateiverbindung aus, erstellen eine neue Variable bzw. Dateiverbindung oder geben die Zeichenfolge für den inneren XPath-Ausdruck ein.
Wenn Sie den Foreach-SMO-Enumerator verwenden möchten, wählen Sie eine vorhandene ADO.NET-Verbindung aus oder klicken in der Liste Verbindung auf Neue Verbindung. Dann geben Sie die zu verwendende Zeichenfolge ein oder klicken auf Durchsuchen. Dadurch haben Sie im Dialogfeld SMO-Enumeration auswählen die Möglichkeit, den aufzuzählenden Objekttyp und den Enumerationstyp auszuwählen. Klicken Sie dann auf OK.
Klicken Sie optional im Textfeld Ausdrücke auf der Seite Sammlung auf die Schaltfläche mit der Ellipse (…) , um Ausdrücke zu erstellen, mit denen Eigenschaftswerte aktualisiert werden. Weitere Informationen finden Sie unter Hinzufügen oder Ändern eines Eigenschaftsausdrucks.
Hinweis
Die in der Eigenschaftsliste aufgeführten Eigenschaften variieren je nach Enumeration.
Klicken Sie optional auf Variablenzuordnungen , um objekteigenschaften dem Auflistungswert zuzuordnen, und gehen Sie dann wie folgt vor:
Klicken Sie im Dialogfeld Variablen eine Variable aus, oder klicken Sie auf <New Variable> , um eine neue Variable zu erstellen.
Wenn Sie eine neue Variable hinzufügen, legen Sie die Variableneigenschaften im Dialogfeld Variable hinzufügen fest, und klicken Sie auf OK.
Wenn Sie den Foreach-Element-Enumerator verwenden, können Sie den Indexwert in der Liste Index aktualisieren.
Hinweis
Der Indexwert zeigt an, welche Spalte im Element der Variablen zugeordnet werden soll. Nur der Foreach-Element-Enumerator kann einen anderen Indexwert als 0 verwenden.
Klicken Sie optional auf Ausdrücke, und erstellen Sie auf der Seite Ausdrücke Eigenschaftsausdrücke für die Eigenschaften des Foreach-Schleifencontainers. Weitere Informationen finden Sie unter Hinzufügen oder Ändern eines Eigenschaftsausdrucks.
Klicke auf OK.