レガシー パッケージの配置 (SSIS)

  • [アーティクル]

適用対象: SQL Server Azure Data Factory の SSIS 統合ランタイム

SQL Server Integration Services には、開発コンピューターから実稼働サーバーまたは他のコンピューターへのパッケージの配置を簡素化するツールとウィザードが含まれています。

パッケージ配置プロセスは、次の 4 段階で行います。

  1. 最初の手順は省略可能で、実行時にパッケージのプロパティ要素を更新するパッケージ構成を作成します。 この構成は、パッケージを配置する際に自動的に適用されます。

  2. 2 番目の手順は、Integration Services プロジェクトをビルドして、パッケージ配置ユーティリティを作成することです。 プロジェクトの配置ユーティリティには、配置するパッケージが含まれます。

  3. 3 番目の手順は、Integration Services プロジェクトのビルド時に作成された配置フォルダーをターゲット コンピューターにコピーすることです。

  4. 4 番目の手順は、ターゲット コンピューターでパッケージ インストール ウィザードを実行し、ファイル システムまたは SQL Server のインスタンスにパッケージをインストールすることです。

[パッケージ構成]

SQL Server Integration Services には、プロパティの値を実行時に更新するためのパッケージ構成が用意されています。

注意

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

1 つの構成は、完了した状態のパッケージに追加するプロパティと値のペアで定義されます。 通常、パッケージの開発中にパッケージ オブジェクトにプロパティを設定したパッケージを作成し、そのパッケージに構成を追加します。 パッケージの実行時に、構成からこのプロパティの新しい値を取得します。 たとえば、構成を使用して、接続マネージャーの接続文字列を変更したり、変数の値を更新したりできます。

パッケージの構成には、次のような利点があります。

  • 構成を使用すると、開発環境から運用環境へのパッケージの移行が容易になります。 たとえば、ある構成を使用して、ソース ファイルのパスを更新したり、データベースやサーバーの名前を変更したりできます。

  • 構成は、パッケージを多くの異なるサーバーに配置する場合に便利です。 たとえば、配置されたパッケージごとの構成の変数に、異なるディスク領域値を格納できます。また、使用できるディスク領域がこの値に満たない場合、パッケージは実行されません。

  • 構成を使用すると、パッケージの柔軟性が高まります。 たとえば、構成を使用すると、プロパティ式に使用されている変数の値を更新できます。

Integration Services では、XML ファイル、SQL Server データベース内のテーブル、および環境変数およびパッケージ変数など、パッケージ構成を格納するための複数の異なる方法がサポートされています。

それぞれの構成は、プロパティと値のペアで定義されます。 XML 構成ファイルと SQL Server 構成の種類には、複数の構成を含めることができます。

構成は、パッケージをインストールするためのパッケージ配置ユーティリティを作成したときに追加されます。 パッケージをインストールするときに、パッケージのインストールの 1 つの手順として構成を更新できます。

実行時にパッケージ構成が適用されるしくみについて

dtexec コマンド プロンプト ユーティリティ (dtexec.exe) を使用して配置されたパッケージを実行する場合、パッケージ構成が 2 回適用されます。 コマンド ラインで指定したオプションの適用前と適用後の両方に構成が適用されます。

パッケージを読み込んで実行すると、次の順序でイベントが発生します。

  1. dtexec ユーティリティでパッケージが読み込まれます。

  2. デザイン時にパッケージに指定された構成が、パッケージに指定されている順序で適用されます (唯一の例外は、親パッケージ変数の構成です。これらの構成は後から一度だけ適用されます)。

  3. 次に、コマンド ラインで指定したすべてのオプションが適用されます。

  4. デザイン時にパッケージに指定された構成が、パッケージに指定されている順序で再読み込みされます (この場合も唯一の例外は、親パッケージ変数の構成です)。 指定されたすべてのコマンド ライン オプションを使用して構成が再読み込みされます。 したがって、異なる値が異なる場所から再読み込みされる可能性があります。

  5. 親パッケージ変数の構成が適用されます。

  6. パッケージが実行されます。

dtexec ユーティリティでの構成の適用方法は、次のコマンド ライン オプションに影響します。

  • 実行時に /Connection または /Set オプションを使用すると、デザイン時に指定した場所とは別の場所からパッケージ構成を読み込むことができます。

  • /ConfigFile オプションを使用すると、デザイン時に指定しなかった追加の構成を読み込むことができます。

