Foreach ループ コンテナー

  • [アーティクル]

適用対象: SQL Server Azure Data Factory の SSIS Integration Runtime

Foreach ループ コンテナーは、パッケージ内で繰り返す制御フローを定義します。 ループの実装は、プログラミング言語の Foreach ループ構造と同様です。 パッケージでは、ループは Foreach 列挙子を使用することで有効になります。 Foreach ループ コンテナーは、指定した列挙子のメンバーが処理されるたびに制御フローを繰り返します。

SQL Server Integration Services では、次の種類の列挙子が用意されています。

  • Foreach ADO 列挙子は、テーブル内の行を列挙します。 たとえば、ADO レコードセット内の行を取得できます。

    レコードセット変換先では、 Object データ型のパッケージ変数に格納されるレコードセットのメモリにデータが保存されます。 通常は、Foreach ループ コンテナーと Foreach ADO 列挙子を使用して、一度に 1 つのレコードセット行を処理します。 Foreach ADO 列挙子に指定する変数は、Object データ型である必要があります。 レコードセット変換先の詳細については、「レコードセット変換先を使用する」を参照してください。

  • Foreach ADO.NET Schema Rowset 列挙子は、データ ソースに関するスキーマ情報を列挙します。 たとえば、AdventureWorks2022 SQL Server データベースのテーブルを列挙して一覧を取得できます。

  • Foreach File 列挙子は、フォルダー内のファイルを列挙します。 この列挙子は、サブフォルダーをスキャンできます。 たとえば、Windows フォルダーとそのサブフォルダー内から、ファイル名に拡張子 *.log が付いたファイルをすべて読み取ることができます。 ファイルを取得する順序は指定できないことに注意してください。

  • Foreach From Variable 列挙子は、指定した変数に含まれる列挙可能なオブジェクトを列挙します。 列挙可能なオブジェクトは、配列、ADO.NET DataTable、 Integration Services 列挙子などです。 たとえば、サーバーの名前を含む配列の値を列挙できます。

  • Foreach Item 列挙子は、コレクション内のアイテムを列挙します。 たとえば、プロセス実行タスクで使用する実行可能ファイルおよび作業ディレクトリの名前を列挙できます。

  • Foreach Nodelist 列挙子は、XML パス言語 (XPath) 式の結果セットを列挙します。 たとえば、 /authors/author[@period='classical']の式は、古典時代のすべての作家を列挙して一覧を取得します。

  • Foreach SMO 列挙子は、 SQL Server 管理オブジェクト (SMO) オブジェクトを列挙します。 たとえば、 SQL Server データベース内のビューを列挙して一覧を取得できます。

  • Foreach HDFS ファイル列挙子は、指定した HDFS の場所にある HDFS ファイルを列挙します。

  • Foreach Azure BLOB 列挙子は、Azure Storage の BLOB コンテナーで BLOB を列挙します。

  • Foreach ADLS File 列挙子は、Azure Data Lake Store のディレクトリのファイルを列挙します。

  • Foreach Data Lake Storage Gen2 File 列挙子では、Azure Data Lake Store Gen2 のディレクトリのファイルを列挙します。

次の図は、ファイル システム タスクを含む Foreach ループ コンテナーを示しています。 Foreach ループは Foreach File 列挙子を使用し、ファイル システム タスクがファイルをコピーするように構成します。 列挙子が指定するフォルダーに 4 つのファイルが含まれる場合、ループが 4 回繰り返されて 4 つのファイルがコピーされます。

フォルダーを列挙する Foreach ループ コンテナー

変数とプロパティ式を組み合わせて使用すると、パッケージ オブジェクトのプロパティを列挙子のコレクションの値で更新できます。 最初にコレクションの値をユーザー定義変数にマップし、次に、変数を使用するプロパティにプロパティ式を実装します。 たとえば、Foreach File 列挙子のコレクションの値を MyFile という変数にマップし、次に、この変数をメール送信タスクの Subject プロパティのプロパティ式で使用します。 パッケージを実行すると、Subject プロパティは、ループが繰り返されるたびにファイルの名前で更新されます。 詳細については、「 パッケージでプロパティ式を使用する」を参照してください。

列挙子のコレクションの値にマップされた変数は、式とスクリプトでも使用できます。

Foreach ループ コンテナーには複数のタスクとコンテナーを含めることができますが、使用できる列挙子は 1 種類のみです。 Foreach ループ コンテナーに複数のタスクが含まれる場合、列挙子のコレクションの値は各タスクの複数のプロパティにマップできます。

Foreach ループ コンテナー上でトランザクションの属性を設定し、パッケージ制御フローのサブセットのトランザクションを定義できます。 この方法により、トランザクションをパッケージ レベルではなく Foreach ループ レベルで管理できます。 たとえば、Foreach ループ コンテナーが、スター スキーマ内のディメンション テーブルおよびファクト テーブルを更新する制御フローを繰り返す場合、トランザクションを構成して、すべてのファクト テーブルが正しく更新されるようにしたり、ファクト テーブルを更新しないようにすることができます。 詳細については、「 Integration Services のトランザクション」をご覧ください。

列挙子の種類

