SQL Server/SQL Server Tip

SSIS 실행 로그 남기기

SungWookKang 2015. 11. 9. 13:08
반응형

SSIS 실행 로그 남기기

 

  • Version : SSIS Server 2005, 2008, 2008R2, 2012, 2014, 2015

 

SSIS 패키지를 운영할 때 중요한 요소 중 하나는 로깅이다. SSIS에서는 다양한 로깅 방법을 지원한다.

  • 텍스트 파일 – 가장 기본적인 로깅
  • SQL Server 테이블 – 가장 큰 장점은 쉽게 로그 결과를 조회할 수 있다.
  • SQL Server 프로파일러 – 이벤트 프로파일 캡처할 수 있다. 추적에 기록된다.
  • Windows 이벤트 로그
  • XML 파일

 

[SQL Server 테이블에 로깅]

SQL Server 테이블에 로깅하는 방법에 대해서 알아본다. (다른 옵션들을 선택해도 설정 방법은 유사하기 때문에 응용하여 사용할 수 있다.) 로깅을 테스트하기 위해 SSIS 제어흐름에서 SQL 실행 작업과 매우 간단한 패키지를 생성하였다. 이 SQL 구문은 0으로 나누기하여 오류를 발생시키도록 하였다.

 

제어흐름에서 마우스 오른쪽 버튼을 클릭하고 로깅을 선택하거나 작업표시줄에서 SSIS 메뉴로 이동하여 로깅을 선택한다.

 

로깅의 공급자 메뉴에서SSIS log provider for SQL Server 을 선택한다.

 

 

로그 공급자를 추가한다. 하나의 패키지에 여러 공급자를 추가하는 것이 가능하다. 로그 테이블을 유지하려는 데이터베이스 연결관리자를 지정한다. 테이블을 지정하는 것은 불가능하다. SSIS에서는 특정 이름으로 테이블을 자동으로 생성한다.

 

 

작업의 왼쪽 창에서 작업을 취소하여 구성할 수 있다. 오른쪽 창에서 로그 공급자를 선택해야 한다.

 

 

마지막 단계는 로그 공급자가 SQL Server에 기록할 이벤트를 선택한다. 세부정보는 아래 탭에서 선택할 수 있다.

 

설정이 완료되면 SSIS는 dbo.sysssislog 이름으로 데이터베이스에 테이블을 생성한다.

 

각 열의 정의는 다음과 같다.

  • ID : 테이블의 기본 ID 열 (기본키)
  • Event : 로그 이벤트 유형 (예: OnError)
  • Computer : 패키지를 실행한 호스트명
  • Operator : 패키지를 실행한 사용자 ID
  • Source : 이벤트를 생성한 작업 또는 패키지명
  • Sourceid : 소스 작업 도는 패키지의 GUID
  • Executionid : 패키지를 실행한 GUID
  • Starttime : 작업의 시작시간
  • Endtime : 작업의 종료 시간
  • Datacode : 태스크 또는 컨테이너의 실행 결과를 포함할 수 있는 임의의 번호 (예 0 성공, 1 실패)
  • Databytes : 로그메시지에 대한 바이트 배열
  • Message : 로그 이벤트 메시지

 

로그 테이블 조회는 아래 스크립트로 확인할 수 있다.

SELECT

     [event]

    ,[computer]

    ,[operator]

    ,[source]

    ,[starttime]

    ,[endtime]

    ,[message]

FROM [dbo].[sysssislog];

 

 

[스크립트 작업에서 로깅]

일부 작업은 특정이벤트가 포함되어 있는 경우가 있다. 스크립트 작업에서도 ScriptTaskLogEntry 이벤트를 사용하여 로깅을할 수 있다.

 

실제로 스크립트 작업에서 로깅하려면 세개의 매개 변수를 받아들이는 Dts.log 이벤트를 사용한다.

  • Log message
  • Datacode
  • Databytes

 

첫 번째 값은 매우 중요하여 나머지 두 값은 더미 값이 될 수 있다.

 

패키지를 실행할 때 로깅 테이블에서 사용자 지정 로그를 확인할 수 있다.

 

 

[참고자료]

https://www.mssqltips.com/sqlservertip/4070/integrated-logging-with-the-integration-services-package-log-providers/

 

2015-11-09 / 강성욱 / http://sqlmvp.kr

 

 

MS SQL Server, MS SQL, SSIS, SSIS 로깅, Integrated Logging, SQL Server Integration Services,ETL, BI

반응형