パッケージ構成を作成する

  • [アーティクル]

パッケージの構成は、[パッケージ構成オーガナイザー] ダイアログ ボックスまたはパッケージ構成ウィザードを使用して作成します。 これらのツールにアクセスするには、SQL Server データ ツール (SSDT) で [SSIS] メニューの [パッケージ構成] をクリックします。

注意注

パッケージ構成オーガナイザーにアクセスするには、[構成] プロパティの横にある参照ボタンをクリックする方法もあります。 構成プロパティは、パッケージのプロパティ ウィンドウに表示されます。
注意注

パッケージ配置モデルの構成を使用できます。 パラメーターは、プロジェクト配置モデルの構成の代わりに使用します。 プロジェクト配置モデルを使用すると、Integration Services サーバーに Integration Services プロジェクトを配置できます。 配置モデルの詳細については、「プロジェクトとパッケージの展開」を参照してください。

[パッケージ構成オーガナイザー] ダイアログ ボックスでは、パッケージに対する構成の有効化、構成の追加および削除、構成の優先読み込み順序の設定を行えます。

注意注

パッケージ構成を優先順序で読み込むと、[パッケージ構成オーガナイザー] ダイアログ ボックスに表示された一覧の上から下へと構成が読み込まれます。 ただし、実行時にパッケージ構成が優先順序で読み込まれるとは限りません。 具体的には、親のパッケージ構成は他の種類の構成の後に読み込まれます。
注意注

複数の構成で同じオブジェクト プロパティが設定された場合、最後に読み込まれた値が実行時に使用されます。

[パッケージ構成オーガナイザー] ダイアログ ボックスから、手順に従って構成を作成できるパッケージ構成ウィザードを実行できます。 パッケージ構成ウィザードを実行するには、[パッケージ構成オーガナイザー] ダイアログ ボックスで新しい構成を追加するか、既存の構成を編集します。 ウィザードの各ページで、構成の種類を選択し、構成に直接アクセスするか環境変数を使用するかを選択し、構成に保存するプロパティを選択します。

次の例は、パッケージ構成ウィザードの [ウィザードの完了] ページに表示される、変数およびパッケージの対象になるプロパティを示しています。

\Package.Variables[User::TodaysDate].Properties[RaiseChangedEvent]

\Package.Properties[MaximumErrorCount]

\Package.Properties[LoggingMode]

\Package.Properties[LocaleID]

\Package\My SQL Task.Variables[User::varTableName].Properties[Value]

この例では、構成によって次のプロパティが更新されます。

  • ユーザー定義変数の RaiseChangedEvent プロパティ、TodaysDate

  • パッケージの MaximumErrorCount、LoggingMode、および LocaleID プロパティ

  • ユーザー定義変数の Value プロパティ、タスク My SQL Task のスコープ内の varTableName

"\Package" はルートを表し、ピリオド (.) は構成で更新されるプロパティへのパスを定義するオブジェクトを区切ります。 変数とプロパティの名前は角かっこで囲みます。 パッケージ名に関係なく、構成では常に Package という用語を使用します。ただし、その他のオブジェクトのパスにはすべてユーザーが定義した名前を使用します。

ウィザードの終了後、新しい構成が [パッケージ構成オーガナイザー] ダイアログ ボックスの構成の一覧に追加されます。

注意注

パッケージ構成ウィザードの最後に表示される [ウィザードの完了] ページには、構成内の対象プロパティが一覧表示されます。 dtexec コマンド プロンプト ユーティリティを使用してパッケージの実行時にプロパティを更新するには、パッケージ構成ウィザードを実行してプロパティのパスを表す文字列を生成し、それらの文字列をコピーしてコマンド プロンプト ウィンドウに貼り付け、dtexec の set オプションと一緒に使用します。

次の表に、[パッケージ構成オーガナイザー] ダイアログ ボックスの構成の一覧の列を示します。

列

説明

[構成名]

構成の名前です。

[構成の種類]

構成の種類です。

[構成文字列]

構成の場所です。 場所は、パス、環境変数、レジストリ キー、親パッケージの変数名、または SQL Server データベースのテーブルの場合があります。

[対象になるオブジェクト]

構成を持つプロパティを設定するオブジェクトの名前です。 構成が XML 構成ファイルの場合、構成で複数のオブジェクトを更新できるため、この列は空白になります。

[対象になるプロパティ]

プロパティの名前です。 構成が XML 構成ファイルまたは SQL Server テーブルに書き込まれる場合は、構成で複数のオブジェクトを更新できるため、この列は空白になります。

パッケージの構成を作成するには

  1. SQL Server データ ツール (SSDT) で、使用するパッケージが含まれている Integration Services プロジェクトを開きます。

  2. ソリューション エクスプローラーで、パッケージをダブルクリックして開きます。

  3. SSIS デザイナーの [制御フロー] タブ、[データ フロー] タブ、[イベント ハンドラー] タブ、または [パッケージ エクスプローラー] タブをクリックします。

  4. [SSIS] メニューの [パッケージの構成] をクリックします。

  5. [パッケージ構成オーガナイザー] ダイアログ ボックスで、[パッケージの構成を有効にする] を選択し、[追加] をクリックします。

  6. パッケージ構成ウィザードの最初のページが表示されたら、[次へ] をクリックします。

  7. [構成の種類の選択] ページで構成の種類を指定してから、選択した構成の種類に対応するプロパティを設定します。 詳細については、「パッケージ構成ウィザードの UI リファレンス」を参照してください。

  8. [エクスポートするプロパティの選択] ページで、構成に含めるパッケージ オブジェクトのプロパティを選択します。 この構成の種類でサポートされているプロパティが 1 つのみである場合、ウィザード ページのタイトルは [対象になるプロパティの選択] になります。 詳細については、「パッケージ構成ウィザードの UI リファレンス」を参照してください。

    注意注

    構成の種類が [XML 構成ファイル] および [SQL Server] の場合のみ、構成に複数のプロパティを含めることができます。

  9. [ウィザードの完了] というページが表示されたら、構成の名前を入力して [完了] をクリックします。

  10. [パッケージ構成オーガナイザー] ダイアログ ボックスで構成を確認します。

  11. [閉じる] をクリックします。

外部リソース

Integration Services のアイコン (小) 最新の Integration Services の入手

マイクロソフトが提供する最新のダウンロード、アーティクル、サンプル、ビデオ、およびコミュニティで選択されたソリューションについては、MSDN の Integration Services のページを参照してください。


これらの更新が自動で通知されるようにするには、ページの RSS フィードを定期受信します。

関連項目

概念

パッケージ構成

パッケージの配置 (SSIS)

プログラムでの変数の使用