오류 메시지 전송 태스크

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

오류 메시지 이동 작업은 SQL Server 인스턴스 간에 하나 이상의 SQL Server 사용자 정의 오류 메시지를 이동합니다. 사용자 정의 메시지는 식별자가 50000보다 크거나 같은 메시지입니다. 50000보다 작은 식별자를 가진 메시지는 시스템 오류 메시지이며 오류 메시지 전송 태스크를 사용하여 전송할 수 없습니다.

오류 메시지 이동 작업은 모든 오류 메시지 또는 지정된 오류 메시지만 이동하도록 구성할 수 있습니다. 사용자 정의 오류 메시지는 다양한 언어로 사용할 수 있으며 선택한 언어로 된 메시지만 이동하도록 작업을 구성할 수 있습니다. 다른 언어 버전의 메시지를 대상 서버로 전송하려면 해당 서버에 1033 코드 페이지를 사용하는 us_english 버전의 메시지가 있어야 합니다.

Master 데이터베이스의 sysmessages 테이블에는 시스템 및 사용자 정의 오류 메시지를 포함하여 SQL Server에서 사용하는 모든 오류 메시지가 들어 있습니다.

이동할 사용자 정의 메시지가 대상에 이미 있을 수도 있습니다. 식별자와 언어가 같으면 오류 메시지가 중복 오류 메시지로 정의됩니다. 오류 메시지 이동 작업은 다음과 같은 방법으로 기존 오류 메시지를 처리하도록 구성할 수 있습니다.

  • 기존 오류 메시지를 덮어씁니다.

  • 중복 메시지가 있는 경우 작업을 실패합니다.

  • 중복 오류 메시지를 건너뜁니다.

오류 메시지 이동 작업은 런타임에 한 개 또는 두 개의 SMO 연결 관리자를 사용해 원본 서버 및 대상 서버에 연결합니다. SMO 연결 관리자는 오류 메시지 전송 작업과 별도로 구성된 다음 오류 메시지 전송 작업에서 참조됩니다. SMO 연결 관리자는 작업이 서버에 액세스할 때 사용할 서버 및 인증 모드를 지정합니다. 자세한 내용은 SMO Connection Manager을 참조하세요.

오류 메시지 이동 작업은 SQL Server 소스 및 대상을 지원합니다. 원본 또는 대상으로 사용할 버전에는 제한이 없습니다.

이벤트

작업은 이동된 오류 메시지 수를 보고하는 정보 이벤트를 발생합니다.

오류 메시지 이동 작업은 오류 메시지 이동의 증분 진행률을 보고하지 않습니다. 0%와 100% 완료만 보고합니다.

실행 값

이동된 오류 메시지의 개수는 작업의 ExecutionValue 속성에 정의된 실행 값으로 반환됩니다. 오류 메시지 이동 작업의 ExecValueVariable 속성에 사용자 정의 변수를 할당하면 패키지 내의 다른 개체에서 오류 메시지 이동에 대한 정보를 사용할 수 있습니다. 자세한 내용은 Integration Services(SSIS) 변수패키지에서 변수 사용을 참조하세요.

로그 항목

오류 메시지 이동 작업에는 다음과 같은 사용자 지정 로그 항목이 포함됩니다.

  • TransferErrorMessagesTaskStartTransferringObjects 이 로그 항목은 전송이 시작되었음을 보고합니다. 로그 항목에 시작 시간이 포함됩니다.

  • TransferErrorMessagesTaskFinishedTransferringObjects 이 로그 항목은 전송이 완료되었음을 보고합니다. 로그 항목에 종료 시간이 포함됩니다.

또한 OnInformation 이벤트에 대한 로그 항목은 이동된 오류 메시지 수를 보고하고, OnWarning 이벤트에 대한 로그 항목은 덮어쓰여지는 대상의 각 오류 메시지에 대해 기록됩니다.

보안 및 사용 권한

새 오류 메시지를 만들려면 패키지를 실행하는 사용자가 대상 서버에서 sysadmin 또는 serveradmin 서버 역할의 구성원이어야 합니다.

오류 메시지 이동 작업 구성

SSIS 디자이너를 사용하거나 프로그래밍 방식으로 속성을 설정할 수 있습니다.

SSIS 디자이너에서 설정할 수 있는 속성에 대한 자세한 내용을 보려면 다음 항목을 클릭하세요.

이러한 속성을 프로그래밍 방식으로 설정하는 방법은 다음 주제를 참조하세요.

SSIS 디자이너에서 이러한 속성을 설정하는 방법을 보려면 다음 항목을 클릭하십시오.

오류 메시지 이동 작업 편집기(일반 페이지)

오류 메시지 이동 작업 편집기 대화 상자의 일반 페이지를 사용하여 오류 메시지 이동 작업을 명명 및 설명할 수 있습니다. 오류 메시지 이동 작업은 SQL Server 인스턴스 간에 하나 이상의 SQL Server 사용자 정의 오류 메시지를 이동합니다.

옵션

이름
오류 메시지 이동 작업에 사용할 고유 이름을 제공합니다. 이 이름은 태스크 아이콘에서 레이블로 사용됩니다.

참고

태스크 이름은 패키지 내에서 고유해야 합니다.

설명
오류 메시지 이동 작업에 대한 설명을 입력합니다.

오류 메시지 전송 태스크 편집기(메시지 페이지)

오류 메시지 이동 작업 편집기 대화 상자의 메시지 페이지를 사용하여 SQL Server의 한 인스턴스에서 다른 인스턴스로 하나 이상의 SQL Server 사용자 정의 오류 메시지를 복사하기 위한 속성을 지정할 수 있습니다.

옵션

SourceConnection
목록에서 SMO 연결 관리자를 선택하거나 <새 연결...>을 클릭하여 원본 서버에 대한 새 연결을 만듭니다.

DestinationConnection
목록에서 SMO 연결 관리자를 선택하거나 <새 연결...>을 클릭하여 대상 서버에 대한 새 연결을 만듭니다.

IfObjectExists
이름이 동일한 오류 메시지가 이미 대상 서버에 있는 경우 기존 사용자 정의 오류 메시지를 덮어쓸지, 기존 메시지를 건너뛸지, 아니면 태스크가 실패하도록 할지를 선택합니다.

TransferAllErrorMessages
작업에서 소스 서버에서 대상 서버로 지정된 사용자 정의 메시지를 모두 복사할지, 아니면 지정된 메시지만 복사할지 선택합니다.

이 속성의 옵션은 다음 표에 나열되어 있습니다.

설명
True 모든 사용자 정의 메시지를 복사합니다.
False 지정한 사용자 정의 메시지만 복사합니다.

ErrorMessagesList
찾아보기 단추(...)를 클릭하여 복사할 오류 메시지를 선택합니다.

참고 항목

복사할 오류 메시지를 선택하려면 먼저 SourceConnection을 지정해야 합니다.

ErrorMessageLanguagesList
사용자 정의 오류 메시지를 대상 서버로 복사할 언어를 선택하려면 찾아보기 단추(…)를 클릭합니다. 다른 언어 버전의 메시지를 대상 서버로 이동하려면 해당 서버에 us_english(코드 페이지 1033) 버전의 메시지가 있어야 합니다.

참고 항목

복사할 오류 메시지를 선택하려면 먼저 SourceConnection을 지정해야 합니다.

참고 항목

Integration Services 태스크
제어 흐름