列挙子は構成可能ですが、列挙子に応じて、それぞれ異なる情報を指定する必要があります。

次の表に、各種列挙子で必要な情報の概要を示します。

列挙子 構成要件
Foreach ADO ADO オブジェクトの基になる変数と、列挙子モードを指定します。 変数は、Object データ型である必要があります。
Foreach ADO.NET Schema Rowset データベースへの接続と、列挙するスキーマを指定します。
Foreach File フォルダーと、列挙するファイル、取得するファイルのファイル名の形式、およびサブフォルダーをスキャンするかどうかを指定します。
Foreach From Variable 列挙するオブジェクトが含まれる変数を指定します。
Foreach Item 列や列のデータ型など、Foreach Item コレクション内のアイテムを定義します。
Foreach Nodelist XML ドキュメントの基になる XML ドキュメントを指定し、XPath 操作を構成します。
Foreach SMO データベースへの接続と、列挙する SMO オブジェクトを指定します。
Foreach HDFS File Enumerator (Foreach HDFS ファイル列挙子) フォルダーと、列挙するファイル、取得するファイルのファイル名の形式、およびサブフォルダーをスキャンするかどうかを指定します。
Foreach Azure BLOB 列挙する BLOB を含む Azure Blob Storage コンテナーを指定します。
Foreach ADLS File 列挙するファイルを含む Azure Data Lake Store ディレクトリの名前を指定します。
Foreach Data Lake Storage Gen2 ファイル 列挙するファイルを含む Azure Data Lake Storage Gen2 ディレクトリを、その他のオプションと共に指定します。

Foreach ループ コンテナーを含む制御フローに列挙を追加する

Integration Services には、Foreach ループ コンテナーが含まれています。Foreach ループ コンテナーとは制御フローの要素で、これを使用すると、パッケージの制御フロー内のファイルおよびオブジェクトを列挙するループ構造を簡単に含めることができます。 詳細については、「 Foreach ループ コンテナー」を参照してください。

Foreach ループ コンテナーに機能は用意されていません。繰り返し可能な制御フローの構築、列挙子の型の指定、および列挙子の構成を行う構造を提供するだけです。 コンテナーに機能を設定するには、Foreach ループ コンテナーに少なくとも 1 つのタスクを含める必要があります。 詳細については、「 Integration Services のタスク」を参照してください。

Foreach ループ コンテナーには、複数のタスクを持つ制御フローおよび他のコンテナーを含めることができます。 Foreach ループ コンテナーにタスクとコンテナーを追加する手順は、タスクとコンテナーをドラッグする先がパッケージではなく Foreach ループ コンテナーであること以外は、パッケージに追加する手順と同様です。 Foreach ループ コンテナーに複数のタスクまたはコンテナーが含まれる場合、パッケージで行う場合と同様に、優先順位制約を使用してそれらを連結できます。 詳細については、「 優先順位制約」を参照してください。

Foreach ループ コンテナーを追加し、構成する

  1. Foreach ループ コンテナーをパッケージに追加します。 詳細については、「 制御フローのタスクまたはコンテナーを追加または削除する」を参照してください。

  2. タスクとコンテナーを Foreach ループ コンテナーに追加します。 詳細については、「 制御フローのタスクまたはコンテナーを追加または削除する」を参照してください。

  3. 優先順位制約を使用して、Foreach ループ コンテナー内のタスクとコンテナーを連結します。 詳細については、「 既定の優先順位制約を使用してタスクとコンテナーを連結する」を参照してください。

  4. Foreach ループ コンテナーを構成します。 詳細については、「 Foreach ループ コンテナーを構成する」を参照してください。

Foreach ループ コンテナーを構成する

