[アーティクル]
06/15/2011

レコードセット変換先を使用する方法

レコードセット変換先では、データは外部データソースに保存されません。代わりに、レコードセット変換先では、Object データ型の Integration Services パッケージ変数に格納されるレコードセットのメモリにデータが保存されます。レコードセット変換先でデータが保存されたら、通常、Foreach ループコンテナーと Foreach ADO 列挙子を使用して、一度に 1 つのレコードセット行を処理します。Foreach ADO 列挙子によって、現在の行の各列の値が個別のパッケージ変数に保存されます。その後、Foreach ループコンテナー内で構成したタスクによって変数から値が読み取られ、その値を使用してアクションが実行されます。

レコードセット変換先は、さまざまなシナリオで使用できます。次にいくつかの例を示します。

メール送信タスクと Integration Services 式言語を使用して、レコードセットの行ごとにカスタマイズされた電子メールメッセージを送信できます。
データフロータスク内で変換元として構成されたスクリプトコンポーネントを使用して、列値をデータフローの列に読み取ることができます。その後、変換や変換先を使用して、行を変換および保存できます。この例では、データフロータスクが行ごとに 1 回実行されます。

ここでは、まずレコードセット変換先を使用する一般的な手順について説明し、次に変換先の使用方法の具体的な例を示します。

レコードセット変換先を使用する一般的な手順

次の手順は、レコードセット変換先にデータを保存し、Foreach ループコンテナーを使用して各行を処理するために必要な手順をまとめたものです。

レコードセット変換先にデータを保存し、Foreach ループコンテナーを使用して各行を処理するには

Business Intelligence Development Studio で、Integration Services パッケージを作成または開きます。
レコードセット変換先でメモリに保存されたレコードセットを格納する変数を作成し、変数の型を Object に設定します。
使用するレコードセットの各列の値を格納するために、適切な型の追加の変数を作成します。
データフローで使用するデータソースに必要な接続マネージャーを追加して構成します。
データフロータスクをパッケージに追加し、SSIS デザイナーの [データフロー] タブで、データの読み込みおよび変換を行うための変換元および変換を構成します。
レコードセット変換先をデータフローに追加し、変換に接続します。レコードセット変換先の VariableName プロパティに、レコードセットを格納するために作成した変数の名前を入力します。
SSIS デザイナーの [制御フロー] タブで、Foreach ループコンテナーを追加し、このコンテナーをデータフロータスクの後に連結します。[Foreach ループエディター] を開いて、次の設定を使用してコンテナーを構成します。
1. [コレクション] ページで、[Foreach ADO 列挙子] をクリックします。次に、[ADO オブジェクトソース変数] で、レコードセットが含まれる変数を選択します。
2. [変数のマッピング] ページで、使用する各列の 0 から始まるインデックスを適切な変数にマップします。
  
  ループの各反復処理で、列挙子によってこれらの変数に現在の行の列値が設定されます。
Foreach ループコンテナー内にタスクを追加し、変数から値を読み取って一度に 1 つのレコードセット行を処理するように構成します。

レコードセット変換先の使用例

次の例では、データフロータスクが AdventureWorks2008R2 の従業員に関する情報を Sales.SalesPerson テーブルからレコードセット変換先に読み込みます。次に、Foreach ループコンテナーが一度に 1 つのデータ行を読み取って、メール送信タスクを呼び出します。メール送信タスクは、式を使用して、ボーナス額に関するカスタマイズされた電子メールメッセージを各販売員に送信します。

プロジェクトを作成して変数を構成するには

BI Development Studio で、新しい Integration Services プロジェクトを作成します。
[SSIS] メニューの [変数] をクリックします。
[変数] ウィンドウで、レコードセットと現在の行の列値を格納する変数を作成します。
1. BonusRecordset という名前の変数を作成し、その型を Object に設定します。
  
  BonusRecordset 変数にはレコードセットが格納されます。
2. EmailAddress という名前の変数を作成し、その型を String に設定します。
  
  EmailAddress 変数には販売員の電子メールアドレスが格納されます。
3. FirstName という名前の変数を作成し、その型を String に設定します。
  
  FirstName 変数には販売員の名が格納されます。
4. Bonus という名前の変数を作成し、その型を Double に設定します。
  
  Bonus 変数には販売員のボーナス額が格納されます。

接続マネージャーを構成するには

SSIS デザイナーの [接続マネージャー] 領域で、AdventureWorks2008R2 サンプルデータベースに接続する新しい OLE DB 接続マネージャーを追加して構成します。

この接続マネージャーは、データフロータスクの OLE DB ソースがデータを取得するために使用されます。
[接続マネージャー] 領域で、使用可能な SMTP サーバーに接続する新しい SMTP 接続マネージャーを追加して構成します。

この接続マネージャーは、Foreach ループコンテナー内のメール送信タスクが電子メールを送信するために使用されます。

データフローとレコードセット変換先を構成するには

