セルフホステッド IR を Azure-SSIS IR のプロキシとして構成する

[アーティクル]
01/05/2024

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータサイエンス、リアルタイム分析、ビジネスインテリジェンス、レポートまで、あらゆるものをカバーしています。無料で新しい試用版を開始する方法について説明します。

この記事では、セルフホステッド統合ランタイム (セルフホステッド IR) をプロキシとして構成して、Azure-SSIS Integration Runtime (Azure-SSIS IR) で SQL Server Integration Services (SSIS) パッケージを実行する方法について説明します。

この機能を使用すると、Azure-SSIS IR を仮想ネットワークに参加させずに、オンプレミスのデータや実行タスクにアクセスすることができます。この機能は、企業ネットワークの構成が複雑すぎるかポリシーの制限が厳しすぎて Azure-SSIS IR を導入できない場合に役立ちます。

この機能は、現時点では、SSIS データフロータスクと、SQL およびプロセス実行タスクでのみ有効にすることができます。

データフロータスクでこの機能を有効にすると、該当する場合は、次の 2 つのステージングタスクに分割されます。

オンプレミスのステージングタスク:このタスクでは、セルフホステッド IR 上のオンプレミスのデータストアに接続するデータフローコンポーネントが実行されます。これは、データをオンプレミスのデータストアから Azure BLOB ストレージのステージング領域に、またはその逆に移動します。
クラウドステージングタスク:このタスクでは、Azure-SSIS IR 上のオンプレミスのデータストアに接続しないデータフローコンポーネントが実行されます。これは、データを Azure BLOB ストレージのステージング領域からクラウドデータストアに、またはその逆に移動します。

データフロータスクを使用してオンプレミスからクラウドにデータを移動した場合、最初と 2 番目のステージングタスクは、それぞれオンプレミスとクラウドのステージングタスクになります。データフロータスクを使用してクラウドからオンプレミスにデータを移動した場合、最初と 2 番目のステージングタスクは、それぞれクラウドとオンプレミスのステージングタスクになります。データフロータスクを使用してオンプレミスからオンプレミスにデータを移動した場合、最初と 2 番目のステージングタスクは、両方ともオンプレミスのステージングタスクになります。データフロータスクを使用してクラウドからクラウドにデータを移動した場合、この機能は適用されません。

この機能は、SQL およびプロセス実行タスクで有効になり、セルフホステッド IR で実行されます。

この機能の他の利点や機能としては、まだ Azure-SSIS IR でサポートされていないリージョンでのセルフホステッド IR の設定が可能になったり、データソースのファイアウォールでのセルフホステッド IR のパブリック静的 IP アドレスが許可されたりすることなどがあります。

セルフホステッド IR を準備する

この機能を使用するには、最初にデータファクトリを作成し、その中に Azure-SSIS IR を設定します。まだ行っていない場合は、Azure-SSIS IR の設定に関する手順に従ってください。

次に、Azure-SSIS IR が設定されているのと同じデータファクトリで、セルフホステッド IR を設定します。これを行うには、セルフホステッド IR の作成に関する記事を参照してください。

最後に、次のように、オンプレミスのマシンまたは Azure 仮想マシン (VM) に、セルフホステッド IR の最新バージョン、および追加のドライバーとランタイムをダウンロードしてインストールします。

セルフホステッド IR の最新バージョンをダウンロードしてインストールします。
セルフホステッド IR のバージョンが 5.28.0 以降の場合、セルフホステッド統合ランタイムノードで SSIS パッケージの実行を有効にします。

ExecuteSsisPackage プロパティは、セルフホステッド IR バージョン 5.28.0 から新たに導入されました。 SSIS パッケージの実行を有効または無効にするには、次のセルフホステッド IR コマンドラインアクションを使います。
- -EnableExecuteSsisPackage: セルフホステッド IR ノード上で SSIS パッケージの実行を有効にします。
- -DisableExecuteSsisPackage: セルフホステッド IR ノード上で SSIS パッケージの実行を無効にします。
- -GetExecuteSsisPackage
セルフホステッド IR コマンドラインの詳細については、「ローカル PowerShell を使用して既存のセルフホステッド IR をセットアップする」を参照してください。

