Bagikan melalui

Menggabungkan runtime integrasi Azure-SSIS ke jaringan virtual melalui Azure PowerShell

  • Artikel

BERLAKU UNTUK: Azure Data Factory Azure Synapse Analytics

Tip

Cobalah Data Factory di Microsoft Fabric, solusi analitik all-in-one untuk perusahaan. Microsoft Fabric mencakup semuanya mulai dari pergerakan data hingga ilmu data, analitik real time, kecerdasan bisnis, dan pelaporan. Pelajari cara memulai uji coba baru secara gratis!

Artikel ini menunjukkan kepada Anda cara menggabungkan runtime integrasi (IR) Azure-SQL Server Integration Services (SSIS) yang sudah ada di Azure Data Factory ke jaringan virtual melalui Azure PowerShell.

Catatan

Untuk Azure-SSIS IR di Azure Synapse Analytics, ganti dengan antarmuka PowerShell Azure Synapse Analytics yang sesuai: Set-AzSynapseIntegrationRuntime (Az.Synapse), Start-AzSynapseIntegrationRuntime dan Stop-AzSynapseIntegrationRuntime .

Membuat variabel

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

Mengonfigurasikan jaringan virtual

Sebelum Anda dapat menggabungkan IR Azure-SSIS ke jaringan virtual, Anda perlu mengonfigurasi jaringan virtual. Untuk mengonfigurasi izin dan pengaturan jaringan virtual secara otomatis agar IR Azure-SSIS Anda bergabung dengan jaringan virtual, tambahkan skrip berikut:

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

Membuat IR Azure-SSIS dan menggabungkannya ke jaringan virtual

Anda dapat membuat IR Azure-SSIS dan menggabungkannya ke jaringan virtual secara bersamaan. Untuk skrip dan petunjuk yang lengkap, lihat Membuat IR Azure-SSIS.

Menggabungkan IR Azure SSIS ke jaringan virtual

Artikel Membuat IR Azure-SSIS menunjukkan cara membuat IR Azure-SSIS dan menggabungkannya ke jaringan virtual dalam skrip yang sama. Jika Anda sudah memiliki IR Azure-SSIS, ikuti langkah-langkah ini untuk menggabungkannya ke jaringan virtual:

  1. Hentikan IR Azure-SSIS Anda.
  2. Konfigurasikan IR Azure-SSIS Anda untuk bergabung dengan jaringan virtual.
  3. Mulai IR Azure-SSIS Anda.

Hentikan IR Azure-SSIS Anda

Anda harus menghentikan IR Azure-SSIS agar dapat menggabungkannya ke jaringan virtual. Perintah ini merilis semua nodenya dan menghentikan penagihan:

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

Konfigurasikan IR Azure-SSIS Anda untuk bergabung dengan jaringan virtual

Untuk menggabungkan IR Azure-SSIS Anda ke jaringan virtual, jalankan perintah Set-AzDataFactoryV2IntegrationRuntime:

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

Mulai IR Azure-SSIS Anda

Untuk memulai IR Azure-SSIS, jalankan perintah berikut:

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

Jika Anda menggunakan metode injeksi jaringan virtual ekspres/standar, perintah ini masing-masing membutuhkan waktu 5/20-30 menit untuk diselesaikan.

Konten terkait

Untuk informasi selengkapnya tentang IR Azure-SSIS, lihat artikel berikut ini:

  • IR Azure-SSIS. Artikel ini memberikan informasi konseptual umum tentang IR, termasuk IR Azure-SSIS.
  • Tutorial: Menyebarkan paket SSIS ke Azure. Tutorial ini memberikan petunjuk langkah demi langkah untuk membuat IR Azure-SSIS Anda. Ini menggunakan server Azure SQL Database untuk menghosting SSISDB.
  • Membuat IR Azure-SSIS. Artikel ini memperluas tutorial. Ini memberikan instruksi tentang penggunaan server Azure SQL Database dikonfigurasi dengan titik akhir layanan jaringan virtual/aturan firewall IP/titik akhir privat atau Azure SQL Managed Instance yang bergabung dengan jaringan virtual untuk menghosting SSISDB. Ini menunjukkan cara menggabungkan Azure-SSIS IR Anda ke jaringan virtual.
  • Memantau runtime integrasi Azure-SSIS. Artikel ini memperlihatkan kepada Anda cara mengambil dan memahami informasi tentang runtime integrasi Azure-SSIS Anda.
  • Mengelola runtime integrasi Azure-SSIS. Artikel ini menunjukkan cara menghentikan, memulai, atau menghapus runtime integrasi Azure-SSIS. Ini juga menunjukkan cara meluaskan skala runtime integrasi Azure-SSIS Anda dengan menambahkan lebih banyak node.