Azure Portal에서 SSIS 패키지 실행 작업을 사용하여 SSIS 패키지 실행

적용 대상: Azure Data Factory Azure Synapse Analytics

팁

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

이 문서에서는 Azure Data Factory 및 Synapse Pipelines 포털에서 SSIS 패키지 실행 작업을 사용하여 Azure Data Factory 파이프라인에서 SSIS(SQL Server Integration Services) 패키지를 실행하는 방법에 대해 설명합니다.

필수 조건

자습서: Azure-SSIS IR 프로비전의 단계별 지침 에 따라 아직 없는 경우 Azure-SSIS IR(통합 런타임)을 만듭니다.

SSIS 패키지 실행 작업을 사용하여 파이프라인 만들기

이 단계에서는 Data Factory UI 또는 앱을 사용하여 파이프라인을 만듭니다. 파이프라인에 SSIS 패키지 실행 작업을 추가하고 SSIS 패키지를 실행하도록 구성합니다.

Azure Data Factory

1. Azure Portal Data Factory 개요 또는 홈페이지에서 Azure Data Factory Studio 타일을 선택하여 별도의 탭에서 Data Factory UI 또는 앱을 시작합니다.

   

   홈페이지에서 오케스트레이션을 선택합니다.

   

Synapse Analytics

Synapse Studio의 통합 탭(파이프라인 아이콘으로 표시)으로 이동한 다음, 새 파이프라인을 만듭니다.

1. 작업 도구 상자에서 SSIS를 검색합니다. 그런 다음 SSIS 패키지 실행 작업을 파이프라인 디자이너 화면으로 끌어옵니다.

   

   SSIS 패키지 실행 작업 개체를 선택하여 일반, 설정, SSIS 매개 변수, 연결 관리자 및 속성 재정의 탭을 구성합니다.

일반 탭

SSIS 패키지 실행 작업의 일반 탭에서 다음 단계를 완료합니다.

1. 이름에 SSIS 패키지 실행 작업의 이름을 입력합니다.

2. 설명을 위해 SSIS 패키지 실행 작업에 대한 설명을 입력합니다.

3. 시간 제한의 경우 SSIS 패키지 실행 작업을 실행할 수 있는 최대 시간을 입력합니다. 기본값은 7일이고 형식은 D.HH:MM:SS입니다.

4. 다시 시도에 SSIS 패키지 실행 작업에 대한 최대 다시 시도 횟수를 입력합니다.

5. 다시 시도 간격의 경우 SSIS 패키지 실행 작업에 대한 각 재시도 사이의 시간(초)을 입력합니다. 기본값은 30초입니다.

6. 보안 출력 확인란을 선택하여 SSIS 패키지 실행 작업의 출력을 로깅에서 제외할지 여부를 선택합니다.

7. 보안 입력 검사 상자를 선택하여 SSIS 패키지 실행 작업의 입력을 로깅에서 제외할지 여부를 선택합니다.

설정 탭

SSIS 패키지 실행 작업의 설정 탭에서 다음 단계를 완료합니다.

1. Azure-SSIS IR의 경우 지정된 Azure-SSIS IR을 선택하여 SSIS 패키지 실행 작업을 실행합니다.

2. 설명을 위해 SSIS 패키지 실행 작업에 대한 설명을 입력합니다.

3. Windows 인증 검사 상자를 선택하여 Windows 인증 사용하여 온-프레미스 또는 Azure Files와 같은 데이터 저장소에 액세스할지 여부를 선택합니다.

   이 확인란을 선택하는 경우 도메인, 사용자 이름 및 암호 상자에 패키지 실행 자격 증명의 값을 입력합니다. 예를 들어 Azure Files에 액세스하기 위해 do기본는 Azure사용자 이름이<storage account name>고 암호는 다음과 같습니다<storage account key>.

   또는 Azure Key Vault에 저장된 비밀을 해당 값으로 사용할 수 있습니다. 이렇게 하려면 옆에 있는 AZURE KEY VAULT 검사 상자를 선택합니다. 기존 키 자격 증명 모음 연결된 서비스를 선택 또는 편집하거나 새로 만듭니다. 그런 다음, 값의 비밀 이름 및 버전을 선택합니다. 키 자격 증명 모음 연결된 서비스를 만들거나 편집할 때 기존 키 자격 증명 모음을 선택하거나 편집하거나 새 키 자격 증명 모음을 만들 수 있습니다. 아직 키 자격 증명 모음에 대한 액세스 권한을 Data Factory 관리 ID에 부여해야 합니다. <key vault linked service name>/<secret name>/<secret version> 형식으로 비밀을 직접 입력할 수도 있습니다.

4. 32비트 런타임 검사 상자를 선택하여 패키지를 실행하려면 32비트 런타임이 필요한지 여부를 선택합니다.