この手順では、列挙子レベルおよびコンテナー レベルでのプロパティ式など、Foreach ループ コンテナーを構成する方法について説明します。

  1. SQL Server Data Tools (SSDT)で、目的のパッケージが含まれている Integration Services プロジェクトを開きます。

  2. [制御フロー] タブをクリックし、Foreach ループをダブルクリックします。

  3. [Foreach ループ エディター] ダイアログ ボックスで [全般] をクリックし、必要に応じて Foreach ループの名前と説明を変更します。

  4. [コレクション] をクリックし、 [Enumerator] 一覧から列挙子の型を選択します。

  5. 列挙子を指定し、列挙子のオプションを次のように設定します。

    • Foreach File 列挙子を使用するには、列挙するファイルが含まれるフォルダーを指定し、ファイル名と種類に対するフィルターを指定します。次に、完全修飾ファイル名を返すかどうかを指定します。 また、サブフォルダーを再帰的に使用して、より多くのファイルを列挙するかどうかを指定します。

    • Foreach Item 列挙子を使用するには、 [列] をクリックし、 [For Each Item 列] ダイアログ ボックスで [追加] をクリックして列を追加します。 [データ型] 一覧で各列のデータ型を選択し、 [OK] をクリックします。

      列の値を入力するか、一覧から値を選択します。

      注意

      新しい行を追加するには、入力したセルの外側の任意の場所をクリックします。

      注意

      値が列のデータ型と互換性がない場合、テキストが強調表示されます。

    • Foreach ADO 列挙子を使用するには、 [ADO オブジェクト ソース変数] の一覧で既存の変数を選択するか、または [新しい変数] をクリックして、列挙する ADO オブジェクトの名前を保持する変数を指定します。次に、列挙モードのオプションを選択します。

      新しい変数を作成する場合、 [変数の追加] ダイアログ ボックスで変数のプロパティを設定します。

    • Foreach ADO.NET Schema Rowset 列挙子を使用するには、 [接続] 一覧で既存の ADO.NET 接続を選択するか、または [新しい接続] をクリックします。次に、スキーマを選択します。

      必要に応じて、 [制限の設定] をクリックしてスキーマの制限を選択するか、制限値が含まれる変数を選択するか、または制限値を入力します。次に、 [OK] をクリックします。

    • Foreach From Variable 列挙子を使用するには、 [変数] 一覧で変数を選択します。

    • Foreach NodeList 列挙子を使用するには、[DocumentSourceType] をクリックし、リストからソースの種類を選択し、[DocumentSource] をクリックします。 選択した DocumentSourceType の値に応じて、一覧から変数またはファイル接続を選択するか、新しい変数またはファイル接続を作成するか、 [ドキュメント ソース エディター] で XML ソースを入力します。

      次に、[EnumerationType] をクリックし、一覧から列挙型を選択します。 [EnumerationType] が [Navigator]、[Node]、または [NodeText] の場合、[OuterXPathStringSourceType] をクリックし、ソースの種類を選択し、[OuterXPathString] をクリックします。 設定した OuterXPathStringSourceType の値に応じて、一覧から変数またはファイル接続を選択するか、新しい変数またはファイル接続を作成するか、外部の XML パス言語 (XPath) 式の文字列を入力します。

      [EnumerationType] が [ElementCollection] の場合、前述のように [OuterXPathStringSourceType] と [OuterXPathString] を設定します。 次に [InnerElementType] をクリックし、内部要素の 列挙型を選択し、[InnerXPathStringSourceType] をクリックします。 設定した InnerXPathStringSourceType の値に応じて、変数またはファイル接続を選択するか、新しい変数またはファイル接続を作成するか、内部の XPath 式の文字列を入力します。

    • Foreach SMO 列挙子を使用するには、 [接続] 一覧で既存の ADO.NET 接続を選択するか、 [新しい接続] をクリックします。次に、使用する文字列を入力するか、 [参照] をクリックします。 [参照] をクリックした場合は、 [SMO 列挙の選択] ダイアログ ボックスで、列挙するオブジェクトの種類と列挙型を選択し、 [OK] をクリックします。

  6. 必要に応じて、 [コレクション] ページの [式] テキスト ボックスにある参照ボタン ( [...] ) をクリックし、プロパティ値を更新する式を作成します。 詳細については、「 プロパティ式を追加または変更する」を参照してください。

    注意

    [プロパティ] 一覧に表示されるプロパティは、列挙子ごとに異なります。

  7. 必要に応じて、 [変数のマッピング] をクリックし、オブジェクトのプロパティをコレクションの値にマップします。その後、次の操作を行います。

    1. [変数] 一覧で変数を選択するか、[<新しい変数>] をクリックして新しい変数を作成します。

    2. 新しい変数を追加する場合、 [変数の追加] ダイアログ ボックスで変数のプロパティを設定し、 [OK] をクリックします。

    3. Foreach Item 列挙子を使用する場合、 [インデックス] の一覧で、インデックス値を更新できます。

      注意

      インデックス値は、アイテム内のどの列が変数にマップされるかを示します。 0 以外のインデックス値を使用できるのは、Foreach Item 列挙子だけです。

  8. 必要に応じて [式] をクリックし、 [式] ページで Foreach ループ コンテナーのプロパティ用のプロパティ式を作成します。 詳細については、「 プロパティ式を追加または変更する」を参照してください。

  9. [OK] をクリックします。

[全般] ページ - [Foreach ループ エディター]

[Foreach ループ エディター] ダイアログ ボックスの [全般] ページを使用すると、Foreach ループ コンテナーの名前と説明を指定できます。これは、指定した列挙子を使用してコレクション内の各メンバーのワークフローを繰り返し処理するコンテナーです。

Foreach ループ コンテナーとその構成方法については、「 Foreach ループ コンテナー 」と「 Foreach ループ コンテナーを構成する」を参照してください。

Options

名前
Foreach ループ コンテナーの一意な名前を指定します。 この名前は、タスク アイコンとログでラベルとして使用されます。

注意

オブジェクト名はパッケージ内で一意である必要があります。

説明
Foreach ループ コンテナーの説明を入力します。

[コレクション] ページ - [Foreach ループ エディター]

[Foreach ループ エディター] ダイアログ ボックスの [コレクション] ページを使用すると、列挙子の型を指定して列挙子を構成できます。

Foreach ループ コンテナーとその構成方法については、「 Foreach ループ コンテナー 」と「 Foreach ループ コンテナーを構成する」を参照してください。

静的オプション

列挙子
列挙子の型を一覧から選択します。 このプロパティには、次の表に示すオプションがあります。

