Pętla foreach kontenera

Kontener pętla Foreach definiuje powtarzanej przepływ sterowania w pakiet.Wykonanie pętli jest podobne do Foreach pętli struktury w językach programowania.W pakiecie pętli jest włączone za pomocą numeratora Foreach.Kontener pętla Foreach powtarza przepływ sterowania dla każdego element członkowski członkowski określonej moduł wyliczający.

SQL Server Integration Services dostępne są następujące typy moduł wyliczający:

  • Moduł wyliczający foreach ADO do sortowania wierszy w tabelach.Na przykład można uzyskać wiersze w zestawu rekordów ADO.

  • Foreach ADO.NET zestaw wierszy schematu moduł wyliczający wyliczyć informacji o schemacie o źródle danych.For example, you can enumerate and get a list of the tables in the AdventureWorks SQL Server database.

  • Moduł wyliczający plik foreach wyliczyć pliki w folderze.Moduł wyliczający mogą przechodzić przez podfoldery.Na przykład można czytać wszystkie pliki, które mają rozszerzenie nazwy pliku *.log w folderze Windows i jego podfolderach.

  • Moduł wyliczający foreach ze zmienną wyliczyć enumerable obiekt, który zawiera określoną zmienną.Enumerable obiekt może być tablicą ADO.NET DataTable, Integration Services Moduł wyliczający i tak dalej. Na przykład można wyliczyć wartości tablicę zawierającą nazwy serwerów.

  • Element Foreach modułu wyliczającego do wyliczania elementów kolekcji.Na przykład można wyliczyć nazwy plików wykonywalnych i katalogi robocze, które używa do zadania do wykonać procesu.

  • Moduł wyliczający Nodelist Foreach wyliczyć wynik zestaw wyrażenie XML ścieżka Language (XPath).Na przykład wyrażenie to wylicza i pobiera listę wszystkich autorów w okresie klasycznego: /authors/author[@period='classical'].

  • Moduł wyliczający obiekty SMO foreach wyliczyć SQL Server Zarządzanie obiektami obiekty (obiekty SMO). Na przykład wyliczyć i wyświetlić listę widoków w SQL Server Baza danych.

Poniższy diagram przedstawia kontener Foreach pętli, który jest zadaniami systemu plików.Pętla Foreach używa moduł wyliczający Foreach plik, a zadanie system plików jest skonfigurowany tak, aby skopiować plik.Jeśli folder, który określa moduł wyliczający zawiera cztery pliki, pętli powtarza się cztery razy i kopii czterech plików.

A Foreach Loop container that enumerates a folder

Kombinacji zmiennych i wyrażeń właściwość służy do aktualizowania właściwość obiektu pakiet z wartością Moduł wyliczający kolekcja.Najpierw należy mapować wartości kolekcja zmienną użytkownika, a następnie wykonania wyrażenie właściwość dotyczące właściwość, których użyto zmiennej.Na przykład wartość kolekcja plik Foreach moduł wyliczający jest mapowany do zmiennej o nazwie MyFile i zmiennej jest następnie używana w wyrażeniu właściwości dla Subject Właściwość zadania Wyślij pocztę. Po uruchomieniu pakiet, Subject Właściwość jest aktualizowane na podstawie nazwy pliku każdego czas pętli powtarzającą się. Aby uzyskać więcej informacji zobaczZa pomocą wyrażenia właściwość w pakietach.

Zmienne, które są mapowane do wartości kolekcja modułu wyliczającego można używać w wyrażeniach i skrypty.

Kontener Foreach pętla może zawierać wiele zadań i pojemniki, ale może używać tylko jednego typu moduł wyliczający.Jeśli pętli Foreach kontener zawiera więcej niż jedno zadanie, można mapować wartości kolekcja modułu wyliczającego do wielu właściwości każdego zadania.