5. 패키지 위치에서 SSISDB, 파일 시스템(패키지), 파일 시스템(프로젝트), 포함된 패키지 또는 패키지 저장소를 선택합니다.

패키지 위치: SSISDB

Azure-SSIS IR이 Azure SQL Database 서버/Managed Instance에서 호스트하는 SSIS 카탈로그(SSISDB)로 프로비전되었거나 직접 선택할 수 있는 경우 패키지 위치로 SSISDB가 자동으로 선택됩니다. 선택한 경우 다음 단계를 완료합니다.

1. Azure-SSIS IR이 실행 중이고 수동 입력 확인란이 선택 취소된 경우 SSISDB에서 기존 폴더, 프로젝트, 패키지, 환경을 찾아 선택할 수 있습니다. 새로 고침을 선택하여 새로 추가한 폴더, 프로젝트, 패키지, 환경을 찾아서 선택할 수 있도록 SSISDB에서 페치합니다. 패키지 실행에 대한 환경을 찾아보고 선택하려면 해당 환경을 SSISDB 아래의 동일한 폴더에서 참조로 추가하도록 프로젝트를 미리 구성해야 합니다. 자세한 내용은 SSIS 환경 만들기 및 매핑을 참조 하세요.

2. 로깅 수준에서 패키지 실행에 대해 사전 정의된 로깅 범위를 선택합니다. 사용자 지정된 로깅 이름을 대신 입력하려면 사용자 지정된 검사 상자를 선택합니다.

3. Azure-SSIS IR이 실행되고 있지 않거나 수동 항목 검사 상자가 선택된 경우 SSISDB의 패키지 및 환경 경로를 다음 형식으로 직접 입력합니다 <folder name>/<project name>/<package name>.dtsx<folder name>/<environment name>.

   

패키지 위치: 파일 시스템(패키지)

Azure-SSIS IR이 SSISDB 없이 프로비전되었거나 직접 선택할 수 있는 경우 패키지 위치인 파일 시스템(패키지) 이 자동으로 선택됩니다. 선택한 경우 다음 단계를 완료합니다.

1. 패키지 경로 상자의 패키지 파일(.dtsx 포함)에 UNC(범용 명명 규칙)를 제공하여 패키지를 지정합니다. 파일 스토리지 찾아보기를 선택하여 패키지를 찾아보고 선택하거나 경로를 수동으로 입력할 수 있습니다. 예를 들어 Azure Files에 패키지를 저장하는 경우 해당 경로는 \\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsx입니다.

2. 별도의 파일에서 패키지를 구성하는 경우 구성 경로 상자에 구성 파일(포함 .dtsConfig)에 대한 UNC 경로 도 제공해야 합니다. 파일 스토리지 찾아보기를 선택하여 구성을 찾아보고 선택하거나 경로를 수동으로 입력할 수 있습니다. 예를 들어 Azure Files에 구성을 저장하는 경우 해당 경로는 다음과 같습니다 \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.

3. 패키지 및 구성 파일에 액세스할 자격 증명을 지정합니다. 이전에 패키지 실행 자격 증명(Windows 인증용)을 입력한 경우 패키지 실행 자격 증명과 동일함 확인란을 선택하여 다시 사용할 수 있습니다. 그렇지 않은 경우 도메인, 사용자 이름 및 암호 상자에 패키지 액세스 자격 증명 값을 입력합니다. 예를 들어 Azure Files에 패키지 및 구성을 저장하는 경우 할 일기본Azure, 사용자 이름은 <storage account name>, 암호는 다음과 같습니다<storage account key>.

   또는 Azure Key Vault에 저장된 비밀을 해당 값으로 사용할 수 있습니다. 이렇게 하려면 옆에 있는 AZURE KEY VAULT 검사 상자를 선택합니다. 기존 키 자격 증명 모음 연결된 서비스를 선택 또는 편집하거나 새로 만듭니다. 그런 다음, 값의 비밀 이름 및 버전을 선택합니다. 키 자격 증명 모음 연결된 서비스를 만들거나 편집할 때 기존 키 자격 증명 모음을 선택하거나 편집하거나 새 키 자격 증명 모음을 만들 수 있습니다. 아직 키 자격 증명 모음에 대한 액세스 권한을 Data Factory 관리 ID에 부여해야 합니다. <key vault linked service name>/<secret name>/<secret version> 형식으로 비밀을 직접 입력할 수도 있습니다.

   이러한 자격 증명은 패키지 실행 태스크의 자식 패키지에 액세스하는 데도 사용되며 패키지에 지정된 자체 경로 및 기타 구성에서 참조됩니다.

