Azure Data Factoryで共有セルフホステッド統合ランタイムを作成する

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

Data Factory in Microsoft Fabric は、よりシンプルなアーキテクチャ、組み込みの AI、および新機能を備えた次世代のAzure Data Factoryです。データ統合を初めて使用する場合は、Fabric Data Factory から始めます。既存の ADF ワークロードをFabricにアップグレードして、データサイエンス、リアルタイム分析、レポートの新機能にアクセスできます。

Fabric無料試用版を開始します。
Azure Data Factory から Microsoft Fabric の Data Factory へのアップグレード

このガイドでは、Azure Data Factoryで共有セルフホステッド統合ランタイムを作成する方法について説明します。これにより、共有のセルフホステッド統合ランタイムを他のデータファクトリで使用できます。

注意

セルフホステッド統合ランタイムを共有するデータファクトリが増加すると、ワークロードが増加し、キュー時間が長くなることがあります。キュー時間が過度に長くなる場合、ノードをスケールアップしたり、ノードを追加してスケールアウトしたりできます。最大 4 ノードまで追加できます。

Azure Data Factoryで共有セルフホステッド統合ランタイムを作成する

データファクトリに既に設定してある既存のセルフホステッド統合ランタイムインフラストラクチャを再利用することができます。この再利用により、共有された既存のセルフホステッド IR を参照して、異なるデータファクトリにリンクされたセルフホステッド統合ランタイムを作成できます。

この機能の概要とデモンストレーションを参照するには、以下の 12 分間の動画を視聴してください。

用語

共有された IR:物理インフラストラクチャで実行されている元のセルフホステッド IR。
リンクされた IR:別の共有された IR を参照する IR。リンクされた IR は論理 IR であり、共有された別のセルフホステッド IR のインフラストラクチャを使用します。

Azure Data Factory UI を使用して共有セルフホステッド IR を作成する

Azure Data Factory UI を使用して共有セルフホステッド IR を作成するには、次の手順を実行します。

共有されるセルフホステッド IR で、 [別のデータファクトリにアクセス許可を付与] を選択し、[統合ランタイムのセットアップ] ページで、リンクされた IR を作成するデータファクトリを選択します。
上記の共有されるセルフホステッド IR の "リソース ID" に注目してコピーしておきます。
アクセス許可が付与されたデータファクトリで、新しいセルフホステッド IR (リンク) を作成して、リソース ID を入力します。

Azure PowerShellを使用して共有セルフホステッド IR を作成する

Azure PowerShellを使用して共有セルフホステッド IR を作成するには、次の手順を実行します。

データファクトリを作成します。
セルフホステッド統合ランタイムを作成します。
セルフホステッド統合ランタイムを他のデータファクトリと共有します。
リンクされた統合ランタイムを作成します。
共有を取り消します。

前提条件

注意

Azure Az PowerShell モジュールを使用してAzureを操作することをお勧めします。作業を開始するには、「Install Azure PowerShellを参照してください。 Az PowerShell モジュールに移行する方法については、「AzRM から Azを参照してください。

Azure サブスクリプション。 Azureサブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。
Azure PowerShell。 PowerShellGet を使用してWindowsにAzure PowerShellをインストールするの手順に従います。 PowerShell を使用してスクリプトを実行し、他のデータファクトリと共有できるセルフホステッド統合ランタイムを作成できます。

注意

Data Factory が現在使用できるAzureリージョンの一覧については、リージョン別に利用可能な製品で関心のあるリージョンを選択します。

Data Factory の作成

Windows PowerShell 統合スクリプト環境 (ISE) を起動します。

変数を作成します。次のスクリプトをコピーして貼り付けます。 SubscriptionName や ResourceGroupName などの変数を実際の値に置き換えます。

# If input contains a PSH special character, e.g. "$", precede it with the escape character "`" like "`$". 
$SubscriptionName = "[Azure subscription name]" 
$ResourceGroupName = "[Azure resource group name]" 
$DataFactoryLocation = "EastUS" 

