Dołączanie środowiska Azure-SSIS Integration Runtime do sieci wirtualnej za pośrednictwem programu Azure PowerShell

  • Artykuł

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Napiwek

Wypróbuj usługę Data Factory w usłudze Microsoft Fabric — rozwiązanie analityczne typu all-in-one dla przedsiębiorstw. Usługa Microsoft Fabric obejmuje wszystko, od przenoszenia danych do nauki o danych, analizy w czasie rzeczywistym, analizy biznesowej i raportowania. Dowiedz się, jak bezpłatnie rozpocząć nową wersję próbną !

W tym artykule przedstawiono sposób dołączania istniejącego środowiska Azure-SQL Server Integration Services (SSIS) Integration Runtime (IR) w usłudze Azure Data Factory do sieci wirtualnej za pośrednictwem programu Azure PowerShell.

Uwaga

W przypadku środowiska Azure-SSIS IR w usłudze Azure Synapse Analytics zastąp element odpowiednimi interfejsami programu PowerShell usługi Azure Synapse Analytics: Set-AzSynapseIntegrationRuntime (Az.Synapse), Start-AzSynapseIntegrationRuntime i Stop-AzSynapseIntegrationRuntime.

Tworzenie zmiennych

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

Konfigurowanie sieci wirtualnej

Przed dołączeniem środowiska Azure-SSIS IR do sieci wirtualnej należy skonfigurować sieć wirtualną. Aby automatycznie skonfigurować uprawnienia i ustawienia sieci wirtualnej dla środowiska Azure-SSIS IR w celu dołączenia do sieci wirtualnej, dodaj następujący skrypt:

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

Tworzenie środowiska Azure-SSIS IR i dołączanie go do sieci wirtualnej

Środowisko Azure-SSIS IR można utworzyć i dołączyć je do sieci wirtualnej w tym samym czasie. Aby uzyskać pełny skrypt i instrukcje, zobacz Tworzenie środowiska Azure-SSIS IR.

Dołączanie istniejącego środowiska Azure-SSIS IR do sieci wirtualnej

W artykule Tworzenie środowiska Azure-SSIS IR pokazano, jak utworzyć środowisko Azure-SSIS IR i dołączyć je do sieci wirtualnej w tym samym skrycie. Jeśli masz już środowisko Azure-SSIS IR, wykonaj następujące kroki, aby dołączyć je do sieci wirtualnej:

  1. Zatrzymaj środowisko Azure-SSIS IR.
  2. Skonfiguruj środowisko Azure-SSIS IR w celu dołączenia do sieci wirtualnej.
  3. Uruchom środowisko Azure-SSIS IR.

Zatrzymywanie środowiska Azure-SSIS IR

Musisz zatrzymać środowisko Azure-SSIS IR, zanim będzie można dołączyć je do sieci wirtualnej. To polecenie zwalnia wszystkie węzły i zatrzymuje rozliczenia:

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

Konfigurowanie środowiska Azure-SSIS IR w celu dołączenia do sieci wirtualnej

Aby dołączyć środowisko Azure-SSIS IR do sieci wirtualnej, uruchom Set-AzDataFactoryV2IntegrationRuntime polecenie:

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

Uruchamianie środowiska Azure-SSIS IR

Aby uruchomić środowisko Azure-SSIS IR, uruchom następujące polecenie:

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

Jeśli używasz metody wstrzykiwania sieci wirtualnej express/standard, wykonanie tego polecenia trwa odpowiednio 5/20–30 minut.

Powiązana zawartość

Aby uzyskać więcej informacji na temat środowiska Azure-SSIS IR, zobacz następujące artykuły:

  • Azure-SSIS IR. Ten artykuł zawiera ogólne informacje koncepcyjne dotyczące adresów IP, w tym środowiska Azure-SSIS IR.
  • Samouczek: wdrażanie pakietów usług SSIS na platformie Azure. Ten samouczek zawiera instrukcje krok po kroku dotyczące tworzenia środowiska Azure-SSIS IR. Używa serwera usługi Azure SQL Database do hostowania bazy danych SSISDB.
  • Tworzenie środowiska Azure-SSIS IR. Ten artykuł jest rozwijany w samouczku. Zawiera instrukcje dotyczące używania serwera usługi Azure SQL Database skonfigurowanego z punktem końcowym usługi sieci wirtualnej/regułą zapory IP/prywatnym punktem końcowym lub usługą Azure SQL Managed Instance przyłączającą sieć wirtualną do hostowania bazy danych SSISDB. Przedstawiono w nim sposób dołączania środowiska Azure-SSIS IR do sieci wirtualnej.
  • Monitor an Azure-SSIS IR (Monitorowanie środowiska Azure-SSIS IR). W tym artykule pokazano, jak pobrać i zrozumieć informacje na temat środowiska Azure-SSIS IR.
  • Manage an Azure-SSIS IR (Zarządzanie środowiskiem Azure-SSIS IR). W tym artykule pokazano, jak zatrzymać, uruchomić lub usunąć środowisko Azure-SSIS IR. Przedstawiono w nim również sposób skalowania środowiska Azure-SSIS IR przez dodanie większej liczby węzłów.