4. SSDT(SQL Server Data Tools)를 통해 패키지를 만들 때 EncryptAllWithPassword 또는 EncryptSensitiveWithPassword 보호 수준을 사용한 경우 암호화 암호 상자에 암호 값을 입력합니다. 또는 Azure Key Vault에 저장된 비밀을 해당 값으로 사용할 수 있습니다(위의 내용 참조).

   EncryptSensitiveWithUserKey 보호 수준을 사용한 경우 구성 파일 또는 SSIS 매개 변수, 연결 관리자 또는 속성 재정의 탭에서 중요한 값을 다시 입력합니다(아래 참조).

   EncryptAllWithUserKey 보호 수준을 사용하는 경우 지원되지 않습니다. SSDT 또는 dtutil 명령줄 유틸리티를 통해 다른 보호 수준을 사용하도록 패키지를 다시 구성해야 합니다.

5. 로깅 수준에서 패키지 실행에 대해 사전 정의된 로깅 범위를 선택합니다. 사용자 지정된 로깅 이름을 대신 입력하려면 사용자 지정된 검사 상자를 선택합니다.

6. 패키지에 지정할 수 있는 표준 로그 공급자를 사용하지 않고 패키지 실행을 기록하려면 로깅 경로 상자에 UNC 경로를 제공하여 로그 폴더를 지정합니다. 파일 저장소 찾아보기를 선택하여 로그 폴더를 찾아서 선택하거나 경로를 수동으로 입력할 수 있습니다. 예를 들어 Azure Files에 로그를 저장하는 경우 로깅 경로는 \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>입니다. 각 개별 패키지 실행에 대해 이 경로에 하위 폴더가 만들어지고, SSIS 패키지 실행 작업 실행 ID에 따라 이름이 지어지며, 로그 파일이 5분마다 생성됩니다.

7. 로그 폴더에 액세스할 자격 증명을 지정합니다. 이전에 패키지 액세스 자격 증명에 대한 값을 입력한 경우(위 참조) 패키지 액세스 자격 증명 검사 상자를 선택하여 다시 사용할 수 있습니다. 그렇지 않으면 Do기본, 사용자 이름 및 암호 상자에 로깅 액세스 자격 증명에 대한 값을 입력합니다. 예를 들어 Azure Files에 로그를 저장하는 경우 도메인은 Azure, 사용자 이름은 <storage account name>, 암호는 <storage account key>입니다. 또는 Azure Key Vault에 저장된 비밀을 해당 값으로 사용할 수 있습니다(위 참조).

앞에서 언급한 모든 UNC 경로에 대해 정규화된 파일 이름은 260자 미만이어야 합니다. 디렉터리 이름은 248자 미만이어야 합니다.

패키지 위치: 파일 시스템(프로젝트)

파일 시스템(프로젝트)을 패키지 위치로 선택하는 경우 다음 단계를 완료합니다.

1. 프로젝트 경로 상자에 프로젝트 파일(포함.ispac)에 대한 UNC 경로를 제공하고 패키지 이름 상자에 프로젝트에서 패키지 파일(포함.dtsx)을 제공하여 실행할 패키지를 지정합니다. 파일 스토리지 찾아보기를 선택하여 프로젝트를 찾아보고 선택하거나 경로를 수동으로 입력할 수 있습니다. 예를 들어 Azure Files에 프로젝트를 저장하는 경우 해당 경로는 다음과 같습니다 \\<storage account name>.file.core.windows.net\<file share name>\<project name>.ispac.

2. 프로젝트 및 패키지 파일에 액세스할 자격 증명을 지정합니다. 이전에 패키지 실행 자격 증명(Windows 인증용)을 입력한 경우 패키지 실행 자격 증명과 동일함 확인란을 선택하여 다시 사용할 수 있습니다. 그렇지 않은 경우 도메인, 사용자 이름 및 암호 상자에 패키지 액세스 자격 증명 값을 입력합니다. 예를 들어 Azure Files에 프로젝트 및 패키지를 저장하는 경우 도메인은 Azure, 사용자 이름은 <storage account name>, 암호는 <storage account key>입니다.

   또는 Azure Key Vault에 저장된 비밀을 해당 값으로 사용할 수 있습니다. 이렇게 하려면 옆에 있는 AZURE KEY VAULT 검사 상자를 선택합니다. 기존 키 자격 증명 모음 연결된 서비스를 선택 또는 편집하거나 새로 만듭니다. 그런 다음, 값의 비밀 이름 및 버전을 선택합니다. 키 자격 증명 모음 연결된 서비스를 만들거나 편집할 때 기존 키 자격 증명 모음을 선택하거나 편집하거나 새 키 자격 증명 모음을 만들 수 있습니다. 아직 키 자격 증명 모음에 대한 액세스 권한을 Data Factory 관리 ID에 부여해야 합니다. <key vault linked service name>/<secret name>/<secret version> 형식으로 비밀을 직접 입력할 수도 있습니다.

   이러한 자격 증명은 동일한 프로젝트에서 참조되는 패키지 실행 태스크에서 자식 패키지에 액세스하는 데도 사용됩니다.

