在 Azure Data Factory 中建立共用的自我裝載整合執行階段

適用於：Azure Data Factory Azure Synapse Analytics

本指南說明如何在 Azure Data Factory 中建立共用的自我裝載整合執行階段。 然後您可以在其他資料處理站中，使用該共用的自我裝載整合執行階段。

在 Azure Data Factory 中建立共用的自我裝載整合執行階段

您可以重複使用您已經在資料處理站中設定的現有自我裝載整合執行階段基礎結構。 此重複使用可讓您藉由參考現有的共用自我裝載 IR，在不同的資料處理站中建立連結的自我裝載整合執行階段。

若要查看此功能的簡介與示範，請觀看下列 12 分鐘影片：

詞彙

• 共用 IR：在實體基礎結構上執行的原始自我裝載 IR。
• 連結的 IR：參考另一個共用 IR 的 IR。 連結的 IR 是邏輯 IR，並使用另一個共用自我裝載 IR 的基礎結構。

使用 Azure Data Factory UI 建立共用的自我裝載 IR

若要使用 Azure Data Factory UI 建立共用的自我裝載 IR，您可採取下列步驟：

1. 在要共用的自我裝載 IR 中，選取 [將權限授與另一個資料處理站]，然後在 [整合執行階段設定] 頁面中，選取您要在其中建立連結 IR 的資料處理站。

   

2. 請記下並複製要共用的自我裝載 IR 的上述「資源識別碼」。

3. 在已授與權限的資料處理站中，建立新的自我裝載 IR (已連結) 並輸入資源識別碼。

   

   

   

使用 Azure PowerShell 建立共用的自我裝載 IR

若要使用 Azure PowerShell 建立共用的自我裝載 IR，您可採取下列步驟：

1. 建立資料處理站。
2. 建立自我裝載整合執行階段。
3. 與其他資料處理站共用該自我裝載整合執行階段。
4. 建立連結的整合執行階段。
5. 撤銷共用。

必要條件

• Azure 訂用帳戶。 如尚未擁有 Azure 訂用帳戶，請在開始之前先建立免費帳戶。

• Azure PowerShell。 請依照使用 PowerShellGet 在 Windows 上安裝 Azure PowerShell 中的指示操作。 您會使用 PowerShell 來執行指令碼，以建立可與其他資料處理站共用的自我裝載整合執行階段。

建立資料處理站

1. 啟動 Windows PowerShell 整合式指令碼環境 (ISE)。

2. 建立變數。 複製並貼上下列指令碼。 請將變數 (例如 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]"
   

3. 登入並選取訂用帳戶。 將下列程式碼新增至指令碼，以登入並選取 Azure 訂用帳戶：

   Connect-AzAccount
   Select-AzSubscription -SubscriptionName $SubscriptionName
   

4. 建立資源群組和資料處理站。

   注意

   此步驟是選擇性的。 如果您已經有資料處理站，請略過此步驟。

   使用 New-AzResourceGroup 命令來建立 Azure 資源群組。 資源群組是在其中以群組方式部署與管理 Azure 資源的邏輯容器。 下列範例會在 WestEurope 位置建立名為 myResourceGroup 的資源群組：

   New-AzResourceGroup -Location $DataFactoryLocation -Name $ResourceGroupName
   

   執行下列命令來建立資料處理站：

   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

回應會包含此自我裝載整合執行階段的驗證金鑰。 當您註冊整合執行階段節點時，會使用此金鑰。

安裝和註冊自我裝載整合執行階段

1. 從 Azure Data Factory Integration Runtime 下載自我裝載整合執行階段安裝程式。

2. 執行安裝程式，以在本機電腦上安裝自我裝載整合。

3. 使用您在上一步中擷取的驗證金鑰，註冊新的自我裝載整合。

與另一個資料處理站共用該自我裝載整合執行階段

建立另一個資料處理站

$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 的資料處理站必須具有受控識別。 依預設，在 Azure 入口網站或 PowerShell Cmdlet 中建立的資料處理站具有隱含建立的 MSI。 但是，當透過 Azure Resource Manager 範本或 SDK 建立資料處理站時，您必須明確設定識別屬性。 此設定確保 Resource Manager 建立一個包含受控識別的資料處理站。

• 支援這項功能的 Data Factory .NET SDK 必須是 1.1.0 版或更新版本。

• 為了授與權限，您需要在共用 IR 所在的資料處理站中具備「擁有者」角色或繼承的「擁有者」角色。

• 共用功能只適用於相同 Microsoft Entra 租用戶內的資料處理站。

• 對於 Microsoft Entra ID 來賓使用者，UI 中使用搜尋關鍵字列出所有資料處理站的搜尋功能無法運作。 但是，只要來賓使用者是資料處理站的擁有者，您就可以在沒有搜尋功能的情況下共用 IR。 針對需要共用 IR 的資料處理站的受控識別，請在 [指派權限] 方塊中輸入該受控識別，然後選取 Data Factory UI 中的 [新增 ]。

  注意

  這項功能僅適用於 Data Factory 第 2 版。

相關內容

• 檢閱 Azure Data Factory 中的整合執行階段概念。

• 了解如何在 Azure 入口網站中建立自我裝載整合執行階段。