Erstellen einer freigegebenen selbst gehosteten Integrationslaufzeit in Azure Data Factory

Gilt für: Azure Data Factory Azure Synapse Analytics

In diesem Handbuch erfahren Sie, wie Sie eine freigegebene selbst gehostete Integrationslaufzeit in Azure Data Factory erstellen. Anschließend können Sie die freigegebene, selbstgehostete Integration Runtime in einer anderen Data Factory verwenden.

Erstellen einer freigegebenen selbst gehosteten Integrationslaufzeit in Azure Data Factory

Sie können eine vorhandene selbstgehostete Integration Runtime-Infrastruktur wiederverwenden, die Sie bereits in einer Data Factory eingerichtet haben. Durch diese Wiederverwendung können Sie eine verknüpfte selbstgehostete Integration Runtime in einer anderen Data Factory erstellen, indem Sie auf eine vorhandene freigegebene selbstgehostete IR verweisen.

Sehen Sie sich das folgende zwölfminütige Video an, um eine Einführung und Demonstration dieses Features zu erhalten:

Begriff

• Shared IR: Eine eigenständige selbstgehostete IR, die auf einer physischen Infrastruktur ausgeführt wird.
• Verknüpfte IR: Eine IR, die auf eine andere freigegebene IR verweist. Diese verknüpfte IR ist eine logische IR. Sie nutzt die Infrastruktur einer anderen freigegebenen selbstgehosteten IR.

Erstellen einer freigegebenen selbstgehosteten IR über die Azure Data Factory-Benutzeroberfläche

Zum Erstellen einer freigegebenen, selbst gehosteten IR mithilfe der Azure Data Factory-Benutzeroberfläche können Sie die folgenden Schritte ausführen:

1. Wählen Sie in der freizugebenden selbstgehosteten Integration Runtime die Option Anderen Data Factory die Berechtigung erteilen, und wählen Sie auf der Seite „Integration Runtime-Setup“ die Data Factory aus, in der Sie die verknüpfte Integration Runtime erstellen möchten.

   

2. Notieren und kopieren Sie die obige „Ressourcen-ID“ der freizugebenden selbstgehosteten IR.

3. Erstellen Sie in der Data Factory, für die Berechtigungen erteilt wurden, eine neue selbstgehostete IR (verknüpft), und geben Sie die Ressourcen-ID ein.

   

   

   

Erstellen Sie eine freigegebene, selbst gehostete IR mit Azure PowerShell.

Sie können die unten angegebenen Schritte ausführen, um mithilfe von Azure PowerShell eine freigegebene selbstgehostete IR zu erstellen.

1. Erstellen einer Data Factory.
2. Erstellen Sie eine selbstgehostete Integration Runtime.
3. Freigeben der selbstgehosteten Integration Runtime für andere Data Factorys.
4. Erstellen einer verknüpften Integration Runtime.
5. Aufheben der Freigabe.

Voraussetzungen

• Azure-Abonnement. Wenn Sie nicht über ein Azure-Abonnement verfügen, erstellen Sie ein kostenloses Konto bevor Sie beginnen.

• Azure PowerShell. Folgen Sie den Anweisungen in Install Azure PowerShell auf Windows mit PowerShellGet. Verwenden Sie PowerShell zum Ausführen eines Skripts, um eine selbstgehostete Integration Runtime zu erstellen, die für andere Data Factorys freigegeben werden kann.

Erstellen einer Data Factory

1. Starten Sie die Windows integrierte PowerShell-Skriptingumgebung (ISE).

2. Erstellen Sie Variablen. Kopieren und fügen Sie das folgende Skript ein. Ersetzen Sie Variablen wie SubscriptionName und ResourceGroupName durch tatsächliche Werte:

   # 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]"
   

3. Melden Sie sich an, und wählen Sie ein Abonnement aus. Fügen Sie dem Skript den folgenden Code hinzu, um sich anzumelden, und wählen Sie Ihr Azure Abonnement aus:

   Connect-AzAccount
   Select-AzSubscription -SubscriptionName $SubscriptionName
   

4. Erstellen Sie eine Ressourcengruppe und eine Data Factory.

   Hinweis

   Dieser Schritt ist optional. Wenn Sie bereits eine Data Factory verwenden, überspringen Sie diesen Schritt.

   Erstellen Sie eine Azure-Ressourcengruppe mithilfe des Befehls New-AzResourceGroup. Eine Ressourcengruppe ist ein logischer Container, in dem Azure Ressourcen als Gruppe bereitgestellt und verwaltet werden. Im folgenden Beispiel wird eine Ressourcengruppe mit dem Namen myResourceGroup am Standort „WestEurope“ erstellt:

   New-AzResourceGroup -Location $DataFactoryLocation -Name $ResourceGroupName
   

   Führen Sie den folgenden Befehl aus, um eine Data Factory zu erstellen:

   Set-AzDataFactoryV2 -ResourceGroupName $ResourceGroupName `
                            -Location $DataFactoryLocation `
                            -Name $SharedDataFactoryName
   

