Создание общей локальной среды выполнения интеграции в Фабрике данных Azure

ОБЛАСТЬ ПРИМЕНЕНИЯ: Фабрика данных Azure Azure Synapse Analytics

В этом руководстве описывается создание общей локальной среды выполнения интеграции в Фабрике данных Azure. Общую локальную среду выполнения интеграции затем можно использовать в другой фабрике данных.

Создание общей локальной среды выполнения интеграции в Фабрике данных Azure

Вы можете повторно использовать существующую инфраструктуру локальной среды IR, которую вы уже настроили в фабрике данных. Это повторное использование позволяет создать связанную локальную среду выполнения интеграции в другой фабрике данных, ссылаясь на имеющуюся общую локальную среду выполнения интеграции.

Просмотрите следующее 12-минутное видео с кратким обзором и демонстрацией этой функции.

Терминология

• Общая среда выполнения интеграции – исходная локальная среда выполнения интеграции, работающая в физической инфраструктуре.
• Связанная среда выполнения интеграции – среда выполнения интеграции, которая ссылается на другую общую среду выполнения интеграции. Связанная среда выполнения интеграции является логической средой выполнения интеграции и использует инфраструктуру другой общей локальной среды выполнения интеграции.

Создание общей локальной среды выполнения интеграции с помощью пользовательского интерфейса Фабрики данных Azure

Чтобы создать общую локальную среду выполнения интеграции с помощью пользовательского интерфейса Фабрики данных Azure, можно выполнить следующие действия:

1. Для общей локальной среды выполнения интеграции выберите Предоставить разрешение для другой фабрики данных и на странице "Настройка среды выполнения интеграции" выберите фабрику данных, в которой необходимо создать связанную локальную среду выполнения интеграции.

   

2. Запишите и скопируйте приведенный выше "Идентификатор ресурса" локальной среды выполнения интеграции для общего использования.

3. В фабрике данных, которой были предоставлены разрешения, создайте новую локальную среду IR (связанную) и введите идентификатор ресурса.

   

   

   

Создание общей локальной среды выполнения интеграции с помощью Azure PowerShell

Чтобы создать общую локальную среду выполнения интеграции с помощью Azure PowerShell, можно выполнить следующие действия:

1. Создали фабрику данных.
2. Создание локальной среды выполнения интеграции.
3. Предоставьте общий доступ к локальной среде выполнения интеграции другим фабриками данных.
4. Создайте связанную среду выполнения интеграции.
5. Отмените общий доступ.

Предварительные требования

• Подписка Azure. Если у вас нет подписки Azure, создайте бесплатную учетную запись, прежде чем приступить к работе.

• Azure PowerShell. Выполните инструкции из руководства Install Azure PowerShell on Windows with PowerShellGet (Установка Azure PowerShell в Windows c помощью PowerShellGet). С помощью PowerShell выполните скрипт, чтобы создать локальную среду выполнения интеграции, которую можно использовать совместно с другими фабриками данных.

Создание фабрики данных

1. Откройте интегрированную среду сценариев (ISE) Windows PowerShell.

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. Создайте группу ресурсов и фабрику данных.

   Примечание.

   Этот шаг необязательный. Если у вас уже есть фабрика данных, пропустите этот шаг.

   Создайте группу ресурсов Azure с помощью команды New-AzResourceGroup. Группа ресурсов — это логический контейнер, в котором ресурсы Azure развертываются и администрируются как группа. В следующем примере создается группа ресурсов с именем myResourceGroup в расположении WestEurope.

   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. Скачайте установщик локальной среды выполнения интеграции из Integration Runtime Фабрики данных Azure.

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

• Фабрика данных, в которой создается связанная среда выполнения интеграции, должна иметь Управляемое удостоверение. По умолчанию фабрики данных, создаваемые на портале Azure или с помощью командлетов PowerShell, имеют управляемые удостоверения, генерируемые неявным образом. Но когда фабрика данных создается с помощью шаблона Azure Resource Manager или пакета SDK, необходимо явно задать свойство Удостоверение. Этот параметр гарантирует, что Resource Manager создает фабрику данных с управляемым удостоверением.

• Версия пакета SDK фабрики данных для .NET, поддерживающего эту функцию, должна быть 1.1.0 или выше.

• Предоставить разрешение может пользователь с ролью "Владелец" или унаследованной ролью "Владелец" в фабрике данных, где существует общая среда выполнения интеграции.

• Функция общего доступа работает только для фабрик данных в одном клиенте Microsoft Entra.

• Для гостевых пользователей Идентификатора Microsoft Entra функция поиска в пользовательском интерфейсе, которая перечисляет все фабрики данных с помощью ключевого слова поиска, не работает. Но пока гостевой пользователь является владельцем фабрики данных, можно получить общий доступ к среде выполнения интеграции без использования функции поиска. Для управляемого удостоверения фабрики данных с общим доступом к среде выполнения интеграции укажите управляемое удостоверение в поле Назначить разрешение и выберите Добавить в пользовательском интерфейсе фабрики данных.

  Примечание.

  Эта функция доступна только в фабрике данных версии 2.

Связанный контент

• Ознакомьтесь с основными понятиями среды выполнения интеграции в Фабрике данных Azure.

• Узнайте, как создать локальную среду выполнения интеграции на портале Azure.