ただし、これらのコマンド ライン オプションには制限事項がいくつかあります。

  • /Set または /Connection オプションを使用して、構成で設定されている単一の値をオーバーライドすることはできません。

  • /ConfigFile オプションを使用して、デザイン時に指定した構成を置き換える構成を読み込むことはできません。

これらのオプションの詳細と、SQL Server 2019 Integration Services (SSIS) と以前のバージョン間におけるこれらのオプションの動作の違いについては、「SQL Server 2016 における Integration Services 機能の動作の変更」を参照してください。

パッケージの構成の種類

パッケージの構成の種類を次の表に示します。

Type 説明
XML 構成ファイル XML ファイルに構成を格納します。 XML ファイルは、複数の構成を格納できます。
環境変数 環境変数に構成を格納します。
レジストリ エントリ レジストリ エントリに構成を格納します。
親パッケージ変数 パッケージの変数に構成を格納します。 通常、この構成の種類は、子パッケージ内のプロパティを更新するために使用されます。
SQL Server テーブル SQL Server データベース内のテーブルに構成を格納します。 テーブルは、複数の構成を格納できます。

XML 構成ファイル

構成の種類として [XML 構成ファイル] を選択した場合は、新しい構成ファイルを作成したり、既存のファイルを再利用して新しい構成を追加できます。また、既存のファイルを再利用しながら既存のファイルの内容を上書きすることもできます。

XML 構成ファイルには、2 つのセクションがあります。

  • この構成ファイルに関する情報が記載された見出し。 この要素には、ファイルの作成日やファイルの作成者の名前などの属性があります。

  • それぞれの構成に関する情報が格納された構成要素。 この要素には、プロパティ パスやプロパティの構成値などの属性があります。

次の XML コードは、XML 構成ファイルの構文を示しています。 この例では、 MyVarという名前の整数変数の Value プロパティの構成を示します。

\<?xml version="1.0"?>  
<DTSConfiguration>  
   <DTSConfigurationHeading>  
      <DTSConfigurationFileInfo  
          GeneratedBy="DomainName\UserName"  
          GeneratedFromPackageName="Package"  
          GeneratedFromPackageID="{2AF06766-817A-4E28-9878-0DE37A150648}"  
          GeneratedDate="2/01/2005 5:58:09 PM"/>  
   </DTSConfigurationHeading>  
   <Configuration ConfiguredType="Property" Path="\Package.Variables[User::MyVar].Value" ValueType="Int32">  
      <ConfiguredValue>0</ConfiguredValue>  
   </Configuration>  
</DTSConfiguration>

レジストリ エントリ

レジストリ エントリを使用して構成を格納する場合は、既存のキーを使用するか、HKEY_CURRENT_USER で新しいキーを作成できます。 使用するレジストリ キーには、 Valueという名前の値が必要です。 この値には、DWORD または文字列を指定できます。

構成の種類として [レジストリ エントリ] を選択した場合は、[レジストリ エントリ] ボックスにレジストリ キーの名前を入力します。 形式は <registry key> です。 HKEY_CURRENT_USER のルートにないレジストリ キーを使用する場合は、<Registry key\registry key\...> の形式を使用してキーを識別します。 たとえば、SSISPackages にある MyPackage キーを使用する場合は、「 SSISPackages\MyPackage」と入力します。

SQL Server

構成の種類として [SQL Server] を選択した場合は、構成を格納する SQL Server データベースへの接続を指定します。 構成は、既存のテーブルに保存することも、指定したデータベース内に新しいテーブルを作成して保存することもできます。

次の SQL ステートメントは、パッケージ構成ウィザードで提供される既定の CREATE TABLE ステートメントを示しています。

CREATE TABLE [dbo].[SSIS Configurations]  
(  
ConfigurationFilter NVARCHAR(255) NOT NULL,  
ConfiguredValue NVARCHAR(255) NULL,  
PackagePath NVARCHAR(255) NOT NULL,  
ConfiguredValueType NVARCHAR(20) NOT NULL  
)

構成に指定される名前は、 ConfigurationFilter 列に格納されている値です。

直接構成および間接構成

Integration Services では、直接構成と間接構成があります。 構成を直接指定した場合、Integration Services は、構成アイテムとパッケージ オブジェクト プロパティとの間に直接リンクを作成します。 直接構成は、ソースの位置が変化しない場合に適しています。 たとえば、パッケージ内のすべての配置で同じファイル パスが必ず使用される場合は、XML 構成ファイルを指定できます。

間接構成では、環境変数が使用されます。 構成設定を直接指定する代わりに、構成値を格納する環境変数が指定されます。 間接構成は、パッケージのそれぞれの配置に対して構成の位置が変更される可能性がある場合に適しています。

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

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

