Azure SQL Managed Instance Agent를 사용하여 SSIS 패키지 실행하기

  • 아티클

적용 대상: Azure Data Factory Azure Synapse Analytics

팁

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

이 문서에서는 Azure SQL Managed Instance Agent를 사용하여 SSIS(SQL Server Integration Services) 패키지를 실행하는 방법을 설명합니다. 이 기능은 온-프레미스 환경에서 SQL Server Agent를 사용하여 SSIS 패키지를 예약하는 경우와 유사한 동작을 제공합니다.

이 기능을 사용하여 SQL Managed Instance의 SSISDB, Azure Files 등의 파일 시스템, 또는 Azure SSIS 통합 런타임 패키지 저장소에 저장된 SSIS 패키지를 실행할 수 있습니다.

필수 조건

이 기능을 사용하려면 최신 SQL Server Management Studio(SSMS)를 다운로드하여 설치합니다. 버전 지원 세부 정보:

  • SSISDB 또는 파일 시스템에서 패키지를 실행하려면 SSMS 버전 18.5 이상을 설치합니다.
  • 패키지 저장소에서 패키지를 실행하려면 SSMS 버전 18.6 이상을 설치합니다.

또한 Azure Data Factory에서 Azure SSIS 통합 런타임 프로비저닝을 해야 합니다. SQL Managed Instance를 엔드포인트 서버로 사용합니다.

SSISDB에서 SSIS 패키지 실행

이 프로시저에서는 SQL Managed Instance Agent를 사용하여 SSISDB에 저장된 SSIS 패키지를 호출합니다.

  1. 최신 버전의 SSMS에서 SQL Managed Instance에 연결합니다.

  2. 새 에이전트 작업 및 새 작업 단계 만들기. SQL Server Agent에서 작업 폴더를 마우스 우클릭한 다음 새 작업을 선택합니다.

    Selections for creating a new agent job

  3. 새 작업 단계 페이지에서 형식을 SQL Server Integration Services 패키지로 선택합니다.

    Selections for creating a new SSIS job step

  4. 패키지 탭에서 패키지 위치를 SSIS 카탈로그로 선택합니다.

  5. SSISDB는 SQL Managed Instance에 있으므로 인증을 지정할 필요가 없습니다.

  6. SSISDB에서 SSIS 패키지를 지정합니다.

    Package tab with selections for the package source type

  7. 구성 탭에서 다음을 수행할 수 있습니다.

    • 매개 변수아래에 매개 변수 값을 지정합니다.
    • 연결 관리자아래에서 값을 재정의합니다.
    • 속성을 재정의하고 고급에서 로깅 수준을 선택합니다.

    Configuration tab with selections for the package source type

  8. 확인을 클릭하여 에이전트 작업 구성을 저장합니다.

  9. 에이전트 작업을 시작하여 SSIS 패키지를 실행합니다.

파일 시스템에서 SSIS 패키지 실행

이 절차에서는 SQL Managed Instance Agent를 사용하여 파일 시스템에 저장된 SSIS 패키지를 실행합니다.

  1. 최신 버전의 SSMS에서 SQL Managed Instance에 연결합니다.

  2. 새 에이전트 작업 및 새 작업 단계 만들기. SQL Server Agent에서 작업 폴더를 마우스 우클릭한 다음 새 작업을 선택합니다.

    Selections for creating a new agent job

  3. 새 작업 단계 페이지에서 형식을 SQL Server Integration Services 패키지로 선택합니다.

    Selections for creating a new SSIS job step

  4. 패키지 탭을 선택합니다.

    1. 패키지 위치에서 파일 시스템을 선택합니다.

    2. 파일 원본 형식:

      • 패키지가 Azure Files에 업로드된 경우 Azure 파일 공유를 선택합니다.

        Options for file source type

        패키지 경로는 \\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsx입니다.

        패키지 파일 액세스 자격 증명에서 Azure 파일 계정 이름 및 계정 키를 입력하여 Azure 파일에 액세스합니다. 도메인은 Azure로 설정됩니다.

      • 패키지를 네트워크 공유에 업로드하는 경우 네트워크 공유를 선택합니다.

        패키지 경로는 .dtsx 확장명을 사용하는 패키지 파일의 UNC 경로입니다.

        해당 도메인, 사용자 이름 및 암호를 입력하여 네트워크 공유 패키지 파일에 액세스합니다.

    3. 패키지 파일이 패스워드로 암호화된 경우, 암호화 패스워드를 선택하고 패스워드를 입력합니다.

  5. SSIS 패키지를 실행하는 데 구성 파일이 필요한 경우, 구성 탭에서 구성 파일 경로를 입력합니다. Azure Files에 구성을 저장하는 경우, 해당 구성 경로는 \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig입니다.

  6. 실행 옵션 탭에서 Windows 인증 또는 32 비트 런타임의 사용 여부를 선택하여 SSIS 패키지를 실행할 수 있습니다.

  7. 로깅 탭에서 로깅 경로 및 해당 로깅 액세스 자격 증명을 선택하여 로그 파일을 저장할 수 있습니다. 기본적으로 로깅 경로는 패키지 폴더 경로와 같으며 로깅 액세스 자격 증명은 패키지 액세스 자격 증명과 동일합니다. Azure Files에 로그를 저장하는 경우 로깅 경로는\\<storage account name>.file.core.windows.net\<file share name>\<log folder name>입니다.

  8. 값 설정 탭에서 속성 경로 및 값을 입력하여 패키지 속성을 재정의할 수 있습니다.

    예를 들어 사용자 변수 값을 재정의하려면 \Package.Variables[User::<variable name>].Value와 같이 해당 경로를 입력합니다.

  9. 확인을 클릭하여 에이전트 작업 구성을 저장합니다.

  10. 에이전트 작업을 시작하여 SSIS 패키지를 실행합니다.