SSIS デザイナーの [制御フロー] タブで、データフロータスクをデザイン画面に追加します。
[データフロー] タブで、OLE DB ソースをデータフロータスクに追加し、[OLE DB ソースエディター] を開きます。
エディターの [接続マネージャー] ページで、次の設定を使用してソースを構成します。
1. [OLE DB 接続マネージャー] で、前もって作成した OLE DB 接続マネージャーを選択します。
2. [データアクセスモード] で、[SQL コマンド] を選択します。
3. [SQL コマンドテキスト] で、次のクエリを入力します。
```
SELECT     Sales.vSalesPerson.EmailAddress, Sales.vSalesPerson.FirstName, CONVERT(float, Sales.SalesPerson.Bonus) AS Bonus
FROM         Sales.SalesPerson INNER JOIN
                      Sales.vSalesPerson ON Sales.SalesPerson.BusinessEntityID = Sales.vSalesPerson.BusinessEntityID;
```
  注
  
  Bonus 列の currency 値を Double 型のパッケージ変数に読み込む前に、その値を float に変換する必要があります。
[データフロー] タブで、レコードセット変換先を追加し、この変換先を OLE DB ソースの後に連結します。
[レコードセット変換先エディター] を開いて、次の設定を使用して変換先を構成します。
1. [コンポーネントのプロパティ] タブの VariableName プロパティで、User::BonusRecordset を選択します。
2. [入力列] タブで、使用可能な 3 つすべての列を選択します。

注
Bonus 列の currency 値を Double 型のパッケージ変数に読み込む前に、その値を float に変換する必要があります。

Foreach ループコンテナーを構成してパッケージを実行するには

SSIS デザイナーの [制御フロー] タブで、Foreach ループコンテナーを追加し、このコンテナーをデータフロータスクの後に連結します。
[Foreach ループエディター] を開いて、次の設定を使用してコンテナーを構成します。
1. [コレクション] ページの [列挙子] で [Foreach ADO 列挙子] を選択し、[ADO オブジェクトソース変数] で User::BonusRecordset を選択します。
2. [変数のマッピング] ページで、User::EmailAddress をインデックス 0 に、User::FirstName をインデックス 1 に、User::Bonus をインデックス 2 にそれぞれマップします。
[制御フロー] タブで、Foreach ループコンテナー内にメール送信タスクを追加します。
[メール送信タスクエディター] を開いて、[メール] ページで次の設定を使用してタスクを構成します。
1. [SmtpConnection] で、前もって構成した SMTP 接続マネージャーを選択します。
2. [差出人] に、適切な電子メールアドレスを入力します。
  
  自分の電子メールアドレスを使用すると、パッケージが正常に実行されているかどうかを確認できます。メール送信タスクによって AdventureWorks2008R2 に存在しない販売員にメッセージが送信されると、配信できなかったことが通知されます。
3. [宛先] に、既定の電子メールアドレスを入力します。
  
  この値は使用されませんが、実行時に各販売員の電子メールアドレスに置き換えられます。
4. [件名] に、「Your annual bonus」と入力します。
5. [MessageSourceType] に対して [直接入力] を選択します。
[メール送信タスクエディター] の [式] ページで、参照ボタン ([...]) をクリックして [プロパティ式エディター] を開きます。
[プロパティ式エディター] で、次の情報を入力します。
1. [ToLine] に、次の式を追加します。
```
@[User::EmailAddress]
```
2. MessageSource プロパティに、次の式を追加します。
```
"Dear " +  @[User::FirstName] + ": The amount of your bonus for this year is $" +  (DT_WSTR, 12) @[User::Bonus] + ". Thank you!"
```
パッケージを実行します。

有効な SMTP サーバーと自分の電子メールアドレスを指定すると、メール送信タスクによって AdventureWorks2008R2 に存在しない販売員にメッセージが送信され、配信できなかったことが通知されます。

次の方法で共有

レコードセット変換先を使用する方法

レコードセット変換先を使用する一般的な手順

レコードセット変換先にデータを保存し、Foreach ループコンテナーを使用して各行を処理するには

レコードセット変換先の使用例

プロジェクトを作成して変数を構成するには

接続マネージャーを構成するには

データフローとレコードセット変換先を構成するには

Foreach ループコンテナーを構成してパッケージを実行するには

その他のリソース

次の方法で共有

レコードセット変換先を使用する方法

レコードセット変換先を使用する一般的な手順

レコードセット変換先にデータを保存し、Foreach ループ コンテナーを使用して各行を処理するには

レコードセット変換先の使用例

プロジェクトを作成して変数を構成するには

接続マネージャーを構成するには

データ フローとレコードセット変換先を構成するには

Foreach ループ コンテナーを構成してパッケージを実行するには

その他のリソース

レコードセット変換先にデータを保存し、Foreach ループコンテナーを使用して各行を処理するには

データフローとレコードセット変換先を構成するには

Foreach ループコンテナーを構成してパッケージを実行するには