PowerShell을 사용하여 SSIS 프로젝트 배포

  • 아티클

적용 대상: Azure Data Factory SSIS Integration Runtime SQL Server

이 빠른 시작에서는 PowerShell 스크립트를 사용하여 데이터베이스 서버에 연결하고 SSIS 프로젝트를 SSIS 카탈로그에 배포하는 방법을 보여줍니다.

필수 조건

Azure SQL Database 서버는 포트 1433에서 수신 대기합니다. 회사 방화벽 내에서 Azure SQL Database 서버에 성공적으로 연결하려면 이 포트가 회사 방화벽에서 열려 있어야 합니다.

지원되는 플랫폼

이 빠른 시작의 정보를 사용하여 다음과 같은 플랫폼에 SSIS 프로젝트를 배포할 수 있습니다.

이 빠른 시작의 정보를 사용하여 SQL Server on Linux에 SSIS 패키지를 배포할 수 없습니다. Linux에서 패키지를 실행하는 방법에 대한 자세한 내용은 Linux에서 SSIS를 사용하여 데이터 추출, 변환 및 로드를 참조하세요.

Azure SQL Database에서 연결 정보 가져오기

Azure SQL Database에 프로젝트를 배포하려면 SSISDB(SSIS 카탈로그 데이터베이스)에 연결해야 하는 연결 정보를 가져옵니다. 다음 절차에는 정규화된 서버 이름과 로그인 정보가 필요합니다.

  1. Azure Portal에 로그인합니다.
  2. 왼쪽 메뉴에서 SQL Databases를 선택한 다음, SQL 데이터베이스 페이지에서 SSISDB 데이터베이스를 선택합니다.
  3. 데이터베이스의 개요 페이지에서 정규화된 서버 이름을 검토합니다. 복사하려면 클릭 옵션을 표시하려면 마우스로 서버 이름 위를 가리킵니다.
  4. Azure SQL Database 서버 로그인 정보를 잊은 경우, SQL Database 서버 페이지로 이동하여 서버 관리자 이름을 확인합니다. 필요한 경우 암호를 다시 설정할 수 있습니다.
  5. 데이터베이스 연결 문자열 표시를 클릭합니다.
  6. ADO.NET 연결 문자열 전체를 검토합니다.

지원되는 인증 방법

배포를 위한 인증 방법을 참조하세요.

SSIS PowerShell 공급자

다음 스크립트를 기반으로 변수에 적절한 값을 제공한 후 SSIS 프로젝트를 배포하는 스크립트를 실행하세요.

참고

다음 예제에서는 Windows 인증을 사용하여 SQL Server 온-프레미스를 배포합니다. New-PSDive cmdlet을 통해 SQL Server 인증을 사용하여 연결을 설정합니다. Azure SQL Database 서버에 연결하는 경우 Windows 인증을 사용할 수 없습니다.

# Variables
$TargetInstanceName = "localhost\default"
$TargetFolderName = "Project1Folder"
$ProjectFilePath = "C:\Projects\Integration Services Project1\Integration Services Project1\bin\Development\Integration Services Project1.ispac"
$ProjectName = "Integration Services Project1"

# Get the Integration Services catalog
$catalog = Get-Item SQLSERVER:\SSIS\$TargetInstanceName\Catalogs\SSISDB\

# Create the target folder
New-Object "Microsoft.SqlServer.Management.IntegrationServices.CatalogFolder" ($catalog, 
$TargetFolderName,"Folder description") -OutVariable folder
$folder.Create()

# Read the project file and deploy it
[byte[]] $projectFile = [System.IO.File]::ReadAllBytes($ProjectFilePath)
$folder.DeployProject($ProjectName, $projectFile)

# Verify packages were deployed.
dir "$($catalog.PSPath)\Folders\$TargetFolderName\Projects\$ProjectName\Packages" | 
SELECT Name, DisplayName, PackageId

PowerShell 스크립트

다음 스크립트를 기반으로 변수에 적절한 값을 제공한 후 SSIS 프로젝트를 배포하는 스크립트를 실행하세요.

참고

다음 예제에서는 Windows 인증을 사용하여 SQL Server 온-프레미스를 배포합니다. SQL Server 인증을 사용하려면 Integrated Security=SSPI; 인수를 User ID=<user name>;Password=<password>;로 바꿉니다. Azure SQL Database 서버에 연결하는 경우 Windows 인증을 사용할 수 없습니다.

# Variables
$SSISNamespace = "Microsoft.SqlServer.Management.IntegrationServices"
$TargetServerName = "localhost"
$TargetFolderName = "Project1Folder"
$ProjectFilePath = "C:\Projects\Integration Services Project1\Integration Services Project1\bin\Development\Integration Services Project1.ispac"
$ProjectName = "Integration Services Project1"

# Load the IntegrationServices assembly
$loadStatus = [System.Reflection.Assembly]::Load("Microsoft.SQLServer.Management.IntegrationServices, "+
    "Version=14.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91, processorArchitecture=MSIL")

# Create a connection to the server
$sqlConnectionString = `
    "Data Source=" + $TargetServerName + ";Initial Catalog=master;Integrated Security=SSPI;"
$sqlConnection = New-Object System.Data.SqlClient.SqlConnection $sqlConnectionString

# Create the Integration Services object
$integrationServices = New-Object $SSISNamespace".IntegrationServices" $sqlConnection

# Get the Integration Services catalog
$catalog = $integrationServices.Catalogs["SSISDB"]

# Create the target folder
$folder = New-Object $SSISNamespace".CatalogFolder" ($catalog, $TargetFolderName,
    "Folder description")
$folder.Create()

Write-Host "Deploying " $ProjectName " project ..."

# Read the project file and deploy it
[byte[]] $projectFile = [System.IO.File]::ReadAllBytes($ProjectFilePath)
$folder.DeployProject($ProjectName, $projectFile)

Write-Host "Done."

다음 단계