3. SSDT를 통해 패키지를 만들 때 EncryptAllWithPassword 또는 EncryptSensitiveWithPassword 보호 수준을 사용한 경우 암호화 암호 상자에 암호의 값을 입력합니다. 또는 Azure Key Vault에 저장된 비밀을 해당 값으로 사용할 수 있습니다(위의 내용 참조).

   EncryptSensitiveWithUserKey 보호 수준을 사용한 경우 SSIS 매개 변수, 연결 관리자 또는 속성 재정의 탭에서 중요한 값을 다시 입력합니다(아래 참조).

   EncryptAllWithUserKey 보호 수준을 사용하는 경우 지원되지 않습니다. SSDT 또는 dtutil 명령줄 유틸리티를 통해 다른 보호 수준을 사용하도록 패키지를 다시 구성해야 합니다.

4. 로깅 수준에서 패키지 실행에 대해 사전 정의된 로깅 범위를 선택합니다. 사용자 지정된 로깅 이름을 대신 입력하려면 사용자 지정된 검사 상자를 선택합니다.

5. 패키지에 지정할 수 있는 표준 로그 공급자를 사용하지 않고 패키지 실행을 기록하려면 로깅 경로 상자에 UNC 경로를 제공하여 로그 폴더를 지정합니다. 파일 저장소 찾아보기를 선택하여 로그 폴더를 찾아서 선택하거나 경로를 수동으로 입력할 수 있습니다. 예를 들어 Azure Files에 로그를 저장하는 경우 로깅 경로는 \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>입니다. 각 개별 패키지 실행에 대해 이 경로에 하위 폴더가 만들어지고, SSIS 패키지 실행 작업 실행 ID에 따라 이름이 지어지며, 로그 파일이 5분마다 생성됩니다.

6. 로그 폴더에 액세스할 자격 증명을 지정합니다. 이전에 패키지 액세스 자격 증명에 대한 값을 입력한 경우(위 참조) 패키지 액세스 자격 증명 검사 상자를 선택하여 다시 사용할 수 있습니다. 그렇지 않으면 Do기본, 사용자 이름 및 암호 상자에 로깅 액세스 자격 증명에 대한 값을 입력합니다. 예를 들어 Azure Files에 로그를 저장하는 경우 도메인은 Azure, 사용자 이름은 <storage account name>, 암호는 <storage account key>입니다. 또는 Azure Key Vault에 저장된 비밀을 해당 값으로 사용할 수 있습니다(위 참조).

앞에서 언급한 모든 UNC 경로에 대해 정규화된 파일 이름은 260자 미만이어야 합니다. 디렉터리 이름은 248자 미만이어야 합니다.

패키지 위치: 포함된 패키지

패키지 위치로 Embedded 패키지를 선택하는 경우 다음 단계를 완료합니다.

1. 패키지 파일(.dtsx 포함)을 끌어다 놓거나 파일 폴더에서 제공된 상자로 업로드합니다. 패키지가 자동으로 압축되고 작업 페이로드에 포함됩니다. 포함된 후에는 나중에 편집을 위해 패키지를 다운로드할 수 있습니다. 또한 여러 작업에서 사용할 수 있는 파이프라인 매개 변수에 할당하여 포함된 패키지를 매개 변수화할 수 있으며, 이를 통해 파이프라인 페이로드의 크기를 최적화합니다. 프로젝트 파일(.ispac 포함)을 포함하는 기능은 현재 지원되지 않으므로 포함된 패키지의 프로젝트 수준 범위에서 SSIS 매개 변수/연결 관리자를 사용할 수 없습니다.

2. 포함된 패키지가 모두 암호화되지 않고 EPT(패키지 실행 태스크) 사용이 감지되면 패키지 실행 태스크 검사 상자가 자동으로 선택되고 파일 시스템 경로에서 참조하는 자식 패키지가 자동으로 추가되므로 포함할 수도 있습니다.

   EPT 사용을 감지할 수 없는 경우 패키지 실행 태스크 확인란을 수동으로 선택하고 파일 시스템 경로에서 참조하는 자식 패키지를 하나씩 추가해야 이를 포함할 수 있습니다. 자식 패키지가 MSDB(SQL Server 데이터베이스)에 저장된 경우 포함할 수 없으므로 Azure-SSIS IR이 MSDB에 액세스하여 SQL Server 참조를 사용하여 가져올 수 있는지 확인해야 합니다. 프로젝트 파일 포함(포함 .ispac)은 현재 지원되지 않으므로 자식 패키지에 대한 프로젝트 기반 참조를 사용할 수 없습니다.