Erstellen einer selbstgehosteten Integration Runtime

Führen Sie den folgenden Befehl aus, um eine selbstgehostete Integration Runtime zu erstellen:

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

Integration Runtime-Authentifizierungsschlüssel abrufen und einen Knoten registrieren

Führen Sie den folgenden Befehl aus, um den Authentifizierungsschlüssel für die selbstgehostete Integration Runtime abzurufen:

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

Die Antwort enthält den Authentifizierungsschlüssel für diese selbstgehostete Integration Runtime. Verwenden Sie diesen Schlüssel beim Registrieren des Integration Runtime-Knotens.

Installieren und Registrieren der selbstgehosteten Integration Runtime

1. Laden Sie den selbstgehosteten Integration Runtime-Installer von Azure Data Factory Integration Runtime herunter.

2. Führen Sie den Installer aus, um die selbstgehostete Integration auf einem lokalen Computer zu installieren.

3. Registrieren Sie die neue selbstgehostete Integration mithilfe des Authentifizierungsschlüssels, den Sie in einem vorherigen Schritt abgerufen haben.

Freigeben der selbstgehosteten Integration Runtime für eine andere Data Factory

Erstellen einer anderen Data Factory

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

Berechtigung erteilen

Erteilen Sie die Berechtigung für die Data Factory, die auf die selbstgehostete Integration Runtime zugreifen muss, die Sie erstellt und registriert haben.

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

Erstellen einer verknüpften, selbstgehosteten Integration Runtime

Führen Sie den folgenden Befehl aus, um eine verknüpfte, selbstgehostete Integration Runtime zu erstellen:

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

Jetzt können Sie diese verknüpften Integration Runtime in einem beliebigen verknüpften Dienst verwenden. Die verknüpfte Integration Runtime verwendet die freigegebene Integration Runtime, um Aktivitäten auszuführen.

Aufheben der Freigabe der Integration Runtime über eine Data Factory

Um den Zugriff einer Data Factory auf die freigegebene Integration Runtime aufzuheben, führen Sie den folgenden Befehl aus:

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

Um die vorhandenen verknüpfte Integration Runtime zu entfernen, führen Sie den folgenden Befehl für die freigegebene Integration Runtime aus:

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

Überwachung

Freigegebene IR

Verknüpfte Infrarot

Bekannte Einschränkungen der Freigabe selbstgehosteter IRs

• Die Data Factory, in der eine verknüpfte IR erstellt wird, muss über eine verwaltete Identität verfügen. Standardmäßig verfügen die im Azure Portal oder PowerShell-Cmdlets erstellten Datenfabriken über eine implizit erstellte verwaltete Identität. Wenn jedoch eine Datenfactory über eine Azure Resource Manager Vorlage oder ein SDK erstellt wird, müssen Sie die Eigenschaft Identity explizit festlegen. Diese Einstellung stellt sicher, dass der Resource Manager eine Datenfabrik erstellt, die eine Verwaltete Identität enthält.

• Das Data Factory .NET SDK, das dieses Feature unterstützt, muss Version 1.1.0 oder höher sein.

• Zum Gewähren von Berechtigungen müssen Sie über die Rolle „Besitzer“ oder die geerbte Rolle „Besitzer“ in der Data Factory verfügen, in der die freigegebene IR vorhanden ist.

• Das Freigabefeature funktioniert nur für Data Factorys innerhalb des gleichen Microsoft Entra-Mandanten.

• Für Microsoft Entra ID Gastbenutzer funktioniert die Suchfunktionalität in der Benutzeroberfläche nicht, in der alle Datenfabriken mit einem Suchbegriff aufgelistet werden. Aber sofern der Gastbenutzer der Besitzer der Data Factory ist, können Sie die IR ohne Suchfunktion freigeben. Geben Sie für die verwaltete Identität der Data Factory, für die die IR freigegeben werden muss, diese verwaltete Identität in das Feld Berechtigung zuweisen ein. Wählen Sie auf der Data Factory-Benutzeroberfläche Hinzufügen aus.

  Hinweis

  Dieses Feature steht nur in Data Factory V2 zur Verfügung.

Zugehöriger Inhalt

• Überprüfen Sie integrationslaufzeitkonzepte in Azure Data Factory.

• Erfahren Sie, wie Sie eine selbst gehostete Integrationslaufzeit im Azure Portal erstellen.