# Shared Self-hosted integration runtime information. This is a Data Factory compute resource for running any activities 
# Data factory name. Must be globally unique 
$SharedDataFactoryName = "[Shared Data factory name]" 
$SharedIntegrationRuntimeName = "[Shared Integration Runtime Name]" 
$SharedIntegrationRuntimeDescription = "[Description for Shared Integration Runtime]"

# Linked integration runtime information. This is a Data Factory compute resource for running any activities
# Data factory name. Must be globally unique
$LinkedDataFactoryName = "[Linked Data factory name]"
$LinkedIntegrationRuntimeName = "[Linked Integration Runtime Name]"
$LinkedIntegrationRuntimeDescription = "[Description for Linked Integration Runtime]"

サインインしてサブスクリプションを選択します。次のコードをスクリプトに追加してサインインし、Azure サブスクリプションを選択します。
```
Connect-AzAccount
Select-AzSubscription -SubscriptionName $SubscriptionName
```
リソースグループとデータファクトリを作成します。

注意

この手順は省略可能です。既にデータファクトリがある場合は、この手順をスキップしてください。

Azure リソースグループを作成するには、New-AzResourceGroup コマンドを使用します。リソースグループは、Azure リソースがグループとしてデプロイおよび管理される論理コンテナーです。次の例では、myResourceGroup という名前のリソースグループを WestEurope の場所に作成します。
```
New-AzResourceGroup -Location $DataFactoryLocation -Name $ResourceGroupName
```
Data Factory を作成するには、次のコマンドを実行します。
```
Set-AzDataFactoryV2 -ResourceGroupName $ResourceGroupName `
                         -Location $DataFactoryLocation `
                         -Name $SharedDataFactoryName
```

自己ホスト型統合ランタイムを作成する

注意

この手順は省略可能です。他のデータファクトリと共有するセルフホステッド統合ランタイムが既にある場合は、この手順をスキップしてください。

次のコマンドを実行して、セルフホステッド統合ランタイムを作成します。

$SharedIR = Set-AzDataFactoryV2IntegrationRuntime `
    -ResourceGroupName $ResourceGroupName `
    -DataFactoryName $SharedDataFactoryName `
    -Name $SharedIntegrationRuntimeName `
    -Type SelfHosted `
    -Description $SharedIntegrationRuntimeDescription

統合ランタイムの認証キーを取得してノードを登録する

次のコマンドを実行して、セルフホステッド統合ランタイムの認証キーを取得します。

Get-AzDataFactoryV2IntegrationRuntimeKey `
    -ResourceGroupName $ResourceGroupName `
    -DataFactoryName $SharedDataFactoryName `
    -Name $SharedIntegrationRuntimeName

応答には、このセルフホステッド統合ランタイムの認証キーが含まれています。このキーは、統合ランタイムノードを登録するときに使用します。

セルフホステッド統合ランタイムをインストールして登録する

セルフホスト型統合ランタイムインストーラーを Azure Data Factory Integration Runtime からダウンロードします。
インストーラーを実行して、セルフホステッド統合をローカルコンピューターにインストールします。
前の手順で取得した認証キーを使用して、新しいセルフホステッド統合を登録します。

別のデータファクトリを作成する

注意

