Sdílet prostřednictvím

Připojení prostředí Azure-SSIS Integration Runtime k virtuální síti přes Azure PowerShell

  • Článek

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tip

Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat až po datové vědy, analýzy v reálném čase, business intelligence a vytváření sestav. Přečtěte si, jak začít používat novou zkušební verzi zdarma.

V tomto článku se dozvíte, jak připojit stávající prostředí Azure-SQL Server Integration Services (SSIS) Integration Runtime (IR) ve službě Azure Data Factory k virtuální síti přes Azure PowerShell.

Poznámka:

Pro Azure-SSIS IR v Azure Synapse Analytics nahraďte odpovídajícími rozhraními PowerShellu azure Synapse Analytics: Set-AzSynapseIntegrationRuntime (Az.Synapse), Start-AzSynapseIntegrationRuntime a Stop-AzSynapseIntegrationRuntime.

Vytvoření proměnných

$ResourceGroupName = "[your Azure resource group name]"
$DataFactoryName = "[your data factory name]"
$AzureSSISName = "[your Azure-SSIS IR name]"
# Virtual network info: Azure Resource Manager or Classic
$VnetId = "[your virtual network resource ID or leave it empty]" # REQUIRED if you use Azure SQL Database server configured with a private endpoint/IP firewall rule/virtual network service endpoint or Azure SQL Managed Instance that joins a virtual network to host SSISDB, or if you require access to on-premises data without configuring a self-hosted IR. We recommend Azure Resource Manager virtual network, because classic virtual network will be deprecated soon.
$SubnetName = "[your subnet name or leave it empty]" # WARNING: Use the same subnet as the one used for Azure SQL Database server configured with a virtual network service endpoint or a different subnet from the one used for Azure SQL Managed Instance that joins a virtual network
$SubnetId = $VnetId + '/subnets/' + $SubnetName 
# Virtual network injection method: Standard or Express. For comparison, see https://learn.microsoft.com/azure/data-factory/azure-ssis-integration-runtime-virtual-network-configuration.
$VnetInjectionMethod = "Standard" # Standard by default, whereas Express lets you use the express virtual network injection method
# Public IP address info: OPTIONAL to provide two standard static public IP addresses with DNS name under the same subscription and in the same region as your virtual network
$FirstPublicIP = "[your first public IP address resource ID or leave it empty]"
$SecondPublicIP = "[your second public IP address resource ID or leave it empty]"

Získání ID aplikace Azure Batch

  1. Přejděte na Azure Portal.
  2. Na panelu hledání zadejte Microsoft Azure Batcha vyberte ho z rozevíracího seznamu v části Microsoft Entra ID.
  3. Na stránce Microsoft Azure Batch si poznamenejte nebo zkopírujte ID aplikace do schránky.
  4. V následujícím skriptu nastavte proměnnou $BatchApplicationId na tuto hodnotu předtím, než ji spustíte.

Konfigurace virtuální sítě

Než se budete moct připojit k prostředí Azure-SSIS IR k virtuální síti, musíte nakonfigurovat virtuální síť. Pokud chcete automaticky nakonfigurovat oprávnění a nastavení virtuální sítě pro prostředí Azure-SSIS IR pro připojení k virtuální síti, přidejte následující skript:

# Make sure to run this script against the subscription to which the virtual network belongs.

$BatchApplicationId = "[REPLACE_WITH_AZURE_BATCH_APP_ID]"

if(![string]::IsNullOrEmpty($VnetId) -and ![string]::IsNullOrEmpty($SubnetName))
{
    # Register to the Azure Batch resource provider
    $BatchObjectId = (Get-AzADServicePrincipal -ServicePrincipalName $BatchApplicationId).Id
    Register-AzResourceProvider -ProviderNamespace Microsoft.Batch
    while(!(Get-AzResourceProvider -ProviderNamespace "Microsoft.Batch").RegistrationState.Contains("Registered"))
    {
    Start-Sleep -s 10
    }
    if($VnetId -match "/providers/Microsoft.ClassicNetwork/")
    {
        # Assign the VM contributor role to Microsoft.Batch
        New-AzRoleAssignment -ObjectId $BatchObjectId -RoleDefinitionName "Classic Virtual Machine Contributor" -Scope $VnetId
    }
}