3. SSDT를 통해 패키지를 만들 때 EncryptAllWithPassword 또는 EncryptSensitiveWithPassword 보호 수준을 사용한 경우 암호화 암호 상자에 암호의 값을 입력합니다.

   또는 Azure Key Vault에 저장된 비밀을 해당 값으로 사용할 수 있습니다. 이렇게 하려면 옆에 있는 AZURE KEY VAULT 확인란을 선택합니다. 기존 키 자격 증명 모음 연결된 서비스를 선택 또는 편집하거나 새로 만듭니다. 그런 다음, 값의 비밀 이름 및 버전을 선택합니다. 키 자격 증명 모음 연결된 서비스를 만들거나 편집할 때 기존 키 자격 증명 모음을 선택하거나 편집하거나 새 키 자격 증명 모음을 만들 수 있습니다. 아직 키 자격 증명 모음에 대한 액세스 권한을 Data Factory 관리 ID에 부여해야 합니다. <key vault linked service name>/<secret name>/<secret version> 형식으로 비밀을 직접 입력할 수도 있습니다.

   EncryptSensitiveWithUserKey 보호 수준을 사용한 경우 구성 파일 또는 SSIS 매개 변수, 연결 관리자 또는 속성 재정의 탭에서 중요한 값을 다시 입력합니다(아래 참조).

   EncryptAllWithUserKey 보호 수준을 사용하는 경우 지원되지 않습니다. SSDT 또는 dtutil 명령줄 유틸리티를 통해 다른 보호 수준을 사용하도록 패키지를 다시 구성해야 합니다.

4. 로깅 수준에서 패키지 실행에 대해 사전 정의된 로깅 범위를 선택합니다. 사용자 지정된 로깅 이름을 대신 입력하려면 사용자 지정된 검사 상자를 선택합니다.

5. 패키지에 지정할 수 있는 표준 로그 공급자를 사용하지 않고 패키지 실행을 기록하려면 로깅 경로 상자에 UNC 경로를 제공하여 로그 폴더를 지정합니다. 파일 저장소 찾아보기를 선택하여 로그 폴더를 찾아서 선택하거나 경로를 수동으로 입력할 수 있습니다. 예를 들어 Azure Files에 로그를 저장하는 경우 로깅 경로는 \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>입니다. 각 개별 패키지 실행에 대해 이 경로에 하위 폴더가 만들어지고, SSIS 패키지 실행 작업 실행 ID에 따라 이름이 지어지며, 로그 파일이 5분마다 생성됩니다.

6. Do기본, 사용자 이름 및 암호 상자에 값을 입력하여 로그 폴더에 액세스할 자격 증명을 지정합니다. 예를 들어 Azure Files에 로그를 저장하는 경우 도메인은 Azure, 사용자 이름은 <storage account name>, 암호는 <storage account key>입니다. 또는 Azure Key Vault에 저장된 비밀을 해당 값으로 사용할 수 있습니다(위 참조).

앞에서 언급한 모든 UNC 경로에 대해 정규화된 파일 이름은 260자 미만이어야 합니다. 디렉터리 이름은 248자 미만이어야 합니다.

패키지 위치: 패키지 저장소

패키지 위치로 패키지 저장소를 선택한 경우 다음 단계를 완료합니다.

1. 패키지 저장소 이름의 경우 Azure-SSIS IR에 연결된 기존 패키지 저장소를 선택합니다.

2. 패키지 경로 상자의 선택한 패키지 저장소 에서 경로를 제공하여 실행할 패키지를 지정합니다(제외.dtsx). 선택한 패키지 저장소가 파일 시스템/Azure Files 맨 위에 있는 경우 파일 스토리지 찾아보기를 선택하여 패키지를 찾아 선택할 수 있습니다. 그렇지 않으면 해당 경로를 형식<folder name>\<package name>으로 입력할 수 있습니다. 레거시 SSIS 패키지 저장소와 유사한 SSMS(SQL Server Management Studio)를 통해 선택한 패키지 저장소로 새 패키지를 가져올 수도 있습니다. 자세한 내용은 Azure-SSIS IR 패키지 저장소를 사용하여 SSIS 패키지 관리를 참조 하세요.

3. 별도의 파일에서 패키지를 구성하는 경우 구성 경로 상자에 구성 파일(포함 .dtsConfig)에 대한 UNC 경로를 제공해야 합니다. 파일 스토리지 찾아보기를 선택하여 구성을 찾아보고 선택하거나 경로를 수동으로 입력할 수 있습니다. 예를 들어 Azure Files에 구성을 저장하는 경우 해당 경로는 다음과 같습니다 \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.