注意

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

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

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

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

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

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

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

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

\Package.Properties[MaximumErrorCount]

\Package.Properties[LoggingMode]

\Package.Properties[LocaleID]

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

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

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

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

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

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

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

注意

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

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

列 説明
[構成名] 構成の名前です。
[構成の種類] 構成の種類です。
[構成文字列] 構成の場所です。 場所は、パス、環境変数、レジストリ キー、親パッケージの変数名、または SQL Server データベースのテーブルの場合があります。
[対象になるオブジェクト] 構成を持つプロパティを設定するオブジェクトの名前です。 構成が XML 構成ファイルの場合、構成で複数のオブジェクトを更新できるため、この列は空白になります。
[対象になるプロパティ] プロパティの名前。 構成が XML 構成ファイルまたは SQL Server テーブルに書き込まれる場合は、構成で複数のオブジェクトを更新できるため、この列は空白になります。

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

  1. SQL Server Data Tools (SSDT)で、目的のパッケージが含まれている Integration Services プロジェクトを開きます。

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

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

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

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

  6. パッケージ構成ウィザードの初期画面で、[次へ] を選択します。

  7. [構成の種類の選択] ページで構成の種類を指定してから、選択した構成の種類に対応するプロパティを設定します。 詳細については、「 Package Configuration Wizard UI Reference」を参照してください。

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

    注意

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

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

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

  11. [閉じる] を選択します。

[パッケージ構成オーガナイザー]

[パッケージ構成オーガナイザー] ダイアログ ボックスを使用すると、パッケージ構成を有効にし、現在のパッケージの構成の一覧を表示して、構成の優先読み込み順序を指定できます。

注意

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

複数の構成で同じプロパティを更新した場合、構成の一覧内で上の方にある構成の値は、一覧内で下の方にある構成の値に置き換えられます。 パッケージを実行するときに使用される値は、プロパティに最後に読み込まれた値です。 また、パッケージで XML 構成ファイルなどの直接構成と環境変数などの間接構成の組み合わせを使用している場合は、直接構成の場所を指す間接構成を一覧の上の方に置く必要があります。

注意

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

パッケージ オブジェクトのプロパティの値は、パッケージ構成によって実行時に更新されます。 パッケージが読み込まれると、パッケージの開発時に設定された値は、構成の値に置き換えられます。 Integration Services では、さまざまな構成の種類がサポートされています。 たとえば、複数の構成を含むことができる XML ファイルや、単一の構成を含む環境変数を使用できます。 詳細については、「 パッケージ構成」を参照してください。

Options

[パッケージの構成を有効にする]
パッケージで使用する構成を選択します。

[構成名]
構成の名前を表示します。

[構成の種類]
構成を格納する場所の種類を表示します。

[構成文字列]
構成値を格納する場所を表示します。 場所には、ファイルのパス、環境変数の名前、親パッケージ変数の名前、レジストリ キー、または SQL Server テーブルの名前を使用できます。

[対象になるオブジェクト]
構成を更新するオブジェクトの名前を表示します。 構成が XML 構成ファイルまたは SQL Server テーブルである場合は、構成に複数のオブジェクトを含むことができるため、この列は空白になります。

[対象になるプロパティ]
構成によって変更されるプロパティの名前を表示します。 構成の種類が複数の構成をサポートしている場合、この列は空白になります。

追加
パッケージ構成ウィザードを使用して構成を追加します。

[編集]
パッケージ構成ウィザードを再実行することにより、既存の構成を編集します。

Remove
構成を選択してから、[削除] を選択します。

矢印
構成を選択し、上矢印および下矢印を使用して、構成を一覧の上または下に移動します。 構成は、一覧に表示された順序で読み込まれます。

パッケージ構成ウィザードの UI リファレンス

パッケージ構成ウィザード を使用すると、Integration Services パッケージとそのオブジェクトのプロパティを実行時に更新する構成を作成できます。 このウィザードは、 [パッケージ構成オーガナイザー] ダイアログ ボックスで新しい構成を追加するか既存の構成を変更するときに実行されます。 [パッケージ構成オーガナイザー] ダイアログ ボックスを開くには、SQL Server Data Tools (SSDT) で [SSIS] メニューの [パッケージ構成] をクリックします。 詳細については、「パッケージ構成を作成する」を参照してください。

注意

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

ここでは、ウィザードの各ページについて説明します。

[パッケージ構成ウィザードへようこそ] ページ