値 説明
[Foreach File 列挙子] ファイルを列挙します。 この値を選択すると、セクション [Foreach File 列挙子] に動的オプションが表示されます。
[Foreach Item 列挙子] アイテム内の値を列挙します。 この値を選択すると、セクション [Foreach Item 列挙子] に動的オプションが表示されます。
[Foreach ADO 列挙子] テーブルまたはテーブル内の行を列挙します。 この値を選択すると、セクション [Foreach ADO 列挙子] に動的オプションが表示されます。
[Foreach ADO.NET Schema Rowset 列挙子] スキーマを列挙します。 この値を選択すると、セクション [Foreach ADO.NET Schema Rowset 列挙子] に動的オプションが表示されます。
[Foreach From Variable 列挙子] 変数内の値を列挙します。 この値を選択すると、セクション [Foreach From Variable 列挙子] に動的オプションが表示されます。
[Foreach Nodelist 列挙子] XML ドキュメント内のノードを列挙します。 この値を選択すると、セクション [Foreach NodeList 列挙子] に動的オプションが表示されます。
[ForEach SMO 列挙子] SMO オブジェクトを列挙します。 この値を選択すると、セクション [Foreach SMO 列挙子] に動的オプションが表示されます。
Foreach HDFS File Enumerator (Foreach HDFS ファイル列挙子) 指定された HDFS の場所にある HDFS ファイルを列挙します。 この値を選択すると、セクション [Foreach HDFS File Enumerator] (Foreach HDFS ファイル列挙子) に動的オプションが表示されます。
[Foreach Azure Blob 列挙子] 指定された BLOB の場所に BLOB ファイルを列挙します。 この値を選択すると、セクション [Foreach Azure Blob 列挙子] に動的オプションが表示されます。
[Foreach ADLS File 列挙子] 指定された Data Lake Store ディレクトリのファイルを列挙します。 この値を選択すると、セクション [Foreach ADLS File 列挙子] に動的オプションが表示されます。
[Foreach Data Lake Storage Gen2 File Enumerator](Foreach Data Lake Storage Gen2 File 列挙子) 指定された Data Lake Storage Gen2 ディレクトリのファイルを列挙します。 この値を選択すると、セクション [Foreach Data Lake Storage Gen2 File Enumerator](Foreach Data Lake Storage Gen2 File 列挙子) に動的オプションが表示されます。

式
[式] をクリックして展開すると、既存のプロパティ式のリストが表示されます。 参照ボタン ( [...] ) ボタンをクリックして、列挙子プロパティのプロパティ式を追加するか、既存のプロパティ式を編集して評価します。

関連トピック:Integration Services (SSIS) の式、プロパティ式エディター、式ビルダー

列挙子の動的オプション

[Enumerator] = [Foreach File 列挙子]

Foreach File 列挙子を使用して、フォルダー内のファイルを列挙します。 たとえば、Foreach ループに SQL 実行タスクが含まれている場合、Foreach File 列挙子を使用して、SQL 実行タスクが実行する SQL ステートメントが含まれているファイルを列挙できます。 この列挙子は、サブフォルダーが含められるように構成することができます。

Foreach File 列挙子が列挙するフォルダーとサブフォルダーの内容は、ループの実行中に変化する場合があります。これは、外部プロセスまたはループ内のタスクによって、ループの実行時にファイルの追加、名前変更、または削除が発生するためです。 このような変更の結果、さまざまな不測の事態が発生する可能性があります。

  • ファイルが削除された場合、Foreach ループ内の 1 つのタスクのアクションが、後続のタスクで使用する異なるファイル セットに作用することがあります。

  • ファイルの名前が変更され、それらのファイルを置き換えるためのファイルが外部プロセスによって自動的に追加されると、Foreach ループ内のタスクのアクションが同じファイルに 2 回作用することがあります。

  • ファイルが追加されると、Foreach ループがどのファイルに作用したか判断することが困難になる可能性があります。

フォルダー
列挙するルート フォルダーのパスを示します。

[参照]
ルート フォルダーの場所を参照して指定します。

[ファイル]
列挙するファイルを指定します。

注意

ワイルドカード文字 (*) を使用して、コレクションに含めるファイルを指定します。 たとえば、名前に "abc" が含まれているファイルを追加するには、*abc* というフィルターを使用します。

ファイル名の拡張子を指定すると、列挙子は、文字が追加された同じ拡張子のファイルも返します (これは、旧バージョンとの互換性のために 8.3 ファイル名も比較する、オペレーティング システムの dir コマンドと同じ動作です)。この列挙子の動作は、予期しない結果になる場合があります。 たとえば、Excel 2003 ファイルのみを列挙する場合は「*.xls」と指定しますが、 列挙子は Excel 2007 のファイルも返します。これらのファイルの拡張子が ".xlsx" であるためです。

コレクションに追加するファイルを式で指定するには、 [コレクション] ページの [式] を展開し、 [FileSpec] プロパティを選択して参照ボタン ( […] ) をクリックし、プロパティ式を追加します。

[完全修飾名]
ファイル名の完全修飾パスを取得する場合に選択します。 [ファイル] オプションにワイルドカード文字が指定されている場合、返された完全修飾パスはフィルターに一致します。

