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