zestaw atrybut transakcji w kontenerze pętla Foreach do definiowania transakcji dla podzbiór przepływu sterowania pakiet.W ten sposób można zarządzać transakcji poziom pętli Foreach zamiast poziom pakiet.Na przykład kontener pętla Foreach powtarza przepływ sterowania, który aktualizuje wymiarów i tabel fakt w schemacie gwiazdy, można skonfigurować transakcji, aby upewnić się, że wszystkie tabele fakt zostaną zaktualizowane pomyślnie, lub nie są aktualizowane.Aby uzyskać więcej informacji zobaczDołączanie transakcji w pakietach.

Moduł wyliczający typy

Moduły wyliczające są konfigurowane i należy podać różne informacje, w zależności od moduł wyliczający.

Poniższa tabela zawiera podsumowanie informacji wymaga każdego typu moduł wyliczający.

Moduł wyliczający

Wymagania dotyczące konfiguracja

Foreach ADO

Określ zmienną urządzenie źródłowe obiektu ADO i trybie moduł wyliczający.

Zestaw wierszy schemat ADO.NET foreach

Określ połączenie z bazą danych i schematu do wyliczenia.

Plik foreach

Określ folder i pliki do wyliczenia, format nazwy pliku pobranych plików i czy można przesyłać przez podfoldery.

Foreach ze zmienną

Określ zmienną, która zawiera obiekty do wyliczenia.

Element Foreach

Definiowanie elementów w kolekcja element Foreach, włączając w to kolumna s i kolumna typów danych.

Nodelist foreach

Określ urządzenie źródłowe dokumentu XML i konfigurowanie operacji XPath.

Obiekty SMO foreach

Określ połączenie z bazą danych i obiektów obiekty SMO do wyliczenia.

Za pomocą wyrażenia właściwość w pętli Foreach kontenerów

Pakiety można skonfigurować tak, aby jednocześnie uruchamiać wielu plików wykonywalnych.Konfiguracja ta powinna być używana z rozwagą, gdy pakiet zawiera kontener Foreach pętli, który implementuje właściwość wyrażenia.

Często przydatne jest wdrożenie wyrażenie właściwości, aby ustawić wartość ConnectionString Właściwość menedżerów połączenie, używające moduły wyliczające Foreach pętli. Właściwość wyrażenie ConnectionString zestaw za zmienna, która mapuje do wartości kolekcja moduł wyliczający i jest aktualizowany po każdej iteracji pętli.

Aby uniknąć negatywne skutki nondeterminative czas wykonywanie równoległe zadań w pętli, pakiet powinny być konfigurowane do uruchamiania w danej chwili tylko jeden plik wykonywalny.Na przykład jeśli pakiet może uruchamiania wielu zadań jednocześnie, kontener Foreach pętli, w którym wylicza pliki w folderze, pobiera nazwy plików, a następnie używa wykonać instrukcji SQL, zadania, wstawianie nazwy pliku do tabela może ponieść konfliktu zapisu podczas próby zapisu w tym samym czasie dwóch wystąpień zadania wykonać instrukcji SQL.Aby uzyskać więcej informacji zobaczZa pomocą wyrażenia właściwość w pakietach.

Konfigurowanie kontener Foreach pętli

zestaw właściwości za pomocą SSIS Projektant lub programowo.

Aby uzyskać więcej informacji na temat właściwości, które zestaw w SSIS Projektant, kliknij jedną z następujących tematów:

Aby uzyskać więcej informacji na temat sposobu zestaw te właściwości w SSIS Projektant, kliknij jedną z następujących tematów:

Konfigurowanie kontener pętla Foreach programowe

Aby uzyskać więcej informacji na temat programowego ustawianiu tych właściwości kliknij następujący temat:

  • ForEachLoop
Integration Services icon (small) Konfiguracja w aktualizacji z usług integracja Services pobytu

Najnowsze pliki do pobrania, artykuły, próbki, i pliki wideo firmy Microsoft, jak również wybranego rozwiązania od Wspólnoty, odwiedź witrynę Integration Services strona w witrynie MSDN lub TechNet:

Automatycznego powiadomienie tych aktualizacji należy subskrybować źródła danych RSS, które jest dostępne strona.