SSIS 構成ウィザード を使用すると、パッケージとそのオブジェクトのプロパティを実行時に更新する構成を作成できます。

Options

[次回からこのページを表示しない]
次回ウィザードを起動するときに、ようこそページをスキップします。

Next
ウィザードの次のページへ移動します。

[構成の種類の選択] ページ

[構成の種類の選択] ページを使用すると、作成する構成を指定できます。

どの種類の構成を使用するか決定するための詳細な情報については、「 パッケージ構成」を参照してください。

静的オプション

構成の種類
次のオプションを使用して、構成を格納するソースの種類を選択します。

値 説明
XML 構成ファイル 構成を XML ファイルとして格納します。 この値を選択すると、セクション [構成の種類] に動的オプションが表示されます。
環境変数 構成を環境変数の 1 つに格納します。 この値を選択すると、セクション [構成の種類] に動的オプションが表示されます。
レジストリ エントリ 構成をレジストリに格納します。 この値を選択すると、セクション [構成の種類] に動的オプションが表示されます。
親パッケージ変数 構成をタスクを含むパッケージに変数として格納します。 この値を選択すると、セクション [構成の種類] に動的オプションが表示されます。
SQL Server 構成を SQL Server のテーブルに格納します。 この値を選択すると、セクション [構成の種類] に動的オプションが表示されます。

Next
ウィザードのシーケンスの次のページを表示します。

動的オプション

[構成の種類] オプション = [XML 構成ファイル]

[構成設定を直接指定する]
設定を直接指定する場合に使用します。

値 説明
[構成ファイル名] ウィザードで生成する構成ファイルのパスを入力します。
[参照] [構成ファイルの場所の選択] ダイアログ ボックスを使用して、ウィザードで生成する構成ファイルのパスを指定します。 ファイルが存在しない場合は、ウィザードによって作成されます。

[構成の場所を環境変数に格納する]
構成を格納する環境変数を指定する場合に使用します。

値 説明
環境変数 一覧から環境変数を選択します。
[構成の種類] オプション = [環境変数]

環境変数
構成情報を格納する環境変数を選択します。

[構成の種類] オプション = [レジストリ エントリ]

[構成設定を直接指定する]
設定を直接指定する場合に使用します。

値 説明
レジストリ エントリ 構成情報を格納するレジストリ キーを入力します。 形式は <registry key> です。

Value という名前の値を持つレジストリ キーが、あらかじめ HKEY_CURRENT_USER に存在していることが必要です。 この値には、DWORD または文字列を指定できます。

HKEY_CURRENT_USER のルートにないレジストリ キーを使用する場合は、<Registry key\registry key\...> の形式を使用してキーを識別します。

[構成の場所を環境変数に格納する]
構成を格納する環境変数を指定する場合に使用します。

値 説明
環境変数 一覧から環境変数を選択します。
[構成の種類] オプション = [親パッケージ変数]

[構成設定を直接指定する]
設定を直接指定する場合に使用します。

値 説明
[親変数] 構成情報を格納する親パッケージ内の変数を指定します。

[構成の場所を環境変数に格納する]
構成を格納する環境変数を指定する場合に使用します。

値 説明
環境変数 一覧から環境変数を選択します。
[構成の種類] オプション = [SQL Server]

[構成設定を直接指定する]
設定を直接指定する場合に使用します。

値 説明
接続 一覧から接続を選択するか、 [新規作成] を選択し、新しい接続を作成します。
[構成テーブル] 既存のテーブルを選択するか、[新規作成] を選択し、新しいテーブルを作成する SQL ステートメントを記述します。
[構成フィルター] 既存の構成名を選択するか、新しい名前を入力します。

多くの SQL Server の構成は同じテーブルに格納でき、各構成には複数の構成アイテムを含むことができます。

このユーザー定義の値はテーブルに格納され、特定の構成に属する構成アイテムの識別に使用されます。

[構成の場所を環境変数に格納する]
構成を格納する環境変数を指定する場合に使用します。

値 説明
環境変数 一覧から環境変数を選択します。

[エクスポートするオブジェクトの選択] ページ

[対象になるプロパティの選択] ページまたは [エクスポートするプロパティの選択] ページを使用すると、構成に含まれるオブジェクト プロパティを指定できます。 XML 構成の種類を選択した場合のみ、複数のプロパティを選択する機能を使用できます。

Options

オブジェクト
パッケージ階層を展開して、エクスポートするプロパティを選択します。

[プロパティ属性]
プロパティの属性を表示します。

Next
ウィザードの次のページに進みます。

[ウィザードの完了] ページ