[テーブル名のみ]
ファイル名のみを取得する場合に選択します。 [ファイル] オプションにワイルドカード文字が指定されている場合、返されたファイル名はフィルターに一致します。

[ファイル名と拡張子]
ファイル名とファイル名拡張子を取得する場合に選択します。 [ファイル] オプションにワイルドカード文字が指定されている場合、返されたファイル名および拡張子はフィルターに一致します。

[サブフォルダーをスキャンする]
列挙にサブフォルダーを含める場合に選択します。

[Enumerator] = [Foreach Item 列挙子]

Foreach Item 列挙子は、コレクション内のアイテムを列挙するために使用します。 コレクション内のアイテムは、列と列の値を指定して定義します。 行内の各列は個々のアイテムを定義します。 たとえば、プロセス実行タスクで実行される実行可能ファイルとそのタスクで使用される作業ディレクトリを指定するアイテムに 2 つの列を割り当て、1 列は実行可能ファイルの名前、もう 1 列は作業ディレクトリの表示に使用できます。 行数により、ループが繰り返される回数が決まります。 テーブルに 10 行ある場合は、ループが 10 回繰り返されます。

プロセス実行タスクのプロパティを更新するには、列のインデックスを使用してアイテムの列に変数をマップします。 列挙子のアイテムで定義される最初の列のインデックス値は 0、2 番目の列のインデックス値は 1 になり、それ以降も順番にインデックス値が割り当てられます。 変数の値は、ループが繰り返されるたびに更新されます。 プロセス実行タスクの Executable プロパティと WorkingDirectory プロパティは、これらの変数を使用するプロパティ式で更新できます。

[For Each Item コレクションのアイテムの定義]
テーブル内の各列に値を提供します。

注意

値を行列に入力した後で、新しい行がテーブルに自動的に追加されます。

注意

提供された値が列データ型と互換性がない場合、テキストは赤になります。

[列データ型]
アクティブな列のデータ型を一覧表示します。

Remove
アイテムを一覧から削除するには、そのアイテムを選択してから [削除] をクリックします。

[列]
アイテム内の列のデータ型を構成する場合にクリックします。

関連項目:[For Each Item 列] ダイアログ ボックスの UI リファレンス

[Enumerator] = [Foreach ADO 列挙子]

Foreach ADO 列挙子は、変数に格納されている ADO オブジェクトまたは ADO.NET オブジェクト内の行またはテーブルを列挙するために使用します。 たとえば、変数にデータセットを書き込むスクリプト タスクが Foreach ループに含まれている場合、Foreach ADO 列挙子を使用して、データセット内の行を列挙できます。 変数に ADO.NET データセットが格納されている場合は、複数のテーブル内の行を列挙するか、テーブルを列挙するようにこの列挙子を構成できます。

[ADO オブジェクト ソース変数]
ユーザー定義変数を一覧から選択するか、<[新しい変数...]> をクリックして新しい変数を作成します。

注意

変数は、Object データ型にする必要があります。それ以外の場合はエラーが発生します。

関連トピック: Integration Services (SSIS) の変数、変数の追加

[最初のテーブル内の行]
最初のテーブルの行のみを列挙する場合に選択します。

[すべてのテーブルの行 (ADO.NET のデータセットのみ)]
すべてのテーブルの行を列挙する場合に選択します。 このオプションは、列挙するオブジェクトがすべて同じ ADO.NET データセットのメンバーである場合にのみ使用できます。

[すべてのテーブル (ADO.NET のデータセットのみ)]
テーブルのみを列挙する場合に選択します。

[Enumerator] = [Foreach ADO.NET Schema Rowset 列挙子]

Foreach ADO.NET Schema Rowset 列挙子は、指定したデータ ソースのスキーマを列挙するために使用します。 たとえば、Foreach ループに SQL 実行タスクが含まれている場合、Foreach ADO.NET Schema Rowset 列挙子を使用して、 AdventureWorks データベース内の列や、スキーマ権限を取得するための SQL 実行タスクなど、スキーマを列挙できます。

接続
ADO.NET 接続マネージャーを一覧から選択するか、<[新しい接続...]> をクリックして新しい ADO.NET 接続マネージャーを作成します。

重要

ADO.NET 接続マネージャーでは、OLE DB の .NET プロバイダーを使用する必要があります。 SQL Server に接続する場合は、 SQL Server Native Client の使用をお勧めします。このプロバイダーは、 [接続マネージャー] ダイアログ ボックスの [OleDb の .Net プロバイダー] セクションに一覧表示されます。

関連項目:ADO 接続マネージャー、 ADO.NET の接続マネージャーの構成

[スキーマ]
列挙するスキーマを選択します。

[制限の設定]
指定したスキーマに適用する制約を設定します。

関連項目:[スキーマの制限] ダイアログ ボックス

[Enumerator] = [Foreach From Variable 列挙子]

Foreach From Variable 列挙子は、指定した変数に含まれる列挙可能なオブジェクトを列挙するために使用します。 たとえば、クエリを実行し、その結果を変数に格納する SQL 実行タスクが Foreach ループに含まれている場合、Foreach From Variable 列挙子を使用してクエリの結果を列挙できます。

変数
一覧で変数を選択するか、<[新しい変数...]> をクリックして新しい変数を作成します。

