パッケージでの変数の使用

[アーティクル]
12/15/2008

更新 : 2006 年 4 月 14 日

変数は、SQL Server 2005 Integration Services (SSIS) パッケージに追加できる便利で柔軟な機能です。変数を使用すると、パッケージのオブジェクト間、および親パッケージと子パッケージとの間で情報を交換できます。また、変数は式やスクリプトでも使用できます。

ユーザー定義変数とシステム変数

Integration Services ではシステム変数が用意されているほか、ユーザー定義変数をサポートします。新しいパッケージを作成した場合、コンテナやタスクをパッケージに追加した場合、またはイベントハンドラを作成した場合、Integration Services によってコンテナに一連のシステム変数が追加されます。システム変数には、パッケージ、コンテナ、タスク、またはイベントハンドラに関する有益な情報が含まれています。たとえば、パッケージの実行時に、MachineName システム変数にはパッケージを実行しているコンピュータの名前が含まれ、StartTime にはパッケージの実行が開始された時刻が含まれます。システム変数は読み取り専用です。詳細については、「システム変数」を参照してください。

ユーザー定義変数を作成して、パッケージで使用できます。ユーザー定義変数は、SSIS の優先順位制約、For ループコンテナ、派生列変換、および条件分割変換で使用される式、スクリプト、およびプロパティの値を更新するプロパティ式など、多くの方法で使用できます。

たとえば、For ループコンテナの評価条件でユーザー定義変数を使用できます。また、Foreach ループコンテナの列挙子コレクション値を変数にマップしたり、SQL 実行タスクがパラメータ化された SQL ステートメントを使用する場合にステートメントのパラメータを変数にマップしたりできます。詳細については、「Integration Services の変数」を参照してください。

変数の使用法のシナリオ

Integration Services パッケージでは、変数をさまざまな方法で使用します。パッケージにユーザー定義変数を追加して、ソリューションに必要な柔軟性と管理性を実装しないと、パッケージ開発があまり進まない場合もあります。シナリオによっては、システム変数もよく使用します。

プロパティの式 パッケージおよびパッケージオブジェクトのプロパティを設定するプロパティ式に値を提供するために、変数を使用します。たとえば、式 SELECT * FROM @varTableName に含まれている変数 varTableName は、SQL 実行タスクによって実行される SQL ステートメントを更新します。式 DATEPART("d", GETDATE()) == 1? @[User::varPackageFirst]:@[User::varPackageOther] では、varPackageFirst 変数で指定されたパッケージを月の最初の日に実行し、varPackageOther 変数で指定されたパッケージを別の日に実行することにより、[パッケージの実行] タスクで実行されるパッケージを更新しています。詳細については、「パッケージでのプロパティ式の使用」を参照してください。

データフロー式 変数を使用して、派生列変換と条件分割変換で列に値を設定するための式や、データ行を各種の変換出力に送るための式に値を提供します。たとえば、式 @varSalutation + LastName は、VarSalutation 変数の値と LastName 列を連結します。式 Income < @HighIncome は、Income 列の値が HighIncome 変数の値よりも小さいデータ行を出力に送信します。詳細については、「派生列変換」、「条件分割変換」、および「パッケージでの式の使用」を参照してください。

優先順位制約の式 優先順位制約で制約付き実行可能ファイルを実行するかどうかを決定するために使用する値を提供します。これらの式は、実行結果 (成功、失敗、完了) と組み合わせて使用することも、実行結果の代わりに使用することもできます。たとえば、式 @varMax > @varMin が true に評価される場合、実行可能ファイルは実行されます。詳細については、「優先順位制約への式の追加」を参照してください。

パラメータおよびリターンコード 入力パラメータに値を提供したり、出力パラメータおよびリターンコードの値を格納します。そのためには、変数をパラメータおよび戻り値にマップします。たとえば、変数 varProductId を 23 に設定して SQL ステートメント SELECT * from Production.Product WHERE ProductID = ? を実行すると、ProductID が 23 である製品が取得されます。詳細については、「SQL 実行タスク」を参照してください。

For ループ式 For ループの初期化式、評価式、および代入式で使用する値を提供します。たとえば、変数 varCount が 2、変数 varMaxCount が 10、初期化式が @varCount、評価式が @varCount < @varMaxCount、代入式が @varCount =@varCount +1 の場合、ループは 8 回繰り返されます。詳細については、「For ループコンテナ」を参照してください。

親パッケージ変数の構成 親パッケージから子パッケージに値を渡します。子パッケージは、親パッケージ変数の構成を使用することにより、親パッケージの変数にアクセスできます。たとえば、子パッケージが親パッケージと同じ日付を使用する必要がある場合、子パッケージは親パッケージの GETDATE 関数によって設定される変数を指定する親パッケージ変数の構成を定義できます。詳細については、「パッケージ実行タスク」および「パッケージ構成」を参照してください。

スクリプトタスクおよびスクリプトコンポーネント 読み取り専用変数および読み取り/書き込み変数の一覧をスクリプトタスクまたはスクリプトコンポーネントに提供し、スクリプト内の読み取り/書き込み変数を更新して、更新された値をスクリプトの内外で使用します。たとえば、コード numberOfCars = CType(Dts.Variables("NumberOfCars").Value, Integer) では、スクリプト変数 numberOfCars が変数 NumberOfCars の値によって更新されます。詳細については、「スクリプトタスクでの変数の使用」を参照してください。

構成と変数

変数を動的に更新するために、変数の構成を作成し、パッケージと共に構成を配置して、パッケージの配置時に構成ファイルの変数の値を更新できます。実行時に、パッケージは更新された変数の値を使用します。詳細については、「パッケージの構成の作成」を参照してください。

ユーザー定義変数を追加、修正、および削除するには

参照

その他の技術情報

SSIS デザイナでのパッケージの作成

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴

リリース	履歴
2006 年 4 月 14 日	新しい内容 : 変数の使用法のシナリオを追加しました。

次の方法で共有