[ウィザードの完了] ページを使用すると、構成の名前を指定し、構成を作成するためにウィザードが使用する設定を表示できます。 ウィザードが完了すると、パッケージのすべての構成が一覧表示される [パッケージ構成オーガナイザー] が表示されます。

Options

[構成名]
構成の名前を入力します。

プレビュー
構成を作成するためにウィザードが使用する設定を表示します。

[完了]
構成を作成して [パッケージ構成ウィザード] を終了します。

子パッケージでの変数およびパラメーターの値の使用

この手順では、構成の種類として親変数を使用するパッケージ構成を作成する方法について説明します。 この構成の種類を使用すると、親パッケージから実行される子パッケージが親内の変数にアクセスできるようになります。

Note

親パッケージの変数またはパラメーター、またはプロジェクトのパラメーターを子パッケージのパラメーターにマップするようにパッケージ実行タスクを構成することで、値を子パッケージに渡すこともできます。 詳細については、「 パッケージ実行タスク」を参照してください。

親パッケージ内のこの変数は、子パッケージのパッケージ構成を作成する前に作成する必要はありません。 変数はいつでも親パッケージに追加できますが、パッケージ構成では親変数の正確な名前を使用する必要があります。 ただし、親変数パッケージ構成を作成するには、子パッケージ内に、この構成で更新できる変数が既に存在している必要があります。 変数の追加と構成の詳細については、「 パッケージ内のユーザー定義変数のスコープの追加、削除、変更」を参照してください。

親変数パッケージ構成で使用される親パッケージ内の変数のスコープは、パッケージ実行タスク、タスクを含むコンテナー、またはパッケージに設定できます。 パッケージ内で同じ名前の複数の変数が定義されている場合、パッケージ実行タスクのスコープ内で最も近い変数が使用されます。 パッケージ実行タスクに最も近いスコープは、タスク自体です。

親パッケージに変数を追加するには

  1. SQL Server Data Tools (SSDT) で、子パッケージに渡す変数を追加するパッケージが含まれている Integration Services プロジェクトを開きます。

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

  3. SSIS デザイナーで、変数のスコープを定義するには、次のいずれかの操作を行います。

    • スコープをパッケージに設定するには、[制御フロー] タブのデザイン画面上の任意の場所を選択します。

    • スコープをパッケージ実行タスクの親コンテナーに設定するには、コンテナーを選択します。

    • スコープをパッケージ実行タスクに設定するには、タスクを選択します。

  4. 変数を追加および構成します。

    Note

    変数で格納するデータと互換性のあるデータ型を選択します。

  5. 更新したパッケージを保存するには、[ファイル] メニューの [選択されたファイルを上書き保存] を選択します。

子パッケージに変数を追加するには

  1. SQL Server Data Tools (SSDT) で、親変数構成を追加するパッケージが含まれている Integration Services プロジェクトを開きます。

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

  3. SSIS デザイナーで、スコープをパッケージに設定するには、[制御フロー] タブのデザイン画面上の任意の場所を選択します。

  4. 変数を追加および構成します。

    Note

    変数で格納するデータと互換性のあるデータ型を選択します。

  5. 更新したパッケージを保存するには、[ファイル] メニューの [選択されたファイルを上書き保存] を選択します。

Create a Deployment Utility

パッケージ配置の最初の手順は、Integration Services プロジェクトの配置ユーティリティを作成することです。 配置ユーティリティは、別のサーバーに Integration Services プロジェクトのパッケージを配置する際に必要となるファイルを格納したフォルダーです。 配置ユーティリティは Integration Services プロジェクトが格納されているコンピューター上に作成されます。

Integration Services プロジェクトのパッケージ配置ユーティリティを作成するには、最初に配置ユーティリティ作成用のビルド プロセスを設定してから、プロジェクトをビルドします。 プロジェクトをビルドすると、プロジェクトのすべてのパッケージおよびパッケージの構成が自動的に追加されます。 Readme ファイルなどのファイルをプロジェクトに追加して配置するには、Integration Services プロジェクトの [その他] フォルダーにファイルを格納します。 プロジェクトのビルド時に、これらのファイルも自動的に追加されます。

プロジェクト配置は個別に設定できます。 プロジェクトをビルドしてパッケージ配置ユーティリティを作成する前に、配置ユーティリティのプロパティを設定して、プロジェクトのパッケージの配置方法をカスタマイズできます。 たとえば、プロジェクトの配置時にパッケージの構成を更新するかどうかを指定できます。 Integration Services プロジェクトのプロパティにアクセスするには、プロジェクトを右クリックして [プロパティ] を選択します。

