Integration Services の変数

変数には、SQL Server Integration Services パッケージと、パッケージに含まれるコンテナー、タスク、およびイベント ハンドラーで、実行時に使用できる値が格納されます。スクリプト タスクおよびスクリプト コンポーネント内のスクリプトも、変数を使用できます。タスクとコンテナーにワークフロー内での順位を付ける優先順位制約では、制約の定義に式を含める場合に変数を使用できます。

変数は、次の目的で Integration Services パッケージ内で使用できます。

• 実行時に、パッケージ要素のプロパティを更新します。たとえば、1 つの Foreach ループ コンテナーで許可できる実行可能ファイルの数を動的に設定できます。

• メモリ内に参照テーブルを組み込みます。たとえば、パッケージは、データ値を持つ変数を読み込む SQL 実行タスクを実行できます。

• データ値を持つ変数を読み込み、それらを使用して WHERE 句の検索条件を指定します。たとえば、SQL 実行タスク内の Transact-SQL ステートメントによって使用される変数の値をスクリプト タスク内のスクリプトで更新できます。

• 整数値を持つ変数を読み込み、その値を使用してパッケージ制御フロー内のループを制御します。たとえば、For ループ コンテナーの評価式内の変数を使用して繰り返しを制御できます。

• 実行時に Transact-SQL ステートメントのパラメーター値を作成します。たとえば、パッケージは SQL 実行タスクを実行し、変数を使用して Transact-SQL ステートメント内のパラメーターを動的に設定できます。

• 変数値が含まれる式を構築します。たとえば、派生列の変換は、変数値に列の値を乗算することによって取得した結果を使用して、列の値を設定できます。

Integration Services では、ユーザー定義変数とシステム変数の、2 種類の変数がサポートされています。ユーザー定義変数とはパッケージの開発者によって定義された変数で、システム変数とは Integration Services によって定義された変数です。ユーザー定義変数は、パッケージで必要な数だけ作成できますが、システム変数は追加作成できません。

変数 (システム変数とユーザー定義変数) はすべて、SQL 実行タスクが使用するパラメーター バインドで使用して、SQL ステートメントのパラメーターに変数をマップできます。詳細については、「SSIS SQL 実行タスク」および「SQL 実行タスクにおけるパラメーターとリターン コードの使用」を参照してください。

注
ユーザー定義変数とシステム変数の名前では、大文字と小文字が区別されます。

パッケージ、Foreach ループ コンテナー、For ループ コンテナー、シーケンス コンテナー、タスク、およびイベント ハンドラーの、すべての種類の Integration Services コンテナーに対してユーザー定義変数を作成できます。ユーザー定義変数は、コンテナーの変数のコレクションのメンバーです。

SSIS デザイナーを使用してパッケージを作成すると、変数のコレクションのメンバーは、SSIS デザイナーの [パッケージ エクスプローラー] タブ上の [変数] フォルダー内に表示されます。このフォルダーには、ユーザー定義変数とシステム変数が一覧表示されます。

ユーザー定義変数は、次の方法で構成できます。

• 変数の名前と説明を指定します。

• 変数の名前空間を指定します。

• 変数値が変更されたときに、変数がイベントを起動するかどうかを示します。

• 変数は読み取り専用か、読み取り/書き込み可能かを示します。

• 式の評価結果を使用して、変数値を設定します。

• パッケージ、またはタスクなどのパッケージ オブジェクトのスコープ内に、変数を作成します。

• 変数の値とデータ型を指定します。

システム変数で構成可能なオプションは、変数値が変更されたときにイベントを起動するかどうかを指定するオプションのみです。

コンテナーの種類ごとに、異なるセットのシステム変数を使用できます。パッケージとパッケージ要素が使用するシステム変数の詳細については、「システム変数」を参照してください。

変数の実際的な使用シナリオの詳細については、「パッケージでの変数の使用」を参照してください。