4. 구성 액세스 자격 증명 확인란을 선택하여 구성 파일에 액세스하기 위한 자격 증명을 별도로 지정할지 여부를 선택합니다. 선택한 패키지 저장소가 Azure SQL Managed Instance에서 호스트하는 MSDB(SQL Server 데이터베이스) 위에 있거나 구성 파일도 저장하지 않는 경우에 필요합니다.

   이전에 패키지 실행 자격 증명(Windows 인증용)을 입력한 경우 패키지 실행 자격 증명과 동일함 확인란을 선택하여 다시 사용할 수 있습니다. 그렇지 않은 경우 Do기본, 사용자 이름 및 암호 상자에 구성 액세스 자격 증명에 대한 값을 입력합니다. 예를 들어 Azure Files에 구성을 저장하는 경우 do기본는 Azure사용자 이름<storage account name>이며 암호는 다음과 같습니다<storage account key>.

   또는 Azure Key Vault에 저장된 비밀을 해당 값으로 사용할 수 있습니다. 이렇게 하려면 옆에 있는 AZURE KEY VAULT 검사 상자를 선택합니다. 기존 키 자격 증명 모음 연결된 서비스를 선택 또는 편집하거나 새로 만듭니다. 그런 다음, 값의 비밀 이름 및 버전을 선택합니다. 키 자격 증명 모음 연결된 서비스를 만들거나 편집할 때 기존 키 자격 증명 모음을 선택하거나 편집하거나 새 키 자격 증명 모음을 만들 수 있습니다. 아직 키 자격 증명 모음에 대한 액세스 권한을 Data Factory 관리 ID에 부여해야 합니다. <key vault linked service name>/<secret name>/<secret version> 형식으로 비밀을 직접 입력할 수도 있습니다.

5. SSDT를 통해 패키지를 만들 때 EncryptAllWithPassword 또는 EncryptSensitiveWithPassword 보호 수준을 사용한 경우 암호화 암호 상자에 암호의 값을 입력합니다. 또는 Azure Key Vault에 저장된 비밀을 해당 값으로 사용할 수 있습니다(위의 내용 참조).

   EncryptSensitiveWithUserKey 보호 수준을 사용한 경우 구성 파일 또는 SSIS 매개 변수, 연결 관리자 또는 속성 재정의 탭에서 중요한 값을 다시 입력합니다(아래 참조).

   EncryptAllWithUserKey 보호 수준을 사용하는 경우 지원되지 않습니다. SSDT 또는 dtutil 명령줄 유틸리티를 통해 다른 보호 수준을 사용하도록 패키지를 다시 구성해야 합니다.

6. 로깅 수준에서 패키지 실행에 대해 사전 정의된 로깅 범위를 선택합니다. 사용자 지정된 로깅 이름을 대신 입력하려면 사용자 지정된 검사 상자를 선택합니다.

7. 패키지에 지정할 수 있는 표준 로그 공급자를 사용하지 않고 패키지 실행을 기록하려면 로깅 경로 상자에 UNC 경로를 제공하여 로그 폴더를 지정합니다. 파일 저장소 찾아보기를 선택하여 로그 폴더를 찾아서 선택하거나 경로를 수동으로 입력할 수 있습니다. 예를 들어 Azure Files에 로그를 저장하는 경우 로깅 경로는 \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>입니다. 각 개별 패키지 실행에 대해 이 경로에 하위 폴더가 만들어지고, SSIS 패키지 실행 작업 실행 ID에 따라 이름이 지어지며, 로그 파일이 5분마다 생성됩니다.

8. Do기본, 사용자 이름 및 암호 상자에 값을 입력하여 로그 폴더에 액세스할 자격 증명을 지정합니다. 예를 들어 Azure Files에 로그를 저장하는 경우 도메인은 Azure, 사용자 이름은 <storage account name>, 암호는 <storage account key>입니다. 또는 Azure Key Vault에 저장된 비밀을 해당 값으로 사용할 수 있습니다(위 참조).

앞에서 언급한 모든 UNC 경로에 대해 정규화된 파일 이름은 260자 미만이어야 합니다. 디렉터리 이름은 248자 미만이어야 합니다.

SSIS 매개 변수 탭

SSIS 패키지 실행 작업의 SSIS 매개 변수 탭에서 다음 단계를 완료합니다.

1. Azure-SSIS IR이 실행 중이면 SSISDB가 패키지 위치로 선택되고 설정 탭의 수동 항목 검사 상자가 지워지면 SSISDB에서 선택한 프로젝트 및 패키지의 기존 SSIS 매개 변수가 표시되어 값을 할당할 수 있습니다. 그렇지 않으면 하나씩 입력하여 값을 수동으로 할당할 수 있습니다. 패키지를 성공적으로 실행하려면 값을 올바르게 입력했는지 확인합니다.

2. SSDT를 통해 패키지를 만들 때 EncryptSensitiveWithUserKey 보안 수준을 사용하고 파일 시스템(패키지), 파일 시스템(프로젝트), 포함된 패키지 또는 패키지 저장소가 패키지 위치로 선택된 경우 이 탭에서 중요한 매개 변수를 다시 입력하고 값을 할당할 수 있습니다.