次の表に、配置ユーティリティのプロパティの一覧を示します。

プロパティ 説明
AllowConfigurationChange 配置の際に構成を更新するかどうかを指定する値。
CreateDeploymentUtility プロジェクトのビルド時にパッケージ配置ユーティリティを作成するかどうかを指定する値。 配置ユーティリティを作成するには、このプロパティが True である必要があります。
DeploymentOutputPath 配置ユーティリティの場所。Integration Services プロジェクトから見た相対的な位置。

Integration Services プロジェクトをビルドすると、<プロジェクト名>.SSISDeploymentManifest.xml というマニフェスト ファイルが作成され、プロジェクトのパッケージのコピーおよびパッケージの依存関係と共に、プロジェクトの bin\Deployment フォルダーまたは DeploymentOutputPath プロパティで指定された場所に格納されます。 マニフェスト ファイルには、プロジェクトに含まれるパッケージ、パッケージの構成、およびその他のファイルの一覧が記述されます。

配置フォルダーの内容は、プロジェクトをビルドするたびに更新されます。 つまり、このフォルダーに保存されているファイルのうち、ビルド プロセスで再度このフォルダーにコピーされなかったものはすべて、削除されます。 たとえば、配置フォルダーに保存されたパッケージ構成ファイルは削除されます。

パッケージ配置ユーティリティを作成するには

  1. SQL Server Data Tools (SSDT)で、パッケージ配置ユーティリティを作成する Integration Services プロジェクトが含まれているソリューションを開きます。

  2. プロジェクトを右クリックして、[プロパティ] を選択します。

  3. [<プロジェクト名> プロパティ ページ] ダイアログ ボックスで、[配置ユーティリティ] を選択します。

  4. パッケージの配置時にパッケージの構成を更新するには、 [AllowConfigurationChanges] を Trueに設定します。

  5. [CreateDeploymentUtility] を Trueに設定します。

  6. 必要に応じて、 DeploymentOutputPath プロパティを変更して、配置ユーティリティの場所を更新します。

  7. [OK] を選択します。

  8. ソリューション エクスプローラーで、プロジェクトを右クリックし、[ビルド] を選択します。

  9. ビルドの進捗状況とエラーが [出力] ウィンドウに表示されます。

配置ユーティリティを使用してパッケージを配置する

配置ユーティリティを構築し、その配置ユーティリティが構築されたコンピューター以外のコンピューターに Integration Services プロジェクトのパッケージをインストールする場合は、最初に配置フォルダーを目的のコンピューターにコピーする必要があります。

配置フォルダーのパスは、配置ユーティリティを作成した Integration Services プロジェクトの DeploymentOutputPath プロパティで指定されます。 既定のパスは、Integration Services プロジェクトを基準とする bin\Deployment です。 詳細については、「 配置ユーティリティを作成する」を参照してください。

パッケージ インストール ウィザードを使用してパッケージをインストールします。 ウィザードを起動し、配置フォルダーをサーバーにコピーしてから、配置ユーティリティ ファイルをダブルクリックします。 このファイルは、<プロジェクト名>.SSISDeploymentManifest という名前で、インストール先のコンピューターの配置フォルダーにあります。

注意

配置するパッケージのバージョンによっては、SQL Server の異なるバージョンがサイド バイ サイドでインストールされている場合にエラーが発生する可能性があります。 このエラーが発生するのは、.SSISDeploymentManifest ファイル名拡張子が Integration Services のすべてのバージョンで同じであるためです。 このファイルをダブルクリックすると、最後にインストールしたバージョンの Integration Services のインストーラー (dtsinstall.exe) が呼び出されますが、配置ユーティリティ ファイルとはバージョンが異なる場合があります。 この問題を回避するには、コマンド ラインから正しいバージョンの dtsinstall.exe を実行し、配置ユーティリティ ファイルのパスを指定します。

パッケージ インストール ウィザードを使用すると、手順に従ってパッケージをファイル システムまたは SQL Server にインストールできます。 インストールは、次の方法で構成できます。

  • パッケージをインストールする場所の種類と場所を選択します。

  • パッケージの依存関係をインストールする場所を選択します。

  • ターゲット サーバーにインストールされたパッケージを検証します。

パッケージのファイル ベースの依存関係は、必ずファイル システムにインストールされます。 パッケージをファイル システムにインストールする場合、依存関係は、パッケージ用に指定したのと同じフォルダーにインストールされます。 パッケージを SQL Server にインストールする場合は、ファイル ベースの依存関係を格納するフォルダーを指定できます。

