Share via

Azure-SSIS Integration Runtime toevoegen aan een virtueel netwerk via Azure PowerShell

  • Artikel

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

In dit artikel leest u hoe u uw bestaande Azure-SQL Server Integration Services (SSIS) Integration Runtime (IR) in Azure Data Factory kunt koppelen aan een virtueel netwerk via Azure PowerShell.

Notitie

Voor Azure-SSIS IR in Azure Synapse Analytics vervangt u de bijbehorende Azure Synapse Analytics PowerShell-interfaces: Set-AzSynapseIntegrationRuntime (Az.Synapse), Start-AzSynapseIntegrationRuntime en Stop-AzSynapseIntegrationRuntime.

Variabelen maken

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

Een virtueel netwerk configureren

Voordat u uw Azure-SSIS IR kunt koppelen aan een virtueel netwerk, moet u het virtuele netwerk configureren. Als u automatisch machtigingen en instellingen voor virtuele netwerken wilt configureren voor uw Azure-SSIS IR om lid te worden van een virtueel netwerk, voegt u het volgende script toe:

# Make sure to run this script against the subscription to which the virtual network belongs.
if(![string]::IsNullOrEmpty($VnetId) -and ![string]::IsNullOrEmpty($SubnetName))
{
    # Register to the Azure Batch resource provider
    $BatchApplicationId = "ddbf3205-c6bd-46ae-8127-60eb93363864"
    $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
    }
}

Een Azure-SSIS IR maken en deze toevoegen aan een virtueel netwerk

U kunt een Azure-SSIS IR maken en deze tegelijkertijd toevoegen aan een virtueel netwerk. Zie Een Azure-SSIS IR maken voor het volledige script en de volledige instructies.

Een bestaande Azure-SSIS IR toevoegen aan een virtueel netwerk

In het artikel Een Azure-SSIS IR maken ziet u hoe u een Azure-SSIS IR maakt en deze koppelt aan een virtueel netwerk in hetzelfde script. Als u al een Azure-SSIS IR hebt, volgt u deze stappen om deze toe te voegen aan een virtueel netwerk:

  1. Stop uw Azure-SSIS IR.
  2. Configureer uw Azure-SSIS IR om lid te worden van een virtueel netwerk.
  3. Start uw Azure-SSIS IR.

Uw Azure-SSIS IR stoppen

U moet uw Azure-SSIS IR stoppen voordat u deze kunt toevoegen aan een virtueel netwerk. Met deze opdracht worden alle knooppunten vrijgegeven en wordt de facturering gestopt:

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

Uw Azure-SSIS IR configureren om lid te worden van een virtueel netwerk

Voer de Set-AzDataFactoryV2IntegrationRuntime opdracht uit om uw Azure-SSIS IR toe te voegen aan een virtueel netwerk:

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
    }
}

Uw Azure-SSIS IR starten

Voer de volgende opdracht uit om uw Azure-SSIS IR te starten:

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

Als u de express/standard virtuele netwerkinjectiemethode gebruikt, duurt deze opdracht respectievelijk 5/20-30 minuten.

Gerelateerde inhoud

Zie de volgende artikelen voor meer informatie over Azure-SSIS IR:

  • Azure-SSIS IR. Dit artikel bevat algemene conceptuele informatie over IR's, waaronder Azure-SSIS IR.
  • Zelfstudie: SSIS-pakketten implementeren in Azure. Deze zelfstudie bevat stapsgewijze instructies voor het maken van uw Azure-SSIS IR. Azure SQL Database-server wordt gebruikt om SSISDB te hosten.
  • Maak een Azure-SSIS IR. In dit artikel wordt de zelfstudie uitgebreid. Het bevat instructies voor het gebruik van een Azure SQL Database-server die is geconfigureerd met een service-eindpunt voor een virtueel netwerk/IP-firewallregel/privé-eindpunt of azure SQL Managed Instance dat een virtueel netwerk koppelt om SSISDB te hosten. U ziet hoe u uw Azure-SSIS IR kunt koppelen aan een virtueel netwerk.
  • Een Azure-SSIS IR controleren. In dit artikel leest u hoe u informatie over uw Azure-SSIS IR ophaalt en begrijpt.
  • Een Azure-SSIS IR beheren. In dit artikel leest u hoe u uw Azure-SSIS IR stopt, start of verwijdert. U ziet ook hoe u uw Azure-SSIS IR kunt uitschalen door meer knooppunten toe te voegen.