バージョン 5.28.0 以降を使って新しくインストールしたセルフホステッド IR ノードの ExecuteSsisPackage プロパティは既定で無効です。

バージョン 5.28.0 以降に更新された既存のセルフホステッド IR ノードの場合、ExecuteSsisPackage プロパティは既定で有効です。
パッケージでオブジェクトのリンクと埋め込みデータベース (OLE DB)、Open Database Connectivity (ODBC)、または ADO.NET コネクタを使用する場合は、セルフホステッド IR がインストールされている同じコンピューターに、関連するドライバーをダウンロードしてインストールしてください (まだ行っていない場合)。

SQL Server 用の OLEDB ドライバーの以前のバージョン (SQL Server Native Client (SQLNCLI)) を使用する場合は、64 ビット版をダウンロードします。

SQL Server 用の OLEDB ドライバーの最新バージョン (MSOLEDBSQL) を使用する場合は、64 ビット版をダウンロードします。

PostgreSQL、MySQL、Oracle などの他のデータベースシステム用の OLEDB/ODBC/ADO.NET ドライバーを使用する場合は、それらの Web サイトから 64 ビット版をダウンロードできます。
パッケージで Azure Feature Pack のデータフローコンポーネントを使用する場合は、セルフホステッド IR がインストールされているのと同じマシンに SQL Server 2017 用の Azure Feature Pack をダウンロードしてインストールします (まだインストールしていない場合)。
セルフホステッド IR がインストールされているのと同じコンピューターに、64 ビット版の Visual C++ (VC) ランタイムをダウンロードしてインストールします (まだ行っていない場合)。

オンプレミスのタスクで Windows 認証を有効にする

セルフホステッド IR 上のオンプレミスのステージングタスクと、SQL およびプロセス実行タスクが Windows 認証を必要とする場合は、Azure-SSIS IR で windows 認証機能も構成する必要があります。

オンプレミスのステージングタスクと、SQL およびプロセス実行タスクは、セルフホステッド IR サービスアカウント (既定では NT SERVICE\DIAHostService) を使用して起動し、データストアには Windows 認証アカウントを使用してアクセスします。どちらのアカウントにも、特定のセキュリティポリシーが割り当てられている必要があります。セルフホステッド IR コンピューターで、 [ローカルセキュリティポリシー]>[ローカルポリシー]>[ユーザー権利の割り当て] を選択し、次の操作を行います。

[プロセスのメモリクォータの増加] ポリシーと [プロセスレベルトークンの置き換え] ポリシーをセルフホステッド IR サービスアカウントに割り当てます。これは、既定のサービスアカウントを使用してセルフホステッド IR をインストールするときに自動的に実行されます。そうでない場合は、手動でこれらのポリシーを割り当てます。別のサービスアカウントを使用する場合は、同じポリシーを割り当てます。
[サービスとしてログオン] ポリシーを Windows 認証アカウントに割り当てます。

Azure Blob Storage のリンクされたサービスをステージング用に準備する

Azure Blob Storage のリンクされたサービスを、Azure-SSIS IR が設定されているのと同じデータファクトリに作成します (まだそうしていない場合)。これを行うには、Azure Data Factory のリンクされたサービスの作成に関する記事を参照してください。次のことを行ってください。

[データソース] で [Azure Blob Storage] を選択します。
統合ランタイム経由で接続する場合は、Azure Blob Storage のアクセス資格情報を取り込むために Azure-SSIS IR を使うのでなく、(Azure-SSIS IR でもセルフホステッド IR でもなく) AutoResolveIntegrationRuntime を選択します。
[認証方法] で、 [アカウントキー] 、 [SAS URI] 、 [サービスプリンシパル] 、 [マネージド ID] 、または [ユーザー割り当てマネージド ID] を選択します。

ヒント

データファクトリインスタンスが Git 対応の場合、キー認証のないリンクサービスはすぐには発行されません。つまり、feature-branch のリンクサービスに依存する統合ランタイムを保存することはできません。アカウントキーまたは SAS URI を使用して認証すると、リンクサービスが直ちに発行されます。

ヒント