パッケージに含まれている構成をインストール先のコンピューター用に合わせて変更したい場合は、ウィザードを使ってプロパティの値を更新できます。

パッケージ インストール ウィザードを使ってパッケージをインストールする方法に加えて、 dtutil コマンド プロンプト ユーティリティを使ってパッケージをコピーおよび移動する方法があります。 詳細については、「 dtutil ユーティリティ」を参照してください。

SQL Server のインスタンスにパッケージを配置するには

  1. ターゲット コンピューターの配置フォルダーを開きます。

  2. <プロジェクト名>.SSISDeploymentManifest という名前のマニフェスト ファイルをダブルクリックしてパッケージ インストール ウィザードを起動します。

  3. [SSIS パッケージの配置] ページで、 [SQL Server に配置] オプションを選択します。

  4. 必要に応じて、ターゲット サーバーにパッケージがインストールされた後で検証を行う場合は、[インストール後にパッケージを検証する] を選択します。

  5. [インストール先の SQL Server の指定] ページで、パッケージをインストールする SQL Server のインスタンスを指定し、認証モードを選択します。 [SQL Server 認証] を選択した場合は、ユーザー名とパスワードを指定する必要があります。

  6. [インストール フォルダーの選択] ページで、パッケージの依存関係をインストールするファイル システムのフォルダーを指定します。

  7. パッケージに構成が含まれる場合は、[パッケージの構成] ページで構成を編集して、 [値] の一覧の値を更新できます。

  8. インストール後にパッケージの検証を行うように選択した場合、配置したパッケージの検証結果が表示されます。

パッケージの再配置

プロジェクトの配置後に、パッケージの機能を更新または拡張し、更新したパッケージを含む Integration Services プロジェクトを再配置する必要がある場合があります。 パッケージの再配置プロセスの一環として、配置ユーティリティに含まれている構成プロパティを見直す必要があります。 たとえば、パッケージの再配置後に構成が変更されないようにする場合などがあります。

再配置のプロセス

パッケージの更新の終了後、プロジェクトを再構築し、ターゲット コンピューターに配置フォルダーをコピーしてから、パッケージ インストール ウィザードを再度実行します。

プロジェクトのパッケージの一部だけを更新した場合、プロジェクト全体を再配置する必要がないことがあります。 パッケージの一部だけを配置するために、新しい Integration Services プロジェクトを作成して、このプロジェクトに更新したパッケージを追加し、プロジェクトをビルドして配置できます。 パッケージの構成は、パッケージを別のプロジェクトに追加する際に、自動的にパッケージと共にコピーされます。

パッケージ インストール ウィザードの UI リファレンス

パッケージ インストール ウィザード を使用すると、プロジェクトに含まれるパッケージおよびその他のファイル、パッケージの従属ファイルを含む Integration Services プロジェクトを配置できます。

パッケージを配置する前に、構成を作成してパッケージに配置できます。 Integration Services は構成を使用して、パッケージのプロパティとパッケージ オブジェクトを実行時に動的に更新します。 たとえば、接続文字列が含まれるプロパティに値をマップする構成を使用して、実行時に OLE DB 接続の接続文字列を動的に設定できます。

Integration Services プロジェクトを構築して配置ユーティリティを作成するまでは、パッケージ インストール ウィザードは実行できません。 詳細については、「 配置ユーティリティを使用してパッケージを配置する」を参照してください。

ここでは、ウィザードの各ページについて説明します。

[パッケージ インストール ウィザードへようこそ] ページ

パッケージ インストール ウィザード を使用すると、パッケージ配置ユーティリティを作成する Integration Services プロジェクトを配置できます。

[次回からこの開始ページを表示しない]
ウィザードを再度実行するときに開始ページをスキップします。

Next
ウィザードの次のページに進みます。

[完了]
[パッケージ インストール ウィザードの完了] ページまでスキップします。 ウィザードの前のページに戻って選択内容を変更する場合、必要なオプションの指定がすべて終わったらこのオプションを使用します。

[パッケージの構成] ページ

[パッケージの構成] ページを使用すると、パッケージ構成を編集できます。

Options

構成ファイル
一覧からファイルを選択して、構成ファイルの内容を編集します。

関連項目:「パッケージ構成を作成する」

Path
構成するプロパティのパスを表示します。

Type
プロパティのデータ型が表示されます。

Value
構成の値を指定します。

Next
ウィザードの次のページに進みます。