Vytvoření prostředí Azure-SSIS IR a jeho připojení k virtuální síti

Můžete vytvořit prostředí Azure-SSIS IR a připojit ho k virtuální síti současně. Kompletní skript a pokyny najdete v tématu Vytvoření prostředí Azure-SSIS IR.

Připojení existujícího prostředí Azure-SSIS IR k virtuální síti

Článek Vytvoření prostředí Azure-SSIS IR ukazuje, jak vytvořit prostředí Azure-SSIS IR a připojit ho k virtuální síti ve stejném skriptu. Pokud už máte prostředí Azure-SSIS IR, připojte ho k virtuální síti takto:

  1. Zastavte prostředí Azure-SSIS IR.
  2. Nakonfigurujte prostředí Azure-SSIS IR pro připojení k virtuální síti.
  3. Spusťte prostředí Azure-SSIS IR.

Zastavení prostředí Azure-SSIS IR

Než ho budete moct připojit k virtuální síti, musíte prostředí Azure-SSIS IR zastavit. Tento příkaz uvolní všechny jeho uzly a zastaví fakturaci:

Stop-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
    -DataFactoryName $DataFactoryName `
    -Name $AzureSSISName `
    -Force

Konfigurace prostředí Azure-SSIS IR pro připojení k virtuální síti

Pokud chcete připojit prostředí Azure-SSIS IR k virtuální síti, spusťte Set-AzDataFactoryV2IntegrationRuntime příkaz:

Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
    -DataFactoryName $DataFactoryName `
    -Name $AzureSSISName `
    -SubnetId $SubnetId `
    -VNetInjectionMethod $VnetInjectionMethod

# Add public IP address parameters if you use the standard virtual network injection method and bring your own static public IP addresses
if($VnetInjectionMethod -eq "Standard")
{
    if(![string]::IsNullOrEmpty($FirstPublicIP) -and ![string]::IsNullOrEmpty($SecondPublicIP))
    {
        $publicIPs = @($FirstPublicIP, $SecondPublicIP)
        Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
            -DataFactoryName $DataFactoryName `
            -Name $AzureSSISName `
            -PublicIPs $publicIPs
    }
}

Spuštění prostředí Azure-SSIS IR

Pokud chcete spustit Azure-SSIS IR, spusťte následující příkaz:

Start-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
    -DataFactoryName $DataFactoryName `
    -Name $AzureSSISName `
    -Force

Pokud použijete metodu injektáže expresní/standardní virtuální sítě, dokončení tohoto příkazu trvá 5/20 až 30 minut.

Související obsah

Další informace o azure-SSIS IR najdete v následujících článcích:

  • Azure-SSIS IR. Tento článek obsahuje obecné koncepční informace o irech, včetně prostředí Azure-SSIS IR.
  • Kurz: Nasazení balíčků SSIS do Azure Tento kurz obsahuje podrobné pokyny k vytvoření prostředí Azure-SSIS IR. K hostování databáze SSISDB používá server Azure SQL Database.
  • Vytvořte prostředí Azure-SSIS IR. Tento článek se zabývá kurzem. Obsahuje pokyny k používání serveru Azure SQL Database nakonfigurovaného s koncovým bodem služby virtuální sítě, pravidlem brány firewall protokolu IP nebo privátním koncovým bodem nebo službou Azure SQL Managed Instance, která připojí virtuální síť k hostování databáze SSISDB. Ukazuje, jak připojit Prostředí Azure-SSIS IR k virtuální síti.
  • Monitorování prostředí Azure-SSIS IR. V tomto článku se dozvíte, jak načíst a pochopit informace o prostředí Azure-SSIS IR.
  • Správa Azure-SSIS IR. Tento článek ukazuje, jak zastavit, spustit nebo odstranit prostředí Azure-SSIS IR. Ukazuje také postup škálování Azure-SSIS IR přidáním více uzlů.