サービスプリンシパル方法を選択した場合は、サービスプリンシパルに少なくともストレージ BLOB データ共同作成者のロールを付与します。詳細については、「Azure Blob Storage コネクタ」をご覧ください。 [マネージド ID]/[ユーザー割り当てマネージド ID] の方式を選択した場合は、ADF の指定のシステムまたはユーザー割り当てマネージド ID に、Azure Blob Storage にアクセスするための適切なロールを付与します。詳細については、ADF の指定のシステムまたはユーザー割り当てマネージド ID で、Microsoft Entra 認証を使用して Azure Blob Storage にアクセスする方法に関するページをご覧ください。

Azure Blob Storage のリンクされたサービスをステージング用に準備する

セルフホステッド IR をプロキシとして使用して Azure-SSIS IR を構成する

セルフホステッド IR と Azure Blob Storage のリンクサービスをステージング用に準備したので、次にデータファクトリポータルまたはアプリでセルフホステッド IR をプロキシとして使用して、新規または既存の Azure-SSIS IR を構成することができます。ただし、上記を実行する前に、既存の Azure-SSIS IR が実行されている場合は、これを停止し、後で再起動してください。

[統合ランタイムのセットアップ] ペインで、 [続行] ボタンを選択して、 [全般設定] と [デプロイ設定] ページをスキップします。
[詳細設定] ページで、次の手順を実行します。
1. [Set up Self-Hosted Integration Runtime as a proxy for your Azure-SSIS Integration Runtime](セルフホステッド IR を Azure-SSIS 統合ランタイムのプロキシとして設定する) チェックボックスをオンにします。
2. [Self-Hosted Integration Runtime](セルフホステッド統合ランタイム) ドロップダウンリストで、既存のセルフホステッド IR を Azure-SSIS IR のプロキシとして選択します。
3. [ステージングストレージのリンクサービス] ドロップダウンリストで、既存の Azure BLOB ストレージのリンクサービスを選択するか、またはステージング用の新しいリンクサービスを作成します。
4. [ステージングパス] ボックスで、選択した Azure ストレージアカウント内の BLOB コンテナーを指定するか、またはこれを空のままにしてステージング用の既定のパスを使用します。
5. [Continue](続行) を選択します。

また、PowerShell を使用し、セルフホステッド IR をプロキシとして使用して新規または既存の Azure-SSIS IR を構成することもできます。

$ResourceGroupName = "[your Azure resource group name]"
$DataFactoryName = "[your data factory name]"
$AzureSSISName = "[your Azure-SSIS IR name]"
# Self-hosted integration runtime info - This can be configured as a proxy for on-premises data access 
$DataProxyIntegrationRuntimeName = "" # OPTIONAL to configure a proxy for on-premises data access 
$DataProxyStagingLinkedServiceName = "" # OPTIONAL to configure a proxy for on-premises data access 
$DataProxyStagingPath = "" # OPTIONAL to configure a proxy for on-premises data access 