関連トピック: Integration Services (SSIS) の変数、変数の追加

[Enumerator] = [Foreach NodeList 列挙子]

Foreach Nodelist 列挙子は、XPath 式を XML ファイルに適用した結果として生成された XML ノードのセットを列挙するために使用します。 たとえば、Foreach ループにスクリプト タスクが含まれている場合、Foreach NodeList 列挙子を使用して、XPath 式の条件を満たす値を XML ファイルからスクリプト タスクに渡すことができます。

XML ファイルに適用される XPath 式は、OuterXPathString プロパティに格納された外部 XPath 操作です。 ElementCollectionに XPath 列挙型が設定されている場合、ForeachNodeList 列挙子は、InnerXPathString プロパティに格納された内部 XPath 式を、要素のコレクションに適用できます。

XML ドキュメントとデータの操作の詳細については、MSDN ライブラリの「.NET Framework における XML の使用」を参照してください。

[DocumentSourceType]
XML ドキュメントのソースの種類を選択します。 このプロパティには、次の表に示すオプションがあります。

値 説明
[直接入力] ソースを XML ドキュメントに設定します。
[ファイル接続] XML ドキュメントが含まれているファイルを選択します。
変数 ソースを XML ドキュメントが含まれている変数に設定します。

[DocumentSource]
[DocumentSourceType] が [直接入力] に設定されている場合は、XML コードを入力するか、 [ドキュメント ソース エディター] ダイアログ ボックスで参照ボタン ([...]) をクリックして XML を指定します。

[DocumentSourceType] が [ファイル接続] に設定されている場合は、ファイル接続マネージャーを選択するか、<[新しい接続...]> をクリックして新しい接続マネージャーを作成します。

関連トピック:ファイル接続マネージャー、 ファイル接続マネージャー エディター

[DocumentSourceType] が [変数] に設定されている場合は、既存の変数を選択するか、<[新しい変数...]> をクリックして新しい変数を作成します。

関連トピック: Integration Services (SSIS) の変数、変数の追加

[EnumerationType]
一覧から列挙型を選択します。 このプロパティには、次の表に示すオプションがあります。

値 説明
[Navigator] XPathNavigator を使用して列挙します。
Node XPath 操作によって返されたノードを列挙します。
[NodeText] XPath 操作によって返されたテキスト ノードを列挙します。
[ElementCollection] XPath 操作によって返された要素ノードを列挙します。

[OuterXPathStringSourceType]
XPath 文字列のソースの種類を選択します。 このプロパティには、次の表に示すオプションがあります。

値 説明
[直接入力] ソースを XML ドキュメントに設定します。
[ファイル接続] XML ドキュメントが含まれているファイルを選択します。
変数 ソースを XML ドキュメントが含まれている変数に設定します。

[OuterXPathString]
[OuterXPathStringSourceType] が [直接入力] に設定されている場合は、XPath 文字列を指定します。

[OuterXPathStringSourceType] が [ファイル接続] に設定されている場合は、ファイル接続マネージャーを選択するか、<[新しい接続...]> をクリックして新しい接続マネージャーを作成します。

関連トピック:ファイル接続マネージャー、 ファイル接続マネージャー エディター

[OuterXPathStringSourceType] が [変数] に設定されている場合は、既存の変数を選択するか、<[新しい変数...]> をクリックして新しい変数を作成します。

関連トピック: Integration Services (SSIS) の変数、変数の追加

[InnerElementType]
[EnumerationType] が [ElementCollection] に設定されている場合は、一覧の内部要素の型を選択します。

[InnerXPathStringSourceType]
内部 XPath 文字列のソースの種類を選択します。 このプロパティには、次の表に示すオプションがあります。

値 説明
[直接入力] ソースを XML ドキュメントに設定します。
[ファイル接続] XML ドキュメントが含まれているファイルを選択します。
変数 ソースを XML ドキュメントが含まれている変数に設定します。

[InnerXPathString]
[InnerXPathStringSourceType] が [直接入力] に設定されている場合は、XPath 文字列を指定します。

[InnerXPathStringSourceType] が [ファイル接続] に設定されている場合は、ファイル接続マネージャーを選択するか、<[新しい接続...]> をクリックして新しい接続マネージャーを作成します。

関連トピック:ファイル接続マネージャー、 ファイル接続マネージャー エディター

[InnerXPathStringSourceType] が [変数] に設定されている場合は、既存の変数を選択するか、<[新しい変数...]> をクリックして新しい変数を作成します。

関連トピック: Integration Services (SSIS) の変数、変数の追加

[Enumerator] = [Foreach SMO 列挙子]

Foreach SMO 列挙子は、SQL Server 管理オブジェクト (SMO) のオブジェクトを列挙するために使用します。 たとえば、Foreach ループに SQL 実行タスクが含まれている場合、Foreach SMO 列挙子を使用して、AdventureWorks データベース内のテーブルを列挙し、各テーブル内の行数をカウントするクエリを実行できます。

接続
既存の ADO.NET 接続マネージャーを選択するか、<[新しい接続...]> をクリックして新しい接続マネージャーを作成します。

関連トピック:ADO.NET 接続マネージャー、ADO.NET の接続マネージャーの構成

