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

[アーティクル]
08/10/2023

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

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

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

Note

セルフホステッド統合ランタイムを共有するデータファクトリが増加すると、ワークロードが増加し、キュー時間が長くなることがあります。キュー時間が過度に長くなる場合、ノードをスケールアップしたり、ノードを追加してスケールアウトしたりできます。最大 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 を作成するには、次の手順を実行します。

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

前提条件

Note

Azure を操作するには、Azure Az PowerShell モジュールを使用することをお勧めします。作業を開始するには、Azure PowerShell のインストールに関する記事を参照してください。 Az PowerShell モジュールに移行する方法については、「AzureRM から Az への Azure PowerShell の移行」を参照してください。

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

Note

現在 Data Factory が利用できる Azure リージョンの一覧については、「リージョン別の利用可能な製品」ページで目的のリージョンを選択してください。

Data Factory の作成

Windows PowerShell Integrated Scripting Environment (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
```
リソースグループとデータファクトリを作成します。

Note

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

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

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

Note

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

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

$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」からダウンロードします。
インストーラーを実行して、セルフホステッド統合をローカルコンピューターにインストールします。
前の手順で取得した認証キーを使用して、新しいセルフホステッド統合を登録します。

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

Note

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

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

Note

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

Azure Data Factory の統合ランタイムの概念を確認します。
Azure portal でセルフホステッド統合ランタイムを作成する方法を調べます。

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

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

用語

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

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

前提条件

Data Factory の作成

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

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

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

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

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

アクセス許可を付与する

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

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

監視

共有された IR:

リンクされた IR:

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

関連するコンテンツ

その他のリソース

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

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

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