# Add self-hosted integration runtime parameters if you configure a proxy for on-premises data access
if(![string]::IsNullOrEmpty($DataProxyIntegrationRuntimeName) -and ![string]::IsNullOrEmpty($DataProxyStagingLinkedServiceName))
{
    Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
        -DataFactoryName $DataFactoryName `
        -Name $AzureSSISName `
        -DataProxyIntegrationRuntimeName $DataProxyIntegrationRuntimeName `
        -DataProxyStagingLinkedServiceName $DataProxyStagingLinkedServiceName

    if(![string]::IsNullOrEmpty($DataProxyStagingPath))
    {
        Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
            -DataFactoryName $DataFactoryName `
            -Name $AzureSSISName `
            -DataProxyStagingPath $DataProxyStagingPath
    }
}
Start-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
    -DataFactoryName $DataFactoryName `
    -Name $AzureSSISName `
    -Force

SSIS パッケージでプロキシを使用できるようにする

最新の SSDT を Visual Studio の SSIS Projects 拡張機能またはスタンドアロンのインストーラのいずれかとして使用すると、サポートされているデータフローコンポーネントの接続マネージャーでは新しい ConnectByProxy プロパティを、SQL およびプロセス実行タスクでは ExecuteOnProxy プロパティを見つけることができます。

オンプレミスでデータにアクセスするコンポーネントを持つデータフロータスクを含む新しいパッケージを設計する場合、ConnectByProxy プロパティを有効にするには、関連する接続マネージャーの [プロパティ] ウィンドウでこれを "True" に設定します。

オンプレミスで実行する SQL およびプロセス実行タスクを含む新しいパッケージを設計する場合、ExecuteOnProxy プロパティを有効にするには、関連するタスク自身の [プロパティ] ペインでこれを True に設定します。

ConnectByProxy および ExecuteOnProxy プロパティを有効にする

また、既存のパッケージを実行する場合も、それらを 1 つずつ手動で変更することなく、ConnectByProxy/ExecuteOnProxy プロパティを有効にできます。 2 つのオプションがあります。

オプション A: Azure-SSIS IR で実行する、最新の SSDT を備えたこれらのパッケージを含むプロジェクトを開いて、再構築し、再デプロイする。 SSMS からパッケージを実行するときに [パッケージの実行] ポップアップウィンドウの [接続マネージャー] タブに表示される、関連する接続マネージャーに対して True に設定することで ConnectByProxy プロパティを有効にできます。

また、Data Factory パイプラインでパッケージを実行するときに SSIS パッケージの実行アクティビティの [接続マネージャー] タブに表示される、関連する接続マネージャーに対して True に設定することで ConnectByProxy プロパティを有効にできます。
オプション B: SSIS IR で実行するこれらのパッケージを含むプロジェクトを再デプロイする。次に、プロパティパス \Package.Connections[YourConnectionManagerName].Properties[ConnectByProxy]/\Package\YourExecuteSQLTaskName.Properties[ExecuteOnProxy]/\Package\YourExecuteProcessTaskName.Properties[ExecuteOnProxy] を指定し、SSMS からパッケージを実行するときに [パッケージの実行] ポップアップウィンドウの [詳細] タブでプロパティオーバーライドとして True に設定することで ConnectByProxy/ExecuteOnProxy プロパティを有効にできます。

また、プロパティパス \Package.Connections[YourConnectionManagerName].Properties[ConnectByProxy]/\Package\YourExecuteSQLTaskName.Properties[ExecuteOnProxy]/\Package\YourExecuteProcessTaskName.Properties[ExecuteOnProxy] を指定し、Data Factory パイプラインでパッケージを実行するときに SSIS パッケージ実行アクティビティの [プロパティのオーバーライド] タブでプロパティオーバーライドとして True に設定することで ConnectByProxy/ExecuteOnProxy プロパティを有効にできます。

オンプレミスタスクとクラウドのステージングタスクをデバッグする

セルフホステッド IR では、ランタイムログは C:\ProgramData\SSISTelemetry フォルダー内にあり、オンプレミスのステージングタスクと、SQL およびプロセス実行タスクの実行ログは C:\ProgramData\SSISTelemetry\ExecutionLog フォルダー内にあります。クラウドにあるステージングタスクの実行ログは、パッケージを格納した場所が SSISDB であるかどうかや、Azure Monitor の統合などを有効にするかどうかに応じて、SSISDB 内、指定されたロギングファイルパス、または Azure Monitor にあります。オンプレミスのステージングタスクの一意の ID も、クラウドにあるステージングタスクの実行ログ内にあります。

1 番目のステージングタスクの一意の ID

カスタマーサポートチケットを発行した場合は、セルフホステッド IR にインストールされている Microsoft Integration Runtime Configuration Manager の [診断] タブで [ログの送信] ボタンを選択して、最近の操作/実行ログを調査対象として送信できます。

オンプレミスタスクとクラウドのステージングタスクの請求

セルフホステッド IR で実行されるオンプレミスのステージングタスクと SQL およびプロセス実行タスクは、セルフホステッド IR で実行されるあらゆるデータ移動アクティビティが課金されるのと同じように、個別に課金されます。これは、Azure Data Factory データパイプラインの価格に関するページに記載されています。

Azure-SSIS IR で実行されるクラウドにあるステージングタスクは個別に課金されませんが、実行中の Azure-SSIS IR は、Azure-SSIS IR の価格に関する記事の指定どおりに課金されます。

TLS 1.2 を適用する

最も強力な暗号化や、最も安全なネットワークプロトコル (TLS 1.2) のみを使用するように構成されている、ステージング用の Azure Blob Storage などのデータストアにアクセスする必要がある場合は、セルフホステッド IR で TLS 1.2 のみを有効にし、古い SSL/TLS バージョンは同時に無効にする必要があります。これを行うには、https://github.com/Azure/Azure-DataFactory/tree/main/SamplesV2/SQLServerIntegrationServices/publicpreview/CustomSetupScript/UserScenarios/TLS%201.2 から main.cmd スクリプトをダウンロードして実行します。

現在の制限

現在、Hadoop/HDFS/DQS コンポーネントを除き、Azure-SSIS IR Standard Edition に組み込まれているか、事前にインストールされているデータフローコンポーネントのみがサポートされています。Azure-SSIS IR に組み込まれているか、事前にインストールされているすべてのコンポーネントに関するページをご覧ください。
現在、マネージドコード (.NET Framework) で記述されたカスタム/サードパーティのデータフローコンポーネントのみがサポートされています。ネイティブコード (C++) で記述されたコンポーネントは、現在サポートされていません。
オンプレミスとクラウドの両方のステージングタスクで変数値を変更することは、現在サポートされていません。
オンプレミスのステージングタスクでオブジェクト型の変数値を変更しても、他のタスクには反映されません。
OLEDB ソースの ParameterMapping は現在サポートされていません。回避策として、AccessMode として変数からの SQL コマンドを使用し、式を使用して SQL コマンドに変数やパラメーターを挿入してください。図のように、パブリックプレビュー BLOB コンテナーの SelfHostedIRProxy/Limitations フォルダーに置かれた ParameterMappingSample.dtsx パッケージを参照してください。 Azure Storage Explorer を使用して、上の SAS URI を入力することで、パブリックプレビュー BLOB コンテナーに接続できます。

セルフホステッド IR を Azure-SSIS IR のプロキシとして構成したら、Data Factory パイプラインの SSIS パッケージ実行アクティビティとしてパッケージをデプロイおよび実行して、オンプレミスでデータにアクセスしたり SQL ステートメントやプロセスを実行したりできます。方法については、Data Factory パイプラインの SSIS パッケージ実行アクティビティとしての SSIS パッケージの実行に関する記事を参照してください。ブログ「Azure Data Factory の SSIS を使用して、3 つの簡単な手順で任意の場所で任意の SQL を実行する」および「Azure Data Factory で SSIS を使用して、3 つの簡単なステップで任意の場所で任意のプロセスを実行する」も参照してください。

次の方法で共有

セルフホステッド IR を Azure-SSIS IR のプロキシとして構成する

セルフホステッド IR を準備する

オンプレミスのタスクで Windows 認証を有効にする

Azure Blob Storage のリンクされたサービスをステージング用に準備する

セルフホステッド IR をプロキシとして使用して Azure-SSIS IR を構成する

SSIS パッケージでプロキシを使用できるようにする

オンプレミスタスクとクラウドのステージングタスクをデバッグする

オンプレミスタスクとクラウドのステージングタスクの請求

TLS 1.2 を適用する

現在の制限

フィードバック

その他のリソース

次の方法で共有

セルフホステッド IR を Azure-SSIS IR のプロキシとして構成する

セルフホステッド IR を準備する

オンプレミスのタスクで Windows 認証を有効にする

Azure Blob Storage のリンクされたサービスをステージング用に準備する

セルフホステッド IR をプロキシとして使用して Azure-SSIS IR を構成する

SSIS パッケージでプロキシを使用できるようにする

オンプレミス タスクとクラウドのステージング タスクをデバッグする

オンプレミス タスクとクラウドのステージング タスクの請求

TLS 1.2 を適用する

現在の制限

関連するコンテンツ

フィードバック

その他のリソース

オンプレミスタスクとクラウドのステージングタスクをデバッグする

オンプレミスタスクとクラウドのステージングタスクの請求