この手順は省略可能です。共有先のデータファクトリが既にある場合は、この手順をスキップしてください。ただし、他のデータファクトリにロールの割り当てを追加または削除するには、Microsoft.Authorization/roleAssignments/write と Microsoft.Authorization/roleAssignments/delete アクセス許可 (ユーザーアクセス管理者、Owner が必要です。

$factory = Set-AzDataFactoryV2 -ResourceGroupName $ResourceGroupName `
    -Location $DataFactoryLocation `
    -Name $LinkedDataFactoryName

アクセス許可を付与する

作成して登録したセルフホステッド統合ランタイムにアクセスする必要があるデータファクトリに対してアクセス許可を付与します。

重要

この手順はスキップしないでください。

New-AzRoleAssignment `
    -ObjectId $factory.Identity.PrincipalId ` #MSI of the Data Factory with which it needs to be shared
    -RoleDefinitionName 'Contributor' `
    -Scope $SharedIR.Id

リンクされたセルフホステッド統合ランタイムを作成する

次のコマンドを実行して、リンクされたセルフホステッド統合ランタイムを作成します。

Set-AzDataFactoryV2IntegrationRuntime `
    -ResourceGroupName $ResourceGroupName `
    -DataFactoryName $LinkedDataFactoryName `
    -Name $LinkedIntegrationRuntimeName `
    -Type SelfHosted `
    -SharedIntegrationRuntimeResourceId $SharedIR.Id `
    -Description $LinkedIntegrationRuntimeDescription

これで、このリンクされた統合ランタイムを任意のリンクされたサービスで使用できます。リンクされた統合ランタイムでは、共有された統合ランタイムを使用してアクティビティを実行します。

共有された統合ランタイムからデータファクトリのアクセス権を取り消すには、次のコマンドを実行します。

Remove-AzRoleAssignment `
    -ObjectId $factory.Identity.PrincipalId `
    -RoleDefinitionName 'Contributor' `
    -Scope $SharedIR.Id

既存のリンクされた統合ランタイムを削除するには、共有された統合ランタイムに対して次のコマンドを実行します。

Remove-AzDataFactoryV2IntegrationRuntime `
    -ResourceGroupName $ResourceGroupName `
    -DataFactoryName $SharedDataFactoryName `
    -Name $SharedIntegrationRuntimeName `
    -LinkedDataFactoryName $LinkedDataFactoryName

監視

共有された IR:

共有された統合ランタイムを検索するための選択

共有された統合ランタイムを監視

リンクされたIR

リンクされた統合ランタイムを検索するための選択

リンクされた統合ランタイムを監視

リンクされた IR が作成されるデータファクトリには、マネージド ID が必要です。既定では、Azure ポータルまたは PowerShell コマンドレットで作成されたデータファクトリには、暗黙的に作成されたマネージド ID があります。ただし、Azure Resource Manager テンプレートまたは SDK を使用してデータファクトリを作成する場合は、Identity プロパティを明示的に設定する必要があります。この設定により、Resource Managerはマネージド ID を含むデータファクトリを作成できます。
この機能をサポートする Data Factory .NET SDK は、バージョン 1.1.0 以降である必要があります。
許可を与えるには、共有 IR が存在するデータファクトリにおいて、ユーザーが所有者のロールまたはその継承ロールを持っている必要があります。
共有機能は、同じMicrosoft Entra テナント内のデータファクトリに対してのみ機能します。
Microsoft Entra ID ユーザーでは、検索キーワードを使用してすべてのデータファクトリを一覧表示する UI の検索機能は機能しません。ただし、ゲストユーザーがデータファクトリの所有者である限り、検索機能を使用せずに IR を共有できます。 IR を共有する必要があるデータファクトリのマネージド ID について、 [アクセス許可の割り当て] ボックスにそのマネージド ID を入力し、Data Factory UI で [追加] を選択します。

注意

この機能は Data Factory V2 でのみ使用できます。

Azure Data Factory でインテグレーションランタイムの概念を確認します。
Azure ポータルでセルフホステッド統合ランタイムを作成する方法について説明します。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-04-07

次の方法で共有

Azure Data Factoryで共有セルフホステッド統合ランタイムを作成する

Azure Data Factoryで共有セルフホステッド統合ランタイムを作成する

用語

Azure Data Factory UI を使用して共有セルフホステッド IR を作成する

Azure PowerShellを使用して共有セルフホステッド IR を作成する

前提条件

Data Factory の作成

自己ホスト型統合ランタイムを作成する

統合ランタイムの認証キーを取得してノードを登録する

セルフホステッド統合ランタイムをインストールして登録する

セルフホステッド統合ランタイムを他のデータ ファクトリと共有する

別のデータ ファクトリを作成する

アクセス許可を付与する

リンクされたセルフホステッド統合ランタイムを作成する

データ ファクトリからの統合ランタイムの共有を取り消す

監視

共有された IR:

リンクされたIR

セルフホステッド IR の共有に関する既知の制限事項

関連するコンテンツ

フィードバック

その他のリソース

セルフホステッド統合ランタイムを他のデータファクトリと共有する

別のデータファクトリを作成する

データファクトリからの統合ランタイムの共有を取り消す