子パッケージでの変数およびパラメーターの値の使用
この手順では、構成の種類として親変数を使用するパッケージ構成を作成する方法について説明します。 この構成の種類を使用すると、親パッケージから実行される子パッケージが親内の変数にアクセスできるようになります。
Note
親パッケージの変数またはパラメーター、またはプロジェクトのパラメーターを子パッケージのパラメーターにマップするようにパッケージ実行タスクを構成することで、値を子パッケージに渡すこともできます。 詳細については、「 パッケージ実行タスク」を参照してください。
親パッケージ内のこの変数は、子パッケージのパッケージ構成を作成する前に作成する必要はありません。 変数はいつでも親パッケージに追加できますが、パッケージ構成では親変数の正確な名前を使用する必要があります。 ただし、親変数パッケージ構成を作成するには、子パッケージ内に、この構成で更新できる変数が既に存在している必要があります。 変数の追加と構成の詳細については、「 パッケージ内のユーザー定義変数のスコープの追加、削除、変更」を参照してください。
親変数パッケージ構成で使用される親パッケージ内の変数のスコープは、パッケージ実行タスク、タスクを含むコンテナー、またはパッケージに設定できます。 パッケージ内で同じ名前の複数の変数が定義されている場合、パッケージ実行タスクのスコープ内で最も近い変数が使用されます。 パッケージ実行タスクに最も近いスコープは、タスク自体です。
親パッケージに変数を追加するには
SQL Server Data Tools (SSDT) で、子パッケージに渡す変数を追加するパッケージが含まれている Integration Services プロジェクトを開きます。
ソリューション エクスプローラーで、パッケージをダブルクリックして開きます。
SSIS デザイナーで、変数のスコープを定義するには、次のいずれかの操作を行います。
スコープをパッケージに設定するには、 [制御フロー] タブのデザイン画面上の任意の場所をクリックします。
スコープをパッケージ実行タスクの親コンテナーに設定するには、コンテナーをクリックします。
スコープをパッケージ実行タスクに設定するには、タスクをクリックします。
変数を追加および構成します。
Note
変数で格納するデータと互換性のあるデータ型を選択します。
更新したパッケージを保存するには、 [ファイル] メニューの [選択されたファイルを上書き保存] をクリックします。
子パッケージに変数を追加するには
SQL Server Data Tools (SSDT) で、親変数構成を追加するパッケージが含まれている Integration Services プロジェクトを開きます。
ソリューション エクスプローラーで、パッケージをダブルクリックして開きます。
SSIS デザイナーで、スコープをパッケージに設定するには、[制御フロー] タブのデザイン画面上の任意の場所をクリックします。
変数を追加および構成します。
Note
変数で格納するデータと互換性のあるデータ型を選択します。
更新したパッケージを保存するには、 [ファイル] メニューの [選択されたファイルを上書き保存] をクリックします。
親パッケージ構成を子パッケージに追加するには
まだ開いていない場合は、SQL Server Data Tools (SSDT) で子パッケージを開きます。
[制御フロー] タブのデザイン画面で任意の場所をクリックします。
[SSIS] メニューの [パッケージ構成] をクリックします。
[パッケージ構成オーガナイザー] ダイアログ ボックスで、 [パッケージの構成を有効にする]を選択し、 [追加]をクリックします。
パッケージ構成ウィザードのウェルカム ページで、[次へ] をクリックします。
[構成の種類の選択] ページの [構成の種類] ボックスの一覧で、 [親パッケージ変数] を選択して、次のいずれかの操作を行います。
[構成設定を直接指定する]を選択し、 [親変数] ボックスで、その構成で使用する親パッケージ内の変数名を指定します。
重要
変数名では大文字と小文字が区別されます。
[構成の場所を環境変数に格納する] を選択し、 [環境変数]ボックスの一覧で、変数の名前を含む環境変数を選択します。
[次へ] をクリックします。
[対象になるプロパティの選択] ページで、 [変数] ノードを展開し、構成する変数の [プロパティ] ノードを展開した後、構成によって設定されるプロパティをクリックします。
[次へ] をクリックします。
[ウィザードの完了] ページで、必要に応じて、構成の既定の名前を変更し、構成情報を確認します。
[完了] をクリックしてウィザードを完了し、 [パッケージ構成オーガナイザー] ダイアログ ボックスに戻ります。
[パッケージ構成オーガナイザー] ダイアログ ボックスの [構成] タブに、新しい構成が表示されます。
[閉じる] をクリックします。
参照
[パッケージ構成]
パッケージ構成を作成する
Integration Services (SSIS) の変数
パッケージで変数を使用する