매개 변수에 값을 할당할 때 식, 함수, Data Factory 시스템 변수 및 Data Factory 파이프라인 매개 변수 또는 변수를 사용하여 동적 콘텐츠를 추가할 수 있습니다.

또는 Azure Key Vault에 저장된 비밀을 해당 값으로 사용할 수 있습니다. 이렇게 하려면 옆에 있는 AZURE KEY VAULT 검사 상자를 선택합니다. 기존 키 자격 증명 모음 연결된 서비스를 선택 또는 편집하거나 새로 만듭니다. 그런 다음, 값의 비밀 이름 및 버전을 선택합니다. 키 자격 증명 모음 연결된 서비스를 만들거나 편집할 때 기존 키 자격 증명 모음을 선택하거나 편집하거나 새 키 자격 증명 모음을 만들 수 있습니다. 아직 키 자격 증명 모음에 대한 액세스 권한을 Data Factory 관리 ID에 부여해야 합니다. <key vault linked service name>/<secret name>/<secret version> 형식으로 비밀을 직접 입력할 수도 있습니다.

연결 관리자 탭

SSIS 패키지 실행 작업의 연결 관리자 탭에서 다음 단계를 완료합니다.

1. Azure-SSIS IR을 실행 중인 경우 패키지 위치로 SSISDB가 선택되고, 설정 탭의 수동 항목 확인란의 선택이 취소되고, SSISDB에서 선택한 프로젝트 및 패키지의 기존 연결 관리자가 표시되어 값을 속성에 할당할 수 있습니다. 그렇지 않은 경우 하나씩 입력하여 값을 속성에 수동으로 할당할 수 있습니다. 패키지를 성공적으로 실행하려면 값을 올바르게 입력했는지 확인합니다.

   SSDT에 포함된 패키지를 열어 연결 관리자에 대한 올바른 SCOPE, NAME 및 PROPERTY 이름을 가져올 수 있습니다. 패키지를 연 후 관련 연결 관리자를 선택하여 SSDT의 속성 창에 모든 속성의 이름과 값을 표시합니다. 이 정보를 사용하면 런타임에 연결 관리자 속성의 값을 재정의할 수 있습니다.

   

   예를 들어 SSDT에서 원래 패키지를 수정하지 않고 런타임에서 ConnectByProxy, ConnectionString 및 ConnectUsingManagedIdentity의 값을 재정의하여 SQL Server에서 실행되는 온-프레미스 간 데이터 흐름을 ADF의 SSIS IR에서 실행되는 온-프레미스에서 클라우드로의 데이터 흐름으로 변환할 수 있습니다.

   이러한 런타임 재정의는 온-프레미스 데이터에 액세스할 때 SSIS IR에 대한 프록시로 SHIR(자체 호스팅 IR)을 사용하도록 설정할 수 있습니다. SHIR을 SSIS IR의 프록시로 구성하고, ADF 관리 ID로 Microsoft Entra 인증을 사용하도록 설정하는 최신 MSOLEDBSQL 드라이버를 사용하여 Azure SQL Database/Managed Instance 연결을 참조하세요. OLEDB 연결에 대한 ADF 관리 ID로 Microsoft Entra 인증 구성을 참조 하세요.

   

2. SSDT 및 파일 시스템(패키지), 파일 시스템(프로젝트), 포함된 패키지 또는 패키지 저장소를 통해 패키지를 만들 때 EncryptSensitiveWithUserKey 보호 수준을 패키지 위치로 선택한 경우 중요한 연결 관리자 속성을 다시 입력하여 이 탭에서 값을 할당해야 합니다.

연결 관리자 속성에 값을 할당할 때 식, 함수, Data Factory 시스템 변수 및 Data Factory 파이프라인 매개 변수 또는 변수를 사용하여 동적 콘텐츠를 추가할 수 있습니다.

또는 Azure Key Vault에 저장된 비밀을 해당 값으로 사용할 수 있습니다. 이렇게 하려면 옆에 있는 AZURE KEY VAULT 검사 상자를 선택합니다. 기존 키 자격 증명 모음 연결된 서비스를 선택 또는 편집하거나 새로 만듭니다. 그런 다음, 값의 비밀 이름 및 버전을 선택합니다. 키 자격 증명 모음 연결된 서비스를 만들거나 편집할 때 기존 키 자격 증명 모음을 선택하거나 편집하거나 새 키 자격 증명 모음을 만들 수 있습니다. 아직 키 자격 증명 모음에 대한 액세스 권한을 Data Factory 관리 ID에 부여해야 합니다. <key vault linked service name>/<secret name>/<secret version> 형식으로 비밀을 직접 입력할 수도 있습니다.

속성 재정의 탭

