다음을 통해 공유

패키지 실행 문제 해결 도구

  • 아티클

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

Integration Services에서는 패키지를 완성 및 배포한 후 실행할 때 패키지 문제를 해결하는 데 사용할 수 있는 기능 및 도구를 제공합니다.

디자인 타임에 SSDT(SQL Server Data Tools)는 패키지 실행, 진행률 창 및 데이터 뷰어를 일시 중지하여 데이터 흐름을 통과하는 데이터를 감시하는 중단점을 제공합니다. 그러나 배포된 패키지를 실행할 때는 이러한 기능을 사용할 수 없습니다. 배포된 패키지 문제를 해결하는 주요 기술은 다음과 같습니다.

  • 이벤트 처리기를 사용하여 패키지 오류를 catch하고 처리합니다.

  • 오류 출력을 사용하여 잘못된 데이터를 캡처합니다.

  • 로깅을 사용하여 패키지 실행 단계를 추적합니다.

다음 팁과 기술을 사용하여 패키지 실행 문제를 방지할 수도 있습니다.

이벤트 처리기를 사용하여 패키지 오류 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로 패키지 실행을 식별하지만 단일 목록의 대량 로깅 출력은 분석하기 어려울 수 있습니다.

    다음 방법은 기본 로깅 출력을 향상시키고 보고서를 더 쉽게 생성할 수 있도록 하는 한 가지 제안 사항입니다.

    1. 패키지의 각 실행을 기록하는 부모 테이블을 만듭니다. 이 부모 테이블은 각 패키지 실행에 대한 단일 행만 포함하며, ExecutionID를 사용하여 로깅 테이블의 자식 레코드에 연결합니다. 각 패키지의 시작 부분에서 SQL 실행 태스크를 사용하여 이 새 행을 만들고 시작 시간을 기록할 수 있습니다. 그런 다음 패키지의 끝에 있는 다른 SQL 실행 태스크를 사용하여 끝 시간, 기간 및 상태로 행을 업데이트할 수 있습니다.

    2. 데이터 흐름에 감사 정보를 추가합니다. 감사 변환을 사용하여 데이터 흐름의 행에 각 행을 만들었거나 수정한 패키지 실행에 대한 정보를 추가할 수 있습니다. 감사 변환을 통해 PackageName 및 ExecutionInstanceGUID를 비롯한 9가지 정보를 사용할 수 있습니다. 자세한 내용은 Audit Transformation을 참조하세요. 감사를 위해 각 행에 포함하려는 사용자 지정 정보가 있는 경우 파생 열 변환을 사용하여 데이터 흐름의 행에 이 정보를 추가할 수 있습니다. 자세한 내용은 파생 열 변환을 참조하세요.

    3. 행 개수 데이터를 캡처하는 것이 좋습니다. 각 패키지 실행 인스턴스가 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 오류 및 메시지 참조에서 오류 번호로 조회하여 해당 오류에 대한 설명을 찾을 수 있습니다. 이 목록에는 현재 문제 해결 정보는 들어 있지 않습니다.

데이터 흐름 디버깅