패키지 실행 문제 해결 도구
적용 대상: 
SQL Server Azure Data Factory의 SSIS Integration Runtime
Integration Services에서는 패키지를 완성 및 배포한 후 실행할 때 패키지 문제를 해결하는 데 사용할 수 있는 기능 및 도구를 제공합니다.
디자인 타임에 SSDT(SQL Server Data Tools)는 패키지 실행, 진행률 창 및 데이터 뷰어를 일시 중지하여 데이터 흐름을 통과하는 데이터를 감시하는 중단점을 제공합니다. 그러나 배포된 패키지를 실행할 때는 이러한 기능을 사용할 수 없습니다. 배포된 패키지 문제를 해결하는 주요 기술은 다음과 같습니다.
이벤트 처리기를 사용하여 패키지 오류를 catch하고 처리합니다.
오류 출력을 사용하여 잘못된 데이터를 캡처합니다.
로깅을 사용하여 패키지 실행 단계를 추적합니다.
다음 팁과 기술을 사용하여 패키지 실행 문제를 방지할 수도 있습니다.
트랜잭션을 사용하여 데이터 무결성을 보장하는 데 도움이 됩니다. 자세한 내용은 Integration Services 트랜잭션을 참조하세요.
검사점을 사용하여 실패 지점에서 패키지를 다시 시작합니다. 자세한 내용은 검사점을 사용하여 패키지 다시 시작을 참조하세요.
이벤트 처리기를 사용하여 패키지 오류 Catch 및 처리
이벤트 처리기를 사용하여 패키지 및 패키지의 개체에서 발생하는 많은 이벤트에 응답할 수 있습니다.
- OnError 이벤트의 이벤트 처리기 만들기 이벤트 처리기에서 메일 보내기 작업을 사용하여 관리자에게 오류를 알리거나, 스크립트 태스크 및 사용자 지정 논리를 사용하여 문제 해결을 위한 시스템 정보를 가져오거나, 임시 리소스 또는 불완전한 출력을 정리할 수 있습니다. 자세한 내용은 Integration Services(SSIS) 이벤트 처리기를 참조하세요.
오류 출력을 사용하여 잘못된 데이터 문제 해결
여러 데이터 흐름 구성 요소에서 사용할 수 있는 오류 출력을 통해 오류가 들어 있는 행을 나중에 분석할 수 있도록 별도의 대상으로 보낼 수 있습니다. 자세한 내용은 데이터에서 오류 처리를 참조하세요.
오류 출력을 사용하여 잘못된 데이터를 캡처합니다. 오류가 포함된 행을 오류 테이블 또는 텍스트 파일과 같은 별도의 대상으로 보냅니다. 오류 출력은 행이 거부된 오류의 수와 오류가 발생한 열의 ID를 포함하는 두 개의 숫자 열을 자동으로 추가합니다.
오류 출력에 친숙한 정보를 추가합니다. 오류 출력에서 제공하는 두 개의 숫자 식별자 외에도 오류 메시지와 열 이름을 추가하여 오류 출력을 보다 쉽게 분석할 수 있습니다. 스크립팅을 사용하여 이러한 두 열을 추가하는 방법에 대한 예제는 스크립트 구성 요소를 사용하여 오류 출력 향상을 참조하세요.
또는 DiagnosticEx 이벤트를 로깅하여 열 이름을 가져옵니다. 이 이벤트는 로그에 데이터 흐름 계보 맵을 씁니다. 그런 다음 오류 출력에 의해 캡처된 열 식별자를 사용하여 이 계보 맵에서 열 이름을 조회할 수 있습니다. 자세한 내용은 데이터에서 오류 처리를 참조하세요.
DiagnosticEx에 대한 메시지 열의 값은 XML 텍스트입니다. 패키지 실행에 대한 메시지 텍스트를 보려면 catalog.operation_messages(SSISDB 데이터베이스) 보기를 쿼리합니다. DiagnosticEx 이벤트는 로그 크기를 줄이기 위해 XML 출력에 공백을 유지하지 않습니다. 가독성을 높이기 위해 XML 서식 지정 및 구문 강조를 지원하는 XML 편집기(예: Visual Studio)로 로그를 복사합니다.
작업 보고서를 사용하여 패키지 실행 문제 해결
SQL Server Integration Services의 현재 릴리스에서는 Integration Services 카탈로그에 배포된 Integration Services 패키지를 모니터링하고 문제를 해결하는 데 도움이 되는 표준 보고서를 SQL Server Management Studio에서 사용할 수 있습니다. 이러한 패키지 보고서는 패키지 상태 및 기록을 보고 필요한 경우 실패 원인을 파악하는 데 도움이 됩니다.
자세한 내용은 패키지 실행을 위한 문제 해결 보고서를 참조하세요.
SSISDB 뷰를 사용하여 패키지 실행 문제 해결
패키지 실행 및 기타 작업 정보를 모니터링하기 위해 쿼리할 수 있는 여러 SSISDB 데이터베이스 뷰를 사용할 수 있습니다. 자세한 내용은 실행 중인 패키지 및 기타 작업 모니터링을 참조하세요.
로깅을 사용하여 패키지 실행 문제 해결
로깅을 사용하여, 실행 중인 패키지에서 발생하는 문제를 대부분 추적할 수 있습니다. 로그 공급자는 나중에 분석하기 위해 지정된 이벤트에 대한 정보를 캡처하고 해당 정보를 데이터베이스 테이블, 플랫 파일, XML 파일 또는 지원되는 다른 출력 형식에 저장합니다.
로깅 설정 이벤트만 선택하고 캡처하려는 정보 항목만 선택하여 로깅 출력을 구체화할 수 있습니다. 자세한 내용은 SSIS(Integration Services) 로깅을 참조하세요.
공급자 문제를 해결하려면 패키지의 진단 이벤트를 선택합니다. 패키지와 외부 데이터 원본의 상호 작용 문제를 해결하는 데 도움이 되는 로깅 메시지가 있습니다. 자세한 내용은 도구 패키지 연결 문제 해결을 참조하세요.
기본 로깅 출력을 향상시킵니다. 로깅은 일반적으로 패키지를 실행할 때마다 로깅 대상에 행을 추가합니다. 로깅 출력의 각 행은 해당 이름과 고유 식별자를 사용하여 패키지를 식별하고 고유한 ExecutionID로 패키지 실행을 식별하지만 단일 목록의 대량 로깅 출력은 분석하기 어려울 수 있습니다.
다음 방법은 기본 로깅 출력을 향상시키고 보고서를 더 쉽게 생성할 수 있도록 하는 한 가지 제안 사항입니다.
패키지의 각 실행을 기록하는 부모 테이블을 만듭니다. 이 부모 테이블은 각 패키지 실행에 대한 단일 행만 포함하며, ExecutionID를 사용하여 로깅 테이블의 자식 레코드에 연결합니다. 각 패키지의 시작 부분에서 SQL 실행 태스크를 사용하여 이 새 행을 만들고 시작 시간을 기록할 수 있습니다. 그런 다음 패키지의 끝에 있는 다른 SQL 실행 태스크를 사용하여 끝 시간, 기간 및 상태로 행을 업데이트할 수 있습니다.
데이터 흐름에 감사 정보를 추가합니다. 감사 변환을 사용하여 데이터 흐름의 행에 각 행을 만들었거나 수정한 패키지 실행에 대한 정보를 추가할 수 있습니다. 감사 변환을 통해 PackageName 및 ExecutionInstanceGUID를 비롯한 9가지 정보를 사용할 수 있습니다. 자세한 내용은 Audit Transformation을 참조하세요. 감사를 위해 각 행에 포함하려는 사용자 지정 정보가 있는 경우 파생 열 변환을 사용하여 데이터 흐름의 행에 이 정보를 추가할 수 있습니다. 자세한 내용은 파생 열 변환을 참조하세요.
행 개수 데이터를 캡처하는 것이 좋습니다. 각 패키지 실행 인스턴스가 ExecutionID로 식별되는 행 개수 정보에 대한 별도의 테이블을 만드는 것이 좋습니다. 행 개수 변환을 사용하여 데이터 흐름의 중요한 지점에서 일련의 변수에 행 수를 저장합니다. 데이터 흐름이 종료된 후 SQL 실행 태스크를 사용하여 이후 분석 및 보고를 위해 테이블의 행에 일련의 값을 삽입합니다.
이 방법에 대한 자세한 내용은 Microsoft 백서 Project REAL: Business Intelligence ETL 디자인 사례의 "ETL 감사 및 로깅" 섹션을 참조하세요.
디버그 덤프 파일을 사용하여 패키지 실행 문제 해결
Integration Services에서 패키지 실행에 대한 정보를 제공하는 디버그 덤프 파일을 만들 수 있습니다. 디버그 덤프 파일에 대한 자세한 내용은 Generating Dump Files for Package Execution을 참조하십시오.
런타임 유효성 검사 문제 해결
데이터 원본에 연결할 수 없거나 패키지의 이전 태스크가 실행 완료되기 전까지 패키지의 일부에 대해 유효성을 검사할 수 없는 경우가 있습니다. Integration Services에는 이러한 조건에서 발생하는 유효성 검사 오류를 방지하는 데 도움이 되는 다음 기능이 포함되어 있습니다.
패키지가 로드될 때 유효하지 않은 패키지 요소에서 DelayValidation 속성을 구성합니다. 패키지가 로드될 때 유효성 검사 오류를 방지하기 위해 구성이 유효하지 않은 패키지 요소에서 DelayValidation을 True로 설정할 수 있습니다. 예를 들어 SQL 실행 태스크가 런타임에 테이블을 만들 때까지 존재하지 않는 대상 테이블을 사용하는 데이터 흐름 태스크가 있을 수 있습니다. DelayValidation 속성은 패키지 수준 또는 패키지에 포함된 개별 작업 및 컨테이너 수준에서 사용하도록 설정할 수 있습니다.
DelayValidation 속성은 데이터 흐름 태스크에서 설정할 수 있지만 개별 데이터 흐름 구성 요소는 설정할 수 없습니다. 개별 데이터 흐름 구성 요소의 ValidateExternalMetadata 속성을 false로 설정하면 비슷한 효과를 얻을 수 있습니다. 그러나 이 속성의 값이 false이면 구성 요소는 외부 데이터 원본의 메타데이터 변경 내용을 인식하지 않습니다. true로 설정하면 이 ValidateExternalMetadata속성은 특히 패키지가 트랜잭션을 사용하는 경우 데이터베이스 잠금으로 인한 차단 문제를 방지하는 데 도움이 될 수 있습니다.
런타임 권한 문제 해결
SQL Server 에이전트를 사용하여 배포된 패키지를 실행하려고 할 때 오류가 발생하면 에이전트에서 사용하는 계정에 필요한 권한이 없을 수 있습니다. SQL Server 에이전트 작업에서 실행한 패키지의 문제를 해결하는 방법은 SQL Server 에이전트 작업 단계에서 SSIS 패키지를 호출할 때 SSIS 패키지가 실행되지 않음을 참조하세요. SQL Server 에이전트에 대한 자세한 내용은 패키지에 대한 SQL Server 에이전트 작업을 참조하세요.
Excel 또는 Access 데이터 원본에 연결하려면 에이전트에 TEMP 및 TMP 환경 변수로 지정되는 폴더에서 임시 파일을 읽고, 쓰고, 만들고, 삭제할 수 있는 사용 권한을 가진 계정이 있어야 합니다.
64비트 문제 해결
- 일부 데이터 공급자는 64비트 플랫폼에서 사용할 수 없습니다. 특히 Excel 또는 Access 데이터 원본에 연결하는 데 필요한 Microsoft Jet OLE DB 공급자는 64비트 버전에서 사용할 수 없습니다.
설명 없이 오류 문제 해결
설명이 없는 오류가 발생할 경우 Integration Services 오류 및 메시지 참조에서 오류 번호로 조회하여 해당 오류에 대한 설명을 찾을 수 있습니다. 이 목록에는 현재 문제 해결 정보는 들어 있지 않습니다.