[完了]
[パッケージ インストール ウィザードの完了] ページまでスキップします。 ウィザードの前のページに戻って選択内容を変更する場合、必要なオプションの指定がすべて終わったらこのオプションを使用します。

[インストールの確認] ページ

[インストールの確認] ページを使用して、パッケージのインストールの開始、状態の表示、およびウィザードが指定されたプロジェクトからファイルをインストールするために使用する情報の表示を行います。

Next
パッケージとその依存関係をインストールし、インストールが完了したらウィザードの次のページへ移動します。

状態
パッケージ インストールの進行状況を表示します。

[完了]
[パッケージ インストール ウィザードの完了] ページに移動します。 ウィザードの前のページに戻って選択内容を変更する場合、必要なオプションの指定がすべて終わったらこのオプションを使用します。

[SSIS パッケージの配置] ページ

[SSIS パッケージの配置] ページを使用して、Integration Services パッケージとその従属ファイルをインストールする場所を指定します。

Options

[ファイル システムに配置]
パッケージとその従属ファイルをファイル システム上の指定したフォルダーに配置します。

[SQL Server に配置]
パッケージとその従属ファイルを SQL Server のインスタンスに配置します。 SQL Server がサーバー間でパッケージを共有している場合に、このオプションを使用します。 パッケージの従属ファイルは、すべてファイル システムの指定フォルダーにインストールされます。

[インストール後にパッケージを検証する]
インストール後にパッケージを検証するかどうかを指定します。

Next
ウィザードの次のページに進みます。

[完了]
[パッケージ インストール ウィザードの完了] ページまでスキップします。 ウィザードの前のページに戻って選択内容を変更する場合、必要なオプションの指定がすべて終わったらこのオプションを使用します。

[パッケージの検証] ページ

[パッケージの検証] ページを使用して、パッケージ検証の進行と結果を表示します。

Next
ウィザードの次のページに進みます。

[インストール フォルダーの選択] ページ

[インストール フォルダーの選択] ページを使用して、パッケージとその従属ファイルをインストールするファイル システム フォルダーを指定します。

Options

フォルダー
パッケージとその従属ファイルをコピーするパスとフォルダーを指定します。

[参照]
[フォルダーの参照] ダイアログ ボックスを使用して、インストール先のフォルダーを参照します。

Next
ウィザードの次のページに進みます。

[完了]
[パッケージ インストール ウィザードの完了] ページまでスキップします。 ウィザードの前のページに戻って選択内容を変更する場合、必要なオプションの指定がすべて終わったらこのオプションを使用します。

[インストール先の SQL Server の指定] ページ

[インストール先の SQL Server の指定] ページを使用して、SQL Server のインスタンスへのパッケージ配置に関するオプションを指定します。

Options

サーバー名
パッケージの配置先となるサーバーの名前を指定します。

[Windows 認証を使用する]
サーバーのサインインに Windows 認証を使用するかどうかを指定します。 より高いセキュリティのためには Windows 認証をお勧めします。

[SQL Server 認証を使用する]
パッケージがサーバーのサインインに SQL Server 認証を使用するかどうかを指定します。 SQL Server 認証を使用する場合は、ユーザー名とパスワードを入力する必要があります。

ユーザー名
ユーザー名を指定します。

パスワード
パスワードを指定します。

[パッケージのパス]
論理フォルダーの名前を指定するか、または既定フォルダーを使用する場合は「/」を入力します。

[SSIS パッケージ] ダイアログ ボックスでフォルダーを選択するには、参照ボタン ([...]) を選択します。ただし、ダイアログ ボックスで既定フォルダーを選択することはできません。 既定フォルダーを使用する場合は、テキスト ボックスに「/」を入力する必要があります。

注意

有効なパッケージ パスを入力しないと、"1 つ以上の引数が無効です。" というエラー メッセージが表示されます。

[暗号化をサーバー ストレージに依存する]
パッケージの安全を確保するために、Database Engine のセキュリティ機能を使用する場合に選択します。

Next
ウィザードの次のページに進みます。

[完了]
[パッケージ インストール ウィザードの完了] ページまでスキップします。 ウィザードの前のページに戻って選択内容を変更する場合、必要なオプションの指定がすべて終わったらこのオプションを使用します。

[パッケージ インストール ウィザードの完了] ページ

[パッケージ インストール ウィザードの完了] ページを使用して、パッケージのインストール結果の要約を表示します。 このページでは、配置された Integration Services プロジェクトの名前、インストールされたパッケージ、構成ファイル、インストール場所などの詳細が表示されます。

[完了]
[完了] をクリックすると、ウィザードが終了します。