[列挙]
列挙する SMO オブジェクトを指定します。

[参照]
SMO 列挙を選択します。

関連項目:[SMO 列挙の選択] ダイアログ ボックス

[Enumerator] = [Foreach HDFS File Enumerator] (Foreach HDFS ファイル列挙子)

[Foreach HDFS File Enumerator] (Foreach HDFS ファイル列挙子) を指定すると、SSIS パッケージは、指定した HDFS の場所にある HDFS ファイルを列挙します。 各 HDFS ファイルの名前を変数に格納し、Foreach ループ コンテナー内のタスクで使用することができます。

Hadoop 接続マネージャー
既存の Hadoop 接続マネージャーを指定するか、HDFS ファイルがホストされている場所を指す新しい Hadoop 接続マネージャーを作成します。 詳細については、「 Hadoop Connection Manager」を参照してください。

[ディレクトリ パス]
列挙する HDFS ファイルが格納されている HDFS ディレクトリの名前を指定します。

[ファイル名フィルター]
特定の名前のパターンを持つファイルを選択する名前フィルターを指定します。 たとえば、MySheet*.xls* には、MySheet001.xls や MySheetABC.xlsx などのファイルが含まれます。

[ファイル名の取得]
SSIS によって取得されたファイル名の種類を指定します。

  • [完全修飾名] は、ディレクトリ パスとファイル名を含む完全な名前を意味します。

  • [名前のみ] は、パスなしでファイル名のみが取得されることを意味します。

[サブフォルダーをスキャンする]
サブフォルダーを再帰的にループ処理するかどうかを指定します。

エディターの [変数のマッピング] ページで、列挙された HDFS ファイルの名前を格納する変数を選択または作成します。

列挙子 = Foreach Azure BLOB 列挙子

[Azure BLOB 列挙子] を指定すると、SSIS パッケージでは、指定した BLOB の場所にある BLOB ファイルが列挙されます。 列挙された BLOB ファイルの名前を変数に格納し、Foreach ループ コンテナー内のタスクで使用できます。

Azure BLOB 列挙子 は、 SQL Server 2016 (13.x)用の SQL Server Integration Services (SSIS) Feature Pack for Azure のコンポーネントです。 Feature Pack は こちらからダウンロードしてください。

[Azure Storage 接続マネージャー]
既存の Azure ストレージ接続マネージャーを選択するか、Azure ストレージ アカウントを参照する接続マネージャーを新規作成します。

関連トピック:Azure Storage 接続マネージャー

BLOB コンテナーの名前
列挙する BLOB ファイルを含む BLOB コンテナーの名前を指定します。

[BLOB ディレクトリ]
列挙する BLOB ファイルを含む BLOB ディレクトリの名前を指定します。 BLOB ディレクトリは仮想階層構造です。

[Search recursively](再帰的に検索する)
サブディレクトリ内で再帰的に検索するかどうかを指定します。

[BLOB 名のフィルター]
特定の名前のパターンを持つファイルを列挙する名前フィルターを指定します。 たとえば、MySheet*.xls\* には、MySheet001.xls や MySheetABC.xlsx などのファイルが含まれます。

[BLOB 時間範囲フィルター]
時間範囲フィルターを指定します。 TimeRangeFrom の後から TimeRangeTo の前までに変更されたファイルが列挙されます。

[列挙子] = [Foreach ADLS File 列挙子]

ADLS File 列挙子は、SSIS パッケージを有効にして Azure Data Lake Store のファイルを列挙します。 列挙されたファイル (プレフィックスとしてスラッシュ / が付く) の完全パスを変数に格納し、Foreach ループ コンテナー内のタスクでファイル パスを使用できます。

[AzureDataLakeConnection]
Azure Data Lake 接続マネージャーを指定するか、ADLS アカウントを参照する新しい接続マネージャーを作成します。

[AzureDataLakeDirectory]
列挙するファイルを含む ADLS ディレクトリの名前を指定します。

[FileNamePattern]
ファイル名フィルターを指定します。 名前が指定されたパターンと一致するファイルのみが列挙されます。 ワイルドカードの * と ? がサポートされています。

[SearchRecursively]
指定されたディレクトリ内で再帰的に検索するかどうかを指定します。

[列挙子] = [Foreach Data Lake Storage Gen2 File Enumerator](Foreach Data Lake Storage Gen2 File 列挙子)

[Foreach Data Lake Storage Gen2 File Enumerator](Foreach Data Lake Storage Gen2 File 列挙子) を指定すると、SSIS パッケージで Azure Data Lake Storage Gen2 のファイルを列挙できます。

[AzureStorageConnection]
既存の Azure Storage 接続マネージャーを指定するか、または Data Lake Storage Gen2 サービスを参照する接続マネージャーを新規作成します。

[FolderPath]
ファイルを列挙するフォルダーのパスを指定します。

[SearchRecursively]
指定されたフォルダー内で再帰的に検索するかどうかを指定します。

サービス プリンシパルのアクセス許可の構成に関する注意事項

