Azure portal で SSIS パッケージの実行アクティビティを使用して SSIS パッケージを実行する
適用対象:
Azure Data Factory Azure Synapse Analytics
ヒント
企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータ サイエンス、リアルタイム分析、ビジネス インテリジェンス、レポートまで、あらゆるものをカバーしています。 無料で新しい試用版を開始する方法について説明します。
この記事では、Azure Data Factory と Synapse Pipelines ポータルで SSIS パッケージの実行アクティビティを使用することで、Azure Data Factory パイプラインで SQL Server Integration Services (SSIS) パッケージを実行する方法について説明します。
前提条件
Azure-SSIS 統合ランタイム (IR) がない場合は、「チュートリアル: Azure-SSIS 統合ランタイムのプロビジョニング」の手順に従って作成します。
SSIS パッケージの実行アクティビティでパイプラインを作成する
この手順では、Data Factory の UI またはアプリを使用してパイプラインを作成します。 パイプラインに SSIS パッケージの実行アクティビティを追加し、SSIS パッケージを実行するように構成します。
Azure portal の Data Factory の概要またはホーム ページで、[Open Azure Data Factory Studio] タイルを選択して Data Factory の UI またはアプリを別のタブで開始します。
ホーム ページで [調整] を選択します。
[活動] ツールボックスで [SSIS] を検索します。 次に、SSIS パッケージの実行アクティビティをパイプライン デザイナー画面にドラッグします。
[SSIS パッケージの実行] アクティビティ オブジェクトを選択して、 [全般] 、 [設定] 、 [SSIS パラメーター] 、 [接続マネージャー] 、および [プロパティのオーバーライド] タブを構成します。
[全般] タブ
[SSIS パッケージの実行] アクティビティの [全般] タブで、次の手順を実行します。
[名前] には、[SSIS パッケージの実行] アクティビティの名前を入力します。
[説明] には、[SSIS パッケージの実行] アクティビティの説明を入力します。
[タイムアウト] には、[SSIS パッケージの実行] アクティビティを実行できる最大時間を入力します。 既定値は 7 日で、形式は D.HH:MM:SS です。
[再試行] には、[SSIS パッケージ実行] アクティビティの最大再試行回数を入力します。
[再試行間隔] には、[SSIS パッケージ実行] アクティビティの各再試行の間隔を秒数で入力します。 既定値は 30 秒です。
[Secure output](出力の保護) チェック ボックスをオンにして、[SSIS パッケージの実行] アクティビティの出力をログから除外するかどうかを選択します。
[Secure input](入力の保護) チェック ボックスをオンにして、[SSIS パッケージの実行] アクティビティの入力をログから除外するかどうかを選択します。
Settings tab
[SSIS パッケージの実行] アクティビティの [設定] タブで、次の手順を実行します。
[Azure-SSIS IR] では、SSIS パッケージの実行アクティビティを実行する指定された Azure-SSIS IR を選択します。
[説明] には、[SSIS パッケージの実行] アクティビティの説明を入力します。
[Windows 認証] チェック ボックスをオンにして、Windows 認証を使用してデータ ストア (オンプレミスの SQL サーバー/ファイル共有、Azure Files など) にアクセスするかどうかを選択します。
このチェック ボックスを選択した場合、 [ドメイン] 、 [ユーザー名] 、 [パスワード] ボックスに、パッケージ実行資格情報の値を入力します。 たとえば、Azure Files にアクセスする場合、ドメインは
Azure、ユーザー名は<storage account name>、パスワードは<storage account key>です。または、お使いの Azure Key Vault に格納されているシークレットを値として使用することもできます。 これを行うには、その横にある [AZURE KEY VAULT] チェック ボックスをオンにします。 既存のキー コンテナーのリンクされたサービスを選択または編集するか、新しいサービスを作成します。 次に、値に対するシークレットの名前またはバージョンを選択します。 キー コンテナーのリンクされたサービスを作成または編集するときに、既存のキー コンテナーを選択または編集したり、新しいキー コンテナーを作成したりできます。 まだ行っていない場合は、キー コンテナーへのアクセスを、Data Factory のマネージド ID に許可します。
<key vault linked service name>/<secret name>/<secret version>の形式でシークレットを直接入力することもできます。[32 ビット ランタイム] チェック ボックスをオンにして、パッケージの実行に 32 ビット ランタイムが必要かどうかを選択します。
[パッケージの場所] では、 [SSISDB] 、 [ファイル システム (パッケージ)] 、 [ファイル システム (プロジェクト)] 、 [Embedded package](埋め込みパッケージ) 、または [パッケージ ストア] を選択します。
パッケージの場所:SSISDB
Azure-SSIS IR が Azure SQL Database サーバー/Managed Instance でホストされている SSIS カタログ (SSISDB) を使用してプロビジョニングされている場合、パッケージの場所として SSISDB が自動的に選択されます。または、自分で選択することもできます。 選択されている場合は、次の手順を実行します。
Azure-SSIS IR の実行中に [Manual entries](手動入力) チェック ボックスがオフの場合は、既存のフォルダー、プロジェクト、/パッケージ、および環境を SSISDB から参照します。 [最新の情報に更新] を選択して、SSISDB から新しく追加したフォルダー、プロジェクト、パッケージ、または環境を取り込み、それらを参照して選択できるようにします。 パッケージを実行するための環境を参照して選択するには、プロジェクトを事前に構成して、SSISDB の同じフォルダーからの参照としてこれらの環境を追加する必要があります。 詳細については、SSIS 環境の作成とマップに関するページを参照してください。
[ログ レベル] で、パッケージ実行用のログの定義済みのスコープを選択します。 カスタマイズしたログ名を代わりに入力する場合は、 [Customized](カスタマイズ) チェック ボックスをオンにします。
Azure-SSIS IR が実行されていない場合、または [Manual entries](手動入力) チェック ボックスがオンになっている場合は、
<folder name>/<project name>/<package name>.dtsxおよび<folder name>/<environment name>の形式で SSISDB からパッケージと環境のパスを直接入力します。
パッケージの場所:ファイル システム (パッケージ)
Azure-SSIS IR が SSISDB なしでプロビジョニングされた場合、パッケージの場所として [ファイル システム (パッケージ)] が自動的に選択されます。または、自分で選択することもできます。 選択されている場合は、次の手順を実行します。
[パッケージ パス] でパッケージ ファイル (
.dtsxを含む) への汎用名前付け規則 (UNC) パスを指定して、実行するパッケージを指定します。 パッケージを参照して選択するには、 [Browse file storage](ファイル ストレージを参照) を選択するか、パスを手動で入力します。 たとえば、Azure Files にパッケージを保存する場合、そのパスは\\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsxです。別のファイルでパッケージを構成する場合は、 [構成パス] ボックスに構成ファイル (
.dtsConfigを含む) への UNC パスも指定する必要があります。 構成を参照して選択するには、 [Browse file storage](ファイル ストレージを参照) を選択するか、パスを手動で入力します。 たとえば、構成を Azure Files に保存する場合、そのパスは\\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfigです。パッケージと構成ファイルにアクセスするための資格情報を指定します。 以前にパッケージ実行の資格情報値を入力した場合は (Windows 認証用)、 [Same as package execution credentials](パッケージ実行の資格情報と同じ) チェック ボックスをオンにして再利用できます。 それ以外の場合は、 [ドメイン] 、 [ユーザー名] 、 [パスワード] ボックスに、パッケージ アクセス資格情報の値を入力します。 たとえば、パッケージおよび構成を Azure Files に保存する場合、ドメインは
Azure、ユーザー名は<storage account name>、パスワードは<storage account key>です。または、お使いの Azure Key Vault に格納されているシークレットを値として使用することもできます。 これを行うには、その横にある [AZURE KEY VAULT] チェック ボックスをオンにします。 既存のキー コンテナーのリンクされたサービスを選択または編集するか、新しいサービスを作成します。 次に、値に対するシークレットの名前またはバージョンを選択します。 キー コンテナーのリンクされたサービスを作成または編集するときに、既存のキー コンテナーを選択または編集したり、新しいキー コンテナーを作成したりできます。 まだ行っていない場合は、キー コンテナーへのアクセスを、Data Factory のマネージド ID に許可します。
<key vault linked service name>/<secret name>/<secret version>の形式でシークレットを直接入力することもできます。これらの資格情報は、パッケージで指定されている独自のパスや他の構成によって参照される、パッケージ実行タスクの子パッケージにアクセスするためにも使用されます。
SQL Server Data Tools (SSDT) を使用してパッケージを作成するときに EncryptAllWithPassword または EncryptSensitiveWithPassword 保護レベルを使用した場合は、 [暗号化用パスワード] ボックスにパスワードの値を入力します。 または、Azure Key Vault に格納されているシークレットを値として使用することもできます (上述を参照)。
EncryptSensitiveWithUserKey 保護レベルを使用した場合は、構成ファイルか、 [SSIS パラメータ] 、 [接続マネージャー] 、または [プロパティのオーバーライド] タブに、機密性の高い値を再入力します (下記を参照)。
EncryptAllWithUserKey 保護レベルを使用した場合は、サポートされません。 SSDT または
dtutilコマンドライン ユーティリティを使用して、別の保護レベルを使用するようにパッケージを再構成する必要があります。[ログ レベル] で、パッケージ実行用のログの定義済みのスコープを選択します。 カスタマイズしたログ名を代わりに入力する場合は、 [Customized](カスタマイズ) チェック ボックスをオンにします。
パッケージに指定できる標準のログ プロバイダーを使用する以外に、パッケージの実行をログに記録する場合は、 [ログ パス] ボックスで UNC パスを指定してログ フォルダーを指定します。 ログ フォルダを参照して選択するには、 [Browse file storage](ファイル ストレージを参照) を選択するか、パスを手動で入力します。 たとえば、ログを Azure Files に保存する場合、ログ記録のパスは
\\<storage account name>.file.core.windows.net\<file share name>\<log folder name>です。 サブフォルダーは、個々のパッケージ実行ごとにこのパス内に作成され、SSIS パッケージの実行アクティビティの実行 ID に基づいて名前が付けられます。このログ ファイルは 5 分ごとに生成されます。ログ フォルダーにアクセスするための資格情報を指定します。 以前にパッケージ アクセスの資格情報値を入力した場合は (上記を参照)、 [Same as package access credentials](パッケージ アクセスの資格情報と同じ) チェック ボックスをオンにして再利用できます。 それ以外の場合は、 [ドメイン] 、 [ユーザー名] 、 [パスワード] ボックスに、ログイン アクセス資格情報の値を入力します。 たとえば、Azure Files にログを格納する場合、ドメインは
Azure、ユーザー名は<storage account name>、パスワードは<storage account key>です。 または、お使いの Azure Key Vault に格納されているシークレットを値として使用することもできます (上記を参照)。
前述のすべての UNC パスでは、完全修飾ファイル名を 260 文字未満にする必要があります。 ディレクトリ名は 248 文字未満でなければなりません。
パッケージの場所:ファイル システム (プロジェクト)
パッケージの場所として [ファイル システム (プロジェクト)] を選択した場合は、次の手順を実行します。
実行するパッケージを指定するには、 [プロジェクト パス] ボックスにプロジェクト ファイル (
.ispacを含む) への UNC パス、 [パッケージ名] ボックスにプロジェクトのパッケージ ファイル (.dtsxを含む) を指定します。 プロジェクトを参照して選択するには、 [Browse file storage](ファイル ストレージを参照) を選択するか、パスを手動で入力します。 たとえば、Azure Files にプロジェクトを保存する場合、そのパスは\\<storage account name>.file.core.windows.net\<file share name>\<project name>.ispacです。プロジェクトおよびパッケージ ファイルにアクセスするための資格情報を指定します。 以前にパッケージ実行の資格情報値を入力した場合は (Windows 認証用)、 [Same as package execution credentials](パッケージ実行の資格情報と同じ) チェック ボックスをオンにして再利用できます。 それ以外の場合は、 [ドメイン] 、 [ユーザー名] 、 [パスワード] ボックスに、パッケージ アクセス資格情報の値を入力します。 たとえば、プロジェクトを Azure Files に保存する場合、ドメインは
Azure、ユーザー名は<storage account name>、パスワードは<storage account key>です。または、お使いの Azure Key Vault に格納されているシークレットを値として使用することもできます。 これを行うには、その横にある [AZURE KEY VAULT] チェック ボックスをオンにします。 既存のキー コンテナーのリンクされたサービスを選択または編集するか、新しいサービスを作成します。 次に、値に対するシークレットの名前またはバージョンを選択します。 キー コンテナーのリンクされたサービスを作成または編集するときに、既存のキー コンテナーを選択または編集したり、新しいキー コンテナーを作成したりできます。 まだ行っていない場合は、キー コンテナーへのアクセスを、Data Factory のマネージド ID に許可します。
<key vault linked service name>/<secret name>/<secret version>の形式でシークレットを直接入力することもできます。これらの資格情報は、同じプロジェクトから参照されるパッケージ実行タスクの子パッケージにアクセスするためにも使用されます。
SSDT を使用してパッケージを作成するときに EncryptAllWithPassword または EncryptSensitiveWithPassword 保護レベルを使用した場合は、 [暗号化用パスワード] ボックスにパスワードの値を入力します。 または、Azure Key Vault に格納されているシークレットを値として使用することもできます (上述を参照)。
EncryptSensitiveWithUserKey 保護レベルを使用した場合は、 [SSIS パラメータ] 、 [接続マネージャー] 、または [プロパティのオーバーライド] タブに、機密性の高い値を再入力します (後述を参照)。
EncryptAllWithUserKey 保護レベルを使用した場合は、サポートされません。 SSDT または
dtutilコマンドライン ユーティリティを使用して、別の保護レベルを使用するようにパッケージを再構成する必要があります。[ログ レベル] で、パッケージ実行用のログの定義済みのスコープを選択します。 カスタマイズしたログ名を代わりに入力する場合は、 [Customized](カスタマイズ) チェック ボックスをオンにします。
パッケージに指定できる標準のログ プロバイダーを使用する以外に、パッケージの実行をログに記録する場合は、 [ログ パス] ボックスで UNC パスを指定してログ フォルダーを指定します。 ログ フォルダを参照して選択するには、 [Browse file storage](ファイル ストレージを参照) を選択するか、パスを手動で入力します。 たとえば、ログを Azure Files に保存する場合、ログ記録のパスは
\\<storage account name>.file.core.windows.net\<file share name>\<log folder name>です。 サブフォルダーは、個々のパッケージ実行ごとにこのパス内に作成され、SSIS パッケージの実行アクティビティの実行 ID に基づいて名前が付けられます。このログ ファイルは 5 分ごとに生成されます。ログ フォルダーにアクセスするための資格情報を指定します。 以前にパッケージ アクセスの資格情報値を入力した場合は (上記を参照)、 [Same as package access credentials](パッケージ アクセスの資格情報と同じ) チェック ボックスをオンにして再利用できます。 それ以外の場合は、 [ドメイン] 、 [ユーザー名] 、 [パスワード] ボックスに、ログイン アクセス資格情報の値を入力します。 たとえば、Azure Files にログを格納する場合、ドメインは
Azure、ユーザー名は<storage account name>、パスワードは<storage account key>です。 または、お使いの Azure Key Vault に格納されているシークレットを値として使用することもできます (上記を参照)。
前述のすべての UNC パスでは、完全修飾ファイル名を 260 文字未満にする必要があります。 ディレクトリ名は 248 文字未満でなければなりません。
パッケージの場所:埋め込みパッケージ
パッケージの場所として [埋め込みパッケージ] を選択した場合は、次の手順を実行します。
パッケージ ファイル (
.dtsx) をドラッグ アンド ドロップするか、ファイル フォルダーから指定されたボックスにアップロードします。 パッケージは自動的に圧縮され、アクティビティ ペイロードに埋め込まれます。 埋め込みが完了すると、パッケージは後で編集用にダウンロードできます。 また、埋め込みパッケージを複数のアクティビティで使用できるパイプライン パラメーターに割り当てることによってパラメーター化することで、パイプライン ペイロードのサイズを最適化することもできます。 現在、プロジェクト ファイル (.ispac) の埋め込みはサポートされていないため、埋め込みパッケージのプロジェクトレベルのスコープで SSIS パラメーター/接続マネージャーを使用することはできません。埋め込みパッケージがすべて暗号化されておらず、その内部でパッケージ実行タスク (EPT) の使用が検出された場合は、 [パッケージ実行タスク] チェック ボックスが自動的に選択され、ファイル システムのパスで参照されている子パッケージも、埋め込むことができるように自動的に追加されます。
EPT の使用を検出できない場合は、 [パッケージ実行タスク] チェック ボックスを手動で選択し、ファイル システムのパスで参照されている子パッケージを埋め込むことができるように 1 つずつ追加する必要があります。 子パッケージが SQL Server database (MSDB) に格納されている場合は、それらを埋め込むことができないため、Azure-SSIS IR が SQL Server 参照を使用してフェッチする MSDB にアクセスできることを確認する必要があります。 現在、プロジェクト ファイル (
.ispac) の埋め込みはサポートされていないため、子パッケージのプロジェクトベースの参照を使用することはできません。SSDT を使用してパッケージを作成するときに EncryptAllWithPassword または EncryptSensitiveWithPassword 保護レベルを使用した場合は、 [暗号化用パスワード] ボックスにパスワードの値を入力します。
または、Azure Key Vault に格納されているシークレットを値として使用することもできます。 これを行うには、その横にある [AZURE KEY VAULT] チェック ボックスをオンにします。 既存のキー コンテナーのリンクされたサービスを選択または編集するか、新しいサービスを作成します。 次に、値に対するシークレットの名前またはバージョンを選択します。 キー コンテナーのリンクされたサービスを作成または編集するときに、既存のキー コンテナーを選択または編集したり、新しいキー コンテナーを作成したりできます。 まだ行っていない場合は、キー コンテナーへのアクセスを、Data Factory のマネージド ID に許可します。
<key vault linked service name>/<secret name>/<secret version>の形式でシークレットを直接入力することもできます。EncryptSensitiveWithUserKey 保護レベルを使用した場合は、構成ファイルか、 [SSIS パラメータ] 、 [接続マネージャー] 、または [プロパティのオーバーライド] タブに、機密性の高い値を再入力します (下記を参照)。
EncryptAllWithUserKey 保護レベルを使用した場合は、サポートされません。 SSDT または
dtutilコマンドライン ユーティリティを使用して、別の保護レベルを使用するようにパッケージを再構成する必要があります。[ログ レベル] で、パッケージ実行用のログの定義済みのスコープを選択します。 カスタマイズしたログ名を代わりに入力する場合は、 [Customized](カスタマイズ) チェック ボックスをオンにします。
パッケージに指定できる標準のログ プロバイダーを使用する以外に、パッケージの実行をログに記録する場合は、 [ログ パス] ボックスで UNC パスを指定してログ フォルダーを指定します。 ログ フォルダを参照して選択するには、 [Browse file storage](ファイル ストレージを参照) を選択するか、パスを手動で入力します。 たとえば、ログを Azure Files に保存する場合、ログ記録のパスは
\\<storage account name>.file.core.windows.net\<file share name>\<log folder name>です。 サブフォルダーは、個々のパッケージ実行ごとにこのパス内に作成され、SSIS パッケージの実行アクティビティの実行 ID に基づいて名前が付けられます。このログ ファイルは 5 分ごとに生成されます。ログ フォルダーにアクセスするための資格情報を指定するには、 [ドメイン] 、 [ユーザー名] 、および [パスワード] ボックスに値を入力します。 たとえば、Azure Files にログを格納する場合、ドメインは
Azure、ユーザー名は<storage account name>、パスワードは<storage account key>です。 または、お使いの Azure Key Vault に格納されているシークレットを値として使用することもできます (上記を参照)。
前述のすべての UNC パスでは、完全修飾ファイル名を 260 文字未満にする必要があります。 ディレクトリ名は 248 文字未満でなければなりません。
パッケージの場所:パッケージ ストア
パッケージの場所として [パッケージ ストア] を選択した場合は、次の手順を実行します。
[Package store name](パッケージ ストア名) には、Azure-SSIS IR に関連付けられている既存のパッケージ ストアを選択します。
[パッケージ パス] ボックスで、選択したパッケージ ストアからのパス (
.dtsxなし) を指定して、実行するパッケージを指定します。 選択したパッケージ ストアがファイル システム/Azure Files の上にある場合、 [Browse file storage](ファイル ストレージを参照) を選択してパッケージを参照して選択できます。それ以外の場合は、<folder name>\<package name>の形式でパスを入力できます。 レガシ SSIS パッケージ ストアと同様に SQL Server Management Studio (SSMS) を使用して、選択したパッケージ ストアに新しいパッケージをインポートすることもできます。 詳細については、Azure-SSIS IR パッケージ ストアを使用した SSIS パッケージの管理に関するページを参照してください。別のファイルでパッケージを構成する場合は、 [構成パス] ボックスに構成ファイルへの UNC パス (
.dtsConfig) を指定する必要があります。 構成を参照して選択するには、 [Browse file storage](ファイル ストレージを参照) を選択するか、パスを手動で入力します。 たとえば、構成を Azure Files に保存する場合、そのパスは\\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfigです。構成ファイルにアクセスするための資格情報を個別で指定するかどうかを選択するには、 [Configuration access credentials](構成アクセスの資格情報) チェック ボックスをオンにします。 これは、選択したパッケージ ストアが Azure SQL Managed Instance でホストされている SQL Server データベース (MSDB) 上にある場合、または構成ファイルを格納していない場合に必要です。
以前にパッケージ実行の資格情報値を入力した場合は (Windows 認証用)、 [Same as package execution credentials](パッケージ実行の資格情報と同じ) チェック ボックスをオンにして再利用できます。 それ以外の場合は、 [ドメイン] 、 [ユーザー名] 、 [パスワード] ボックスに、構成アクセス資格情報の値を入力します。 たとえば、構成を Azure Files に保存する場合、ドメインは
Azure、ユーザー名は<storage account name>、パスワードは<storage account key>です。または、お使いの Azure Key Vault に格納されているシークレットを値として使用することもできます。 これを行うには、その横にある [AZURE KEY VAULT] チェック ボックスをオンにします。 既存のキー コンテナーのリンクされたサービスを選択または編集するか、新しいサービスを作成します。 次に、値に対するシークレットの名前またはバージョンを選択します。 キー コンテナーのリンクされたサービスを作成または編集するときに、既存のキー コンテナーを選択または編集したり、新しいキー コンテナーを作成したりできます。 まだ行っていない場合は、キー コンテナーへのアクセスを、Data Factory のマネージド ID に許可します。
<key vault linked service name>/<secret name>/<secret version>の形式でシークレットを直接入力することもできます。SSDT を使用してパッケージを作成するときに EncryptAllWithPassword または EncryptSensitiveWithPassword 保護レベルを使用した場合は、 [暗号化用パスワード] ボックスにパスワードの値を入力します。 または、Azure Key Vault に格納されているシークレットを値として使用することもできます (上述を参照)。
EncryptSensitiveWithUserKey 保護レベルを使用した場合は、構成ファイルか、 [SSIS パラメータ] 、 [接続マネージャー] 、または [プロパティのオーバーライド] タブに、機密性の高い値を再入力します (下記を参照)。
EncryptAllWithUserKey 保護レベルを使用した場合は、サポートされません。 SSDT または
dtutilコマンドライン ユーティリティを使用して、別の保護レベルを使用するようにパッケージを再構成する必要があります。[ログ レベル] で、パッケージ実行用のログの定義済みのスコープを選択します。 カスタマイズしたログ名を代わりに入力する場合は、 [Customized](カスタマイズ) チェック ボックスをオンにします。
パッケージに指定できる標準のログ プロバイダーを使用する以外に、パッケージの実行をログに記録する場合は、 [ログ パス] ボックスで UNC パスを指定してログ フォルダーを指定します。 ログ フォルダを参照して選択するには、 [Browse file storage](ファイル ストレージを参照) を選択するか、パスを手動で入力します。 たとえば、ログを Azure Files に保存する場合、ログ記録のパスは
\\<storage account name>.file.core.windows.net\<file share name>\<log folder name>です。 サブフォルダーは、個々のパッケージ実行ごとにこのパス内に作成され、SSIS パッケージの実行アクティビティの実行 ID に基づいて名前が付けられます。このログ ファイルは 5 分ごとに生成されます。ログ フォルダーにアクセスするための資格情報を指定するには、 [ドメイン] 、 [ユーザー名] 、および [パスワード] ボックスに値を入力します。 たとえば、Azure Files にログを格納する場合、ドメインは
Azure、ユーザー名は<storage account name>、パスワードは<storage account key>です。 または、お使いの Azure Key Vault に格納されているシークレットを値として使用することもできます (上記を参照)。
前述のすべての UNC パスでは、完全修飾ファイル名を 260 文字未満にする必要があります。 ディレクトリ名は 248 文字未満でなければなりません。
[SSIS パラメーター] タブ
[SSIS パッケージの実行] アクティビティの [SSIS パラメーター] タブで、次の手順を実行します。
Azure-SSIS IR の実行中にパッケージの場所として [SSISDB] が選択され、 [設定] タブの [Manual entries](手動入力) チェック ボックスがオフの場合は、値を割り当てるパラメーターとして、SSISDB から選択したプロジェクトおよびパッケージ内の既存の SSIS パラメーターが表示されます。 それ以外の場合は、値を 1 つずつ入力して手動で値を割り当てることができます。 パッケージの実行が成功するためには、それらが存在し、正しく入力されていることを確認します。
SSDT でパッケージを作成するときに EncryptSensitiveWithUserKey 保護レベルを使用し、パッケージの場所として [ファイル システム (パッケージ)] 、 [ファイル システム (プロジェクト)] 、 [埋め込みパッケージ] 、または [パッケージ ストア] を選択する場合は、構成ファイルまたはこのタブで機密性の高いパラメーターを再入力して値を割り当てる必要もあります。
パラメーターに値を割り当てるときに、式、関数、Data Factory システム変数、および Data Factory パイプライン パラメーターまたは変数を使用して動的コンテンツを追加できます。
または、お使いの Azure Key Vault に格納されているシークレットを値として使用することもできます。 これを行うには、その横にある [AZURE KEY VAULT] チェック ボックスをオンにします。 既存のキー コンテナーのリンクされたサービスを選択または編集するか、新しいサービスを作成します。 次に、値に対するシークレットの名前またはバージョンを選択します。 キー コンテナーのリンクされたサービスを作成または編集するときに、既存のキー コンテナーを選択または編集したり、新しいキー コンテナーを作成したりできます。 まだ行っていない場合は、キー コンテナーへのアクセスを、Data Factory のマネージド ID に許可します。 <key vault linked service name>/<secret name>/<secret version> の形式でシークレットを直接入力することもできます。
[接続マネージャー] タブ
[SSIS パッケージの実行] アクティビティの [接続マネージャー] タブで、次の手順を実行します。
Azure-SSIS IR の実行中にパッケージの場所として [SSISDB] が選択され、 [設定] タブの [Manual entries](手動入力) チェック ボックスがオフの場合は、そのプロパティに値を割り当てるパラメーターとして、SSISDB から選択したプロジェクトおよびパッケージ内の既存の接続マネージャーが表示されます。 それ以外の場合は、値を 1 つずつ入力して手動でプロパティに値を割り当てることができます。 パッケージの実行が成功するためには、それらが存在し、正しく入力されていることを確認します。
接続マネージャーの正しい SCOPE、NAME、PROPERTY 名を取得するには、SSDT でその接続マネージャーが含まれているパッケージを開きます。 パッケージが開いたら、該当する接続マネージャーを選択して、SSDT の [プロパティ] ウィンドウで、そのすべてのプロパティの名前と値を表示します。 この情報を使用して、実行時に接続マネージャーのプロパティの値をオーバーライドできます。
たとえば、SSDT で元のパッケージを変更せずに、SQL Server で実行されているオンプレミスからオンプレミスへのデータ フローを、ADF の SSIS IR 上で実行されているオンプレミスからクラウドへのデータ フローに変換できます。これを行うには、実行時に既存の接続マネージャーの ConnectByProxy、ConnectionString、および ConnectUsingManagedIdentity プロパティの値をオーバーライドします。
このような実行時のオーバーライドにより、オンプレミスのデータにアクセスするときに SSIS IR のプロキシとしてセルフホステッド IR (SHIR) を有効にすることができます (SHIR を SSIS IR のプロキシとして構成する方法に関する記事を参照)。また、最新の MSOLEDBSQL ドライバーを使用して Azure SQL Database/マネージド インスタンスに接続することで、ADF マネージド ID による Microsoft Entra 認証が有効になります (OLEDB 接続のために ADF マネージド ID による Microsoft Entra 認証を構成する方法に関する記事を参照)。
SSDT でパッケージを作成するときに EncryptSensitiveWithUserKey 保護レベルを使用し、パッケージの場所として [ファイル システム (パッケージ)] 、 [ファイル システム (プロジェクト)] 、 [埋め込みパッケージ] 、または [パッケージ ストア] を選択する場合は、構成ファイルまたはこのタブで機密性の高い接続マネージャー プロパティを再入力して値を割り当てる必要もあります。
接続マネージャーのプロパティに値を割り当てるときに、式、関数、Data Factory システム変数、および Data Factory パイプライン パラメーターまたは変数を使用して動的コンテンツを追加できます。
または、お使いの Azure Key Vault に格納されているシークレットを値として使用することもできます。 これを行うには、その横にある [AZURE KEY VAULT] チェック ボックスをオンにします。 既存のキー コンテナーのリンクされたサービスを選択または編集するか、新しいサービスを作成します。 次に、値に対するシークレットの名前またはバージョンを選択します。 キー コンテナーのリンクされたサービスを作成または編集するときに、既存のキー コンテナーを選択または編集したり、新しいキー コンテナーを作成したりできます。 まだ行っていない場合は、キー コンテナーへのアクセスを、Data Factory のマネージド ID に許可します。 <key vault linked service name>/<secret name>/<secret version> の形式でシークレットを直接入力することもできます。
[プロパティのオーバーライド] タブ
[SSIS パッケージの実行] アクティビティの [プロパティのオーバーライド] タブで、次の手順を実行します。
選択したパッケージの既存のプロパティのパスを 1 つずつ入力して、手動でそれらに値を割り当てます。 パッケージの実行が成功するためには、それらが存在し、正しく入力されていることを確認します。 たとえば、ユーザー変数の値をオーバーライドするには、
\Package.Variables[User::<variable name>].Valueの形式でパスを入力します。パッケージ プロパティの正しい PROPERTY PATH を取得するには、SSDT でそのプロパティが含まれているパッケージを開きます。 パッケージが開いたら、その制御フローを選択し、SSDT の [プロパティ] ウィンドウで [構成] プロパティを選択します。 次に、 [構成] プロパティの横にある省略記号 ( ... ) ボタンを選択して、パッケージ構成オーガナイザーを開きます。これは、通常、パッケージ配置モデルのパッケージ構成を作成するために使用されます。
[パッケージ構成オーガナイザー] ダイアログ ボックスで、 [パッケージの構成を有効にする] チェック ボックスをオンにし、 [追加...] ボタンをクリックしてパッケージ構成ウィザードを開きます。
パッケージ構成ウィザードで、[構成の種類] ドロップダウン メニューの [XML 構成ファイル] 項目、[構成設定を直接指定する] ボタンの順に選択し、構成ファイル名を入力し、[次へ >] ボタンを選択します。
最後に、必要なパスを含むパッケージ プロパティ、[次へ >] の順に選択します。 これで、必要なパッケージ プロパティのパスを表示し、コピーして構成ファイルに貼り付け、保存することができます。 この情報を使用して、実行時にパッケージ プロパティの値をオーバーライドできます。
SSDT でパッケージを作成するときに EncryptSensitiveWithUserKey 保護レベルを使用し、パッケージの場所として [ファイル システム (パッケージ)] 、 [ファイル システム (プロジェクト)] 、 [埋め込みパッケージ] 、または [パッケージ ストア] を選択する場合は、構成ファイルまたはこのタブで機密性の高いパッケージ プロパティを再入力して値を割り当てる必要もあります。
パッケージ プロパティに値を割り当てるときに、式、関数、Data Factory システム変数、および Data Factory パイプライン パラメーターまたは変数を使用して動的コンテンツを追加できます。
構成ファイルおよび [SSIS パラメーター] タブで割り当てられた値は、 [接続マネージャー] タブまたは [プロパティ オーバーライド] タブを使用してオーバーライドできます。 [接続マネージャー] タブで割り当てられた値は、 [プロパティ オーバーライド] タブでオーバーライドすることもできます。
パイプラインの構成を検証するために、ツール バーの [検証] を選択します。 [Pipeline Validation Report](パイプライン検証レポート) を閉じるには、[>>] を選択します。
Data Factory にパイプラインを発行するには、 [Publish All](すべて発行) を選択します。
パイプラインを実行する
この手順では、パイプラインの実行をトリガーします。
パイプラインの実行をトリガーするには、ツール バーの [トリガー] を選択し、 [Trigger Now](今すぐトリガー) を選択します。
[Pipeline Run](パイプラインの実行) ウィンドウで [完了] を選択します。
パイプラインの監視
左側で [監視] タブに切り替えます。 パイプラインの実行とその状態が、その他の情報 (実行開始時刻など) と共に表示されます。 表示を更新するには、 [最新の情報に更新] を選択します。
[アクション] 列の [View Activity Runs](アクティビティの実行の表示) リンクを選択します。 パイプラインに 1 つしかアクティビティがないので、アクティビティの実行が 1 つだけ表示されます。 SSIS パッケージの実行アクティビティです。
パッケージが実行されたことを確認するには、次のクエリを SQL サーバーの SSISDB データベースに対して実行します。
select * from catalog.executions
パイプラインのアクティビティ実行の出力から SSISDB 実行 ID を取得し、その ID を使用して SQL Server Management Studio 内でより包括的な実行ログとエラー メッセージを確認することもできます。
トリガーを使用してパイプラインのスケジュールを設定する
パイプラインがスケジュールに従って実行されるように (時間単位、日単位など)、パイプラインに対してスケジュールされたトリガーを作成することもできます。 例については、「Create a data factory - Data Factory UI」 (データ ファクトリの作成 - データ ファクトリ UI ) リンクをご確認ください。