다음을 통해 공유

Azure PowerShell을 통해 Azure-SSIS 통합 런타임을 가상 네트워크에 조인

  • 아티클

적용 대상: Azure Data Factory Azure Synapse Analytics

팁

기업용 올인원 분석 솔루션인 Microsoft Fabric의 Data Factory를 사용해 보세요. Microsoft Fabric은 데이터 이동부터 데이터 과학, 실시간 분석, 비즈니스 인텔리전스 및 보고에 이르기까지 모든 것을 다룹니다. 무료로 새 평가판을 시작하는 방법을 알아봅니다!

이 문서에서는 Azure PowerShell을 통해 Azure Data Factory의 기존 Azure SSIS(SQL Server Integration Services) IR(통합 런타임)을 가상 네트워크에 조인하는 방법을 보여 줍니다.

참고 항목

Azure Synapse Analytics의 Azure-SSIS IR의 경우 해당 Azure Synapse Analytics PowerShell 인터페이스로 대체합니다. Set-AzSynapseIntegrationRuntime(Az.Synapse), Start-AzSynapseIntegrationRuntime 및 Stop-AzSynapseIntegrationRuntime

변수 만들기

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

Azure Batch 애플리케이션 ID 가져오기

  1. Azure Portal로 이동합니다.
  2. 검색 창에서 Microsoft Entra ID 아래의 드롭다운 목록에서 입력Microsoft Azure Batch하고 선택합니다.
  3. Microsoft Azure Batch 페이지에서 애플리케이션 ID를 기록하거나 클립보드에 복사합니다.
  4. 다음 스크립트에서 변수를 $BatchApplicationId 실행하기 전에 이 값으로 설정합니다.

가상 네트워크 구성

Azure-SSIS IR을 가상 네트워크에 조인하기 전에 가상 네트워크를 구성해야 합니다. Azure-SSIS IR이 가상 네트워크에 조인하도록 가상 네트워크 권한과 설정을 자동으로 구성하려면 다음 스크립트를 추가합니다.

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

Azure-SSIS IR을 만들어 가상 네트워크에 조인

Azure-SSIS IR을 만드는 동시에 가상 네트워크에 조인할 수 있습니다. 전체 스크립트 및 지침은 Azure-SSIS IR 만들기를 참조하세요.

기존 Azure-SSIS IR을 가상 네트워크에 조인

Azure-SSIS IR 만들기 문서는 동일한 스크립트로 Azure-SSIS IR을 만들고 가상 네트워크에 조인하는 방법을 보여 줍니다. Azure-SSIS IR이 이미 있는 경우 다음 단계에 따라 가상 네트워크에 조인합니다.

  1. Azure-SSIS IR을 중지합니다.
  2. 가상 네트워크에 조인하도록 Azure-SSIS IR을 구성합니다.
  3. Azure-SSIS IR을 시작합니다.

Azure-SSIS IR 중지

가상 네트워크에 조인하려면 먼저 Azure-SSIS IR을 중지해야 합니다. 이 명령은 모든 노드를 해제하고 청구를 중지합니다.

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

가상 네트워크에 조인하도록 Azure-SSIS IR 구성

Azure-SSIS IR을 가상 네트워크에 조인하려면 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
    }
}

Azure-SSIS IR 시작

Azure-SSIS IR을 시작하려면 다음 명령을 실행합니다.

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

Express/표준 가상 네트워크 주입 방법을 사용하는 경우 이 명령을 완료하는 데 각각 5/20-30분이 걸립니다.

관련 콘텐츠

Azure-SSIS IR에 대한 자세한 내용은 다음 문서를 참조하세요.

  • Azure SSIS IR. 이 문서에서는 Azure-SSIS IR 등 IR에 대한 일반적인 개념적 정보를 제공합니다.
  • 자습서: Azure에 SSIS 패키지 배포. 이 자습서에서는 Azure-SSIS IR을 만드는 단계별 지침을 제공합니다. Azure SQL Database 서버를 사용하여 SSISDB를 호스트합니다.
  • Azure-SSIS IR 만들기. 이 문서는 자습서를 더 자세히 설명합니다. 가상 네트워크 서비스 엔드포인트/IP 방화벽 규칙/프라이빗 엔드포인트 또는 가상 네트워크를 조인하여 SSISDB를 호스트하는 Azure SQL Managed Instance로 구성된 Azure SQL Database 서버를 사용하는 방법에 대한 지침을 제공합니다. Azure-SSIS IR을 가상 네트워크에 조인하는 방법을 보여 줍니다.
  • Azure-SSIS IR 모니터링. 이 문서에서는 Azure-SSIS IR에 대한 정보를 검색하고 이해하는 방법을 보여줍니다.
  • Azure-SSIS IR 관리. 이 문서에서는 Azure-SSIS IR을 중지하거나, 시작하거나, 삭제하는 방법을 설명합니다. 또한 노드를 추가하여 Azure-SSIS IR 규모를 확장하는 방법도 설명합니다.