Data Lake Storage Gen2 アクセス許可は RBAC と ACL の両方によって決定されます。 こちらに説明されているように、アプリ登録に対応するサービス プリンシパルのオブジェクト ID (OID) を使用して ACL を構成することに注意してください。 これは、RBAC 構成で使用されるアプリケーション (クライアント) ID とは異なります。 組み込みロールまたはカスタム ロールを使用してセキュリティ プリンシパルに RBAC データ アクセス許可が付与されると、これらのアクセス許可は、要求の認可時に最初に評価されます。 要求された操作がセキュリティ プリンシパルの RBAC 割り当てによって認可された場合、認可はすぐに解決され、追加の ACL チェックは実行されません。 また、セキュリティ プリンシパルに RBAC 割り当てがない場合、または要求の操作が割り当てられたアクセス許可と一致しない場合、ACL チェックが実行され、要求された操作を実行する権限がセキュリティ プリンシパルに付与されているかどうかが判断されます。 列挙子が機能するためには、少なくともルート ファイル システムから開始する実行アクセス許可を、ターゲット フォルダーに対する読み取りアクセス許可と共に付与します。 または、少なくともストレージ BLOB データ閲覧者の役割を RBAC を使用して付与します。 詳細については、この記事を参照してください。

[変数のマッピング] ページ - [ForEach ループ エディター]

[Foreach ループ エディター] ダイアログ ボックスの [変数のマッピング] ページを使用すると、コレクションの値に変数をマップできます。 変数の値は、ループの各反復処理でコレクションの値を使用して更新されます。

Integration Services パッケージでの Foreach ループ コンテナーの使用方法について詳しくは、「Foreach ループ コンテナー」を参照してください。 構成方法の詳細については、「 Foreach ループ コンテナーを構成する」を参照してください。

Microsoft SQL Server Integration Services チュートリアルの「簡単な ETL パッケージの作成」には、Foreach ループの追加および構成について説明するレッスンが含まれています。

Options

変数
既存の変数を選択するか、 [新しい変数...] をクリックして新しい変数を作成します。

注意

変数をマップした後、新しい行が [変数] リストに自動的に追加されます。

関連トピック: Integration Services (SSIS) の変数、変数の追加

Index
Foreach Item 列挙子を使用する場合、変数にマップするコレクションの値に列のインデックスを指定します。 他の列挙子の型では、インデックスは読み取り専用です。

注意

インデックスは 0 から始まります。

削除
変数を選択し、 [削除] をクリックします。

[スキーマの制限] ダイアログ ボックス (ADO.NET)

[スキーマの制限] ダイアログ ボックスを使用すると、Foreach ADO.NET Schema Rowset 列挙子に適用するスキーマの制限を設定できます。

Options

制限事項
スキーマに適用する制約を設定します。

変数
制限を定義するために変数を使用します。 変数を一覧から選択するか、 [新しい変数] をクリックして新しい変数を作成します。

関連トピック: Integration Services (SSIS) の変数、変数の追加

[テキスト]
制限を定義するテキストを入力します。

[For Each Item 列] ダイアログ ボックス

[For Each Item 列] ダイアログ ボックスを使用すると、Foreach Item 列挙子が列挙するアイテムの列を定義できます。

Options

列
列を一覧表示します。

[データ型]
データ型を選択します。

追加
新しい列を追加します。

Remove
列を選択してから、 [削除] をクリックします。

[SMO 列挙の選択] ダイアログ ボックス

[SMO 列挙の選択] ダイアログ ボックスを使用すると、 SQL Server の特定のインスタンスの列挙対象となる SQL Server 管理オブジェクト (SMO) オブジェクトを指定し、列挙型を選択できます。

Options

[列挙]
サーバーを展開して SMO オブジェクトを選択します。

オブジェクト
Objects 列挙型を使用します。

[事前作成]
Objects 列挙型を指定して [事前作成] オプションを使用します。

[名前]
Names 列挙型を使用します。

[URN]
URN 列挙型を使用します。

場所
Locations 列挙型を使用します。 このオプションは、ファイルに対してのみ使用できます。

Foreach ループ コンテナーでのプロパティ式を使用する

パッケージは、複数の実行可能ファイルが同時に実行されるように構成できます。 プロパティ式を実装した Foreach ループ コンテナーがパッケージに含まれるときは、この構成を注意して使用する必要があります。

多くの場合、Foreach ループ列挙子が使用する接続マネージャーの ConnectionString プロパティの値を設定するには、プロパティ式を実装すると便利です。 ConnectionString のプロパティ式は、列挙子のコレクションの値にマップした変数によって設定され、ループの反復ごとに更新されます。

ループ内のタスクの並列実行が非決定的なタイミングで行われるという不適切な結果を回避するには、一度に 1 つしか実行可能ファイルが実行されないようにパッケージを構成する必要があります。 たとえば、パッケージが同時に複数のタスクを実行できる場合、フォルダー内のファイルを列挙する Foreach ループ コンテナーでファイル名を取得してから SQL 実行タスクを使用してテーブルにファイル名を挿入すると、SQL 実行タスクの 2 つのインスタンスが同時に書き込もうとして、書き込みの競合が発生する可能性があります。 詳細については、「 パッケージでプロパティ式を使用する」を参照してください。

参照

制御フロー
Integration Services コンテナー