レッスン 5-2:パッケージ構成の有効化と構成
適用対象: SQL Server Azure Data Factory の SSIS Integration Runtime
ここでは、パッケージ構成ウィザードを使用することで、プロジェクトをパッケージ配置モデルに変換してパッケージ構成を有効にします。 このウィザードを使用し、Foreach ループ コンテナーの Directory プロパティの構成設定が記述された XML 構成ファイルを生成します。 Directory プロパティの値は、実行時に更新できる新しいパッケージ レベル変数を使って指定します。 また、テストで使用するために、新しいサンプル データ フォルダーにデータを入力します。
Directory プロパティにマップするパッケージ レベル変数を作成する
SSIS デザイナーで、[制御フロー] タブの背景を選択します。 この選択により、作成する変数のスコープがこのパッケージに限定されます。
[SSIS] メニューの [変数]をクリックします。
[変数] ウィンドウで、[変数の追加] アイコンを選択します。
[名前] ボックスに「varFolderName」と入力します。
重要
変数名の大文字と小文字は区別されます。
[スコープ] ボックスにパッケージの名前 (Lesson 5) が表示されていることを確認します。
変数の [データ型]
varFolderName
ボックスの値を [String]に設定します。[制御フロー] タブに戻り、 [Foreach File in Folder] コンテナーをダブルクリックします。
[Foreach ループ エディター] の [コレクション] ページで、[Expressions] を選択し、参照ボタン (...) を選択します。
[プロパティ式エディター]で、[プロパティ] 一覧内をクリックして [Directory] を選択します。
[式] ボックスで、参照ボタン (...) を選択します。
[式ビルダー]で [変数とパラメーター] フォルダーを展開し、User::varFolderName 変数を [式] ボックスへドラッグします。
[OK] を選択して [式ビルダー] を閉じます。
[OK] を選択して [プロパティ式エディター] を閉じます。
[OK] を選択し、[Foreach ループ エディター] を閉じます。
[パッケージの構成を有効にする]
[プロジェクト]メニューの [パッケージ配置モデルに変換] を選択します。
警告のメッセージで [OK] を選択し、変換が完了したら、[パッケージ配置モデルに変換] ダイアログ ボックスで [OK] を選択します。
SSIS デザイナーで、[制御フロー] タブの背景を選択します。
[SSIS] メニューの [パッケージ構成] を選択します。
[パッケージ構成オーガナイザー] ダイアログ ボックスで [パッケージの構成を有効にする] を選択し、[追加] を選択します。
パッケージ構成ウィザードの初期画面で、[次へ] を選択します。
[構成の種類の選択] ページで、 [構成の種類] が [XML 構成ファイル]に設定されていることを確認します。
[構成の種類の選択] ページで [参照] を選択します。
プロジェクト フォルダーで [構成ファイルの場所の選択] ダイアログ ボックスが開きます。
[構成ファイルの場所の選択] ダイアログ ボックスで、[ファイル名] に「SSISTutorial」と入力し、[保存] を選択します。
[構成の種類の選択] ページで [次へ] を選択します。
[エクスポートするプロパティの選択] ページの [オブジェクト] ペインで、[変数]、[varFolderName]、[Properties] の順に展開し、[Value] チェック ボックスをオンにします。
[エクスポートするプロパティの選択] ページで [次へ] を選択します。
[ウィザードの完了] ページで、構成の構成名を入力します。たとえば、「SSIS Tutorial Directory configuration」と入力します。 構成名は [パッケージ構成オーガナイザー] ダイアログ ボックスに表示されます。
[完了] を選択します。
[閉じる] を選択します。
SSISTutorial.dtsConfig という名前の構成ファイルが作成されます。この構成ファイルには、変数の Value に対応する構成設定が含まれています。また、この変数値により、列挙子の Directory プロパティが設定されます。
注意
通常、構成ファイルにはパッケージのプロパティに関する複雑な情報が含まれていますが、このチュートリアルでは、次の構成情報のみを使用します。
<Configuration ConfiguredType="Property" Path="\Package.Variables[User::varFolderName].Properties[Value]" ValueType="String"> <ConfiguredValue></ConfiguredValue> </Configuration>
新しいサンプル データ フォルダーを作成して、データを取り込む
Windows エクスプローラーで、ドライブのルート レベル (C:\ など) にフォルダーを作成します。このフォルダーには「New Sample Data」という名前を付けてください。
コンピューター上でサンプル ファイルを探し、フォルダーから 3 つのファイルをコピーします。
コピーしたファイルを New Sample Data フォルダーに貼り付けます。