패키지 저장소에서 SSIS 패키지 실행

참고 항목

패키지 저장소는 Azure Synapse의 Azure-SSIS IR에서 지원되지 않습니다.

이 프로시저에서는 SQL Managed Instance Agent를 사용하여 Azure SSIS IR 패키지 저장소에 저장된 SSIS 패키지를 실행합니다.

  1. 최신 버전의 SSMS에서 SQL Managed Instance에 연결합니다.

  2. 새 에이전트 작업 및 새 작업 단계 만들기. SQL Server Agent에서 작업 폴더를 마우스 우클릭한 다음 새 작업을 선택합니다.

    Selections for creating a new agent job

  3. 새 작업 단계 페이지에서 형식을 SQL Server Integration Services 패키지로 선택합니다.

    Selections for creating a new SSIS job step

  4. 패키지 탭을 선택합니다.

    1. 패키지 위치에서 패키지 저장소를 선택합니다.

    2. 패키지 경로:

      패키지 경로는 <package store name>\<folder name>\<package name>입니다.

      Options for package store type

    3. 패키지 파일이 패스워드로 암호화된 경우, 암호화 패스워드를 선택하고 패스워드를 입력합니다.

  5. SSIS 패키지를 실행하는 데 구성 파일이 필요한 경우, 구성 탭에서 구성 파일 경로를 입력합니다. Azure Files에 구성을 저장하는 경우, 해당 구성 경로는 \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig입니다.

  6. 실행 옵션 탭에서 Windows 인증 또는 32 비트 런타임의 사용 여부를 선택하여 SSIS 패키지를 실행할 수 있습니다.

  7. 로깅 탭에서 로깅 경로 및 해당 로깅 액세스 자격 증명을 선택하여 로그 파일을 저장할 수 있습니다. 기본적으로 로깅 경로는 패키지 폴더 경로와 같으며 로깅 액세스 자격 증명은 패키지 액세스 자격 증명과 동일합니다. Azure Files에 로그를 저장하는 경우 로깅 경로는\\<storage account name>.file.core.windows.net\<file share name>\<log folder name>입니다.

  8. 값 설정 탭에서 속성 경로 및 값을 입력하여 패키지 속성을 재정의할 수 있습니다.

    예를 들어 사용자 변수 값을 재정의하려면 \Package.Variables[User::<variable name>].Value와 같이 해당 경로를 입력합니다.

  9. 확인을 클릭하여 에이전트 작업 구성을 저장합니다.

  10. 에이전트 작업을 시작하여 SSIS 패키지를 실행합니다.

SSIS 패키지 실행 취소

SQL Managed Instance Agent 작업에서 패키지 실행을 취소하려면, 에이전트 작업을 직접 중지하는 대신 다음 단계를 수행합니다.

  1. msdb.dbo.sysjobs에서 SQL Agent jobId를 찾습니다.

  2. 이 쿼리를 사용하여 작업 ID를 기반으로 해당 SSIS executionId를 찾습니다.

    select * from '{table for job execution}' where  parameter_value = 'SQL_Agent_Job_{jobId}' order by execution_id desc

    SSIS 패키지가 SSISDB에 있는 경우 작업 실행을 위해 ssisdb.internal.execution_parameter_values를 테이블로 사용합니다. SSIS 패키지가 파일 시스템에 있는 경우, ssisdb.internal.execution_parameter_values_noncatalog를 사용합니다.

  3. SSISDB 카탈로그를 마우스 오른쪽 단추로 클릭한 다음 활성 작업을 선택합니다.

    "Active Operations" on the shortcut menu for the SSISDB catalog

  4. executionId을 기준으로 해당 작업을 중지합니다.

관련 콘텐츠

Azure Data Factory를 사용하여 SSIS 패키지를 예약할 수도 있습니다. 단계별 지침은 Azure Data Factory 이벤트 트리거를 참조하세요.