SSIS 패키지 실행 작업의 속성 재정의 탭에서 다음 단계를 완료합니다.

1. 선택한 패키지에 기존 속성의 경로를 하나씩 입력하여 값을 수동으로 할당합니다. 패키지를 성공적으로 실행하려면 값을 올바르게 입력했는지 확인합니다. 예를 들어 사용자 변수의 값을 재정의하려면 해당 경로를 다음 형식 \Package.Variables[User::<variable name>].Value으로 입력합니다.

   SSDT에서 패키지가 포함된 패키지를 열어 패키지 속성에 대한 올바른 PROPERTY PATH 를 가져올 수 있습니다. 패키지가 열린 후 SSDT의 속성 창에서 해당 제어 흐름 및 구성 속성을 선택합니다. 그런 다음 Configurations 속성 옆에 있는 줄임표(...) 단추를 선택하여 일반적으로 패키지 배포 모델에서 패키지 구성을 만드는 데 사용되는 패키지 구성 도우미를 엽니다.

   

   패키지 구성 구성 도우미에서 패키지 구성 사용 검사 상자 및 추가... 단추를 선택하여 패키지 구성 마법사를 엽니다.

   패키지 구성 마법사의 구성 유형 드롭다운 메뉴에서 XML 구성 파일 항목을 선택한 다음, 직접 구성 설정 지정 단추를 선택하고, 구성 파일 이름을 입력하고, 다음 > 단추를 선택합니다.

   

   마지막으로 원하는 경로를 가진 패키지 속성을 선택하고 다음 > 단추를 선택합니다. 이제 원하는 패키지 속성 경로를 보고 복사하여 붙여넣고 구성 파일에 저장할 수 있습니다. 이 정보를 사용하면 런타임에 패키지 속성의 값을 재정의할 수 있습니다.

   

2. SSDT 및 파일 시스템(패키지), 파일 시스템(프로젝트), 포함된 패키지 또는 패키지 저장소를 통해 패키지를 만들 때 EncryptSensitiveWithUserKey 보호 수준을 패키지 위치로 선택한 경우 중요한 패키지 속성을 다시 입력하여 이 탭에서 값을 할당해야 합니다.

패키지 속성에 값을 할당할 때 식, 함수, Data Factory 시스템 변수 및 Data Factory 파이프라인 매개 변수 또는 변수를 사용하여 동적 콘텐츠를 추가할 수 있습니다.

구성 파일 및 SSIS 매개 변수 탭에 할당된 값은 연결 관리자 또는 속성 재정의 탭을 사용하여 재정의할 수 있습니다. 연결 관리자 탭에 할당된 값은 속성 재정의 탭을 사용하여 재정의할 수도 있습니다.

파이프라인 구성에 대한 유효성을 검사하려면 도구 모음에서 유효성 검사를 선택합니다. 파이프라인 유효성 검사 보고서를 닫려면 .를 선택합니다>>.

Data Factory에 파이프라인을 게시하려면 모두 게시를 선택합니다.

파이프라인 실행

이 단계에서는 파이프라인 실행을 트리거합니다.

1. 파이프라인 실행을 트리거하려면 도구 모음에서 트리거를 선택하고 지금 트리거를 선택합니다.

   

2. 파이프라인 실행 창에서 마침을 선택합니다.

파이프라인 모니터링

1. 왼쪽의 모니터 탭으로 전환합니다. 파이프라인 실행 및 해당 상태 실행 시작 시간과 같은 다른 정보와 함께 표시됩니다. 보기를 새로 고치려면 새로 고침을 선택합니다.

   

2. 작업 열에서 활동 실행 보기 링크를 선택합니다. 파이프라인에는 하나의 작업만 있으므로 하나의 작업 실행만 파이프라인으로 표시됩니다. SSIS 패키지 실행 작업입니다.

   

3. SQL Server의 SSISDB 데이터베이스에 대해 다음 쿼리를 실행하여 패키지가 실행되었는지 확인합니다.

   select * from catalog.executions
   

   

4. 또한 파이프라인 작업 실행의 출력에서 SSISDB 실행 ID를 가져오고 이 ID를 사용하여 SQL Server Management Studio에서 보다 포괄적인 실행 로그 및 오류 메시지를 검사 수 있습니다.

   

트리거를 사용하여 파이프라인 예약

파이프라인이 매시간 또는 매일과 같은 일정에 따라 실행되도록 파이프라인에 대해 예약된 트리거를 만들 수도 있습니다. 예를 들어 데이터 팩터리 만들기 - Data Factory UI를 참조 하세요.

관련 콘텐츠

• Azure Data Factory에서 PowerShell로 SSIS 패키지 실행 작업을 사용하여 SSIS 패키지 실행
• Azure Data Factory 파이프라인에서 SSIS 작업을 사용하여 ETL/ELT 워크플로 현대화 및 확장