오류 메시지 전송 태스크Transfer Error Messages Task

오류 메시지 전송 태스크에서는 하나 이상의 SQL ServerSQL Server 사용자 정의 오류 메시지를 SQL ServerSQL Server인스턴스 간에 전송합니다.The Transfer Error Messages task transfers one or more SQL ServerSQL Server user-defined error messages between instances of SQL ServerSQL Server. 사용자 정의 메시지는 50000보다 크거나 같은 식별자를 가진 메시지입니다.User-defined messages are messages with an identifier that is equal to or greater than 50000. 50000보다 작은 식별자를 가진 메시지는 시스템 오류 메시지이며 오류 메시지 전송 태스크를 사용하여 전송할 수 없습니다.Messages with an identifier less than 50000 are system error messages, and cannot be transferred by using the Transfer Error Messages task.

모든 오류 메시지를 전송하거나 지정한 오류 메시지만 전송하도록 오류 메시지 전송 태스크를 구성할 수 있습니다.The Transfer Error Messages task can be configured to transfer all error messages, or only the specified error messages. 사용자 정의 오류 메시지는 여러 다른 언어로 제공될 수 있으며 지정된 언어로만 메시지를 전송하도록 태스크를 구성할 수 있습니다.User-defined error messages may be available in a number of different languages and the task can be configured to transfer only messages in selected languages. 다른 언어 버전의 메시지를 대상 서버로 전송하려면 해당 서버에 1033 코드 페이지를 사용하는 us_english 버전의 메시지가 있어야 합니다.A us_english version of the message that uses code page 1033 must exist on the destination server before you can transfer other language versions of the message to that server.

master 데이터베이스의 sysmessages 테이블에는 시스템 및 사용자 정의 오류 메시지를 포함하여 SQL ServerSQL Server 에서 사용하는 모든 오류 메시지가 들어 있습니다.The sysmessages table in the master database contains all the error messages—both system and user-defined—that SQL ServerSQL Server uses.

전송할 사용자 정의 메시지가 이미 대상에 있을 수 있습니다.The user-defined messages to be transferred may already exist on the destination. 식별자 및 언어가 동일한 경우 오류 메시지는 중복 오류 메시지로 정의됩니다.An error message is defined as a duplicate error message if the identifier and the language are the same. 다음 방식으로 기존 오류 메시지를 처리하도록 오류 메시지 전송 태스크를 구성할 수 있습니다.The Transfer Error Messages task can be configured to handle existing error messages in the following ways:

  • 기존 오류 메시지를 덮어씁니다.Overwrite existing error messages.

  • 중복 메시지가 있는 경우 태스크가 실패합니다.Fail the task when duplicate messages exist.

  • 중복 오류 메시지를 건너뜁니다.Skip duplicate error messages.

    오류 메시지 전송 태스크는 런타임에 한 개 또는 두 개의 SMO 연결 관리자를 사용하여 원본 및 대상 서버에 연결합니다.At run time, the Transfer Error Messages task connects to the source and destination servers by using one or two SMO connection managers. SMO 연결 관리자는 오류 메시지 전송 태스크와 별도로 구성된 후 오류 메시지 전송 태스크에서 참조됩니다.The SMO connection manager is configured separately from the Transfer Error Messages task, and then is referenced in the Transfer Error Messages task. SMO 연결 관리자는 액세스할 서버 및 서버 액세스 시 사용할 인증 모드를 지정합니다.The SMO connection manager specifies the server and the authentication mode to use when accessing the server. 자세한 내용은 SMO Connection Manager을 참조하세요.For more information, see SMO Connection Manager.

    오류 메시지 전송 태스크는 SQL ServerSQL Server 원본 및 대상을 지원합니다.The Transfer Error Messages task supports a SQL ServerSQL Server source and destination. 원본 또는 대상으로 사용하는 버전에 대한 제한은 없습니다.There are no restrictions on which version to use as a source or destination.

이벤트Events

이 태스크는 전송된 오류 메시지의 수를 보고하는 정보 이벤트를 발생시킵니다.The task raises an information event that reports the number of error messages that have been transferred.

오류 메시지 전송 태스크는 오류 메시지를 전송하는 진행 과정은 보고하지 않으며 0% 및 100% 완료만 보고합니다.The Transfer Error Messages task does not report incremental progress of the error message transfer; it reports only 0% and 100 % completion.

실행 값Execution Value

전송된 오류 메시지의 개수는 태스크의 ExecutionValue 속성에 정의된 실행 값으로 반환됩니다.The execution value, defined in the ExecutionValue property of the task, returns the number of error messages that have been transferred. 오류 메시지 전송 태스크의 ExecValueVariable 속성에 사용자 정의 변수를 할당하면 패키지 내의 다른 개체에서 오류 메시지 전송에 대한 정보를 사용할 수 있습니다.By assigning a user-defined variable to the ExecValueVariable property of the Transfer Error Message task, information about the error message transfer can be made available to other objects in the package. 자세한 내용은 Integration Services(SSIS) 변수패키지에서 변수 사용을 참조하세요.For more information, see Integration Services (SSIS) Variables and Use Variables in Packages.

로그 항목Log Entries

오류 메시지 전송 태스크에는 다음 사용자 지정 로그 항목이 포함됩니다.The Transfer Error Messages task includes the following custom log entries:

  • TransferErrorMessagesTaskStartTransferringObjects 이 로그 항목에서는 전송이 시작되었음을 보고합니다.TransferErrorMessagesTaskStartTransferringObjects This log entry reports that the transfer has started. 로그 항목에 시작 시간이 포함됩니다.The log entry includes the start time.

  • TransferErrorMessagesTaskFinishedTransferringObjects 이 로그 항목에서는 전송이 완료되었음을 보고합니다.TransferErrorMessagesTaskFinishedTransferringObjects This log entry reports that the transfer has finished. 로그 항목에 종료 시간이 포함됩니다.The log entry includes the end time.

    이외에 OnInformation 이벤트의 로그 항목은 전송된 오류 메시지 수를 보고하며 OnWarning event 의 로그 항목은 덮어쓴 대상에 대한 각 오류 메시지에 대해 기록됩니다.In addition, a log entry for the OnInformation event reports the number of error messages that were transferred, and a log entry for the OnWarning event is written for each error message on the destination that is overwritten.

보안 및 사용 권한Security and Permissions

새 오류 메시지를 만들려면 패키지를 실행하는 사용자가 대상 서버의 sysadmin 또는 serveradmin 서버 역할의 멤버여야 합니다.To create new error messages, the user that runs the package must be a member of the sysadmin or serveradmin server role on the destination server.

오류 메시지 전송 태스크 구성Configuration of the Transfer Error Messages Task

SSISSSIS 디자이너를 사용하거나 프로그래밍 방식으로 속성을 설정할 수 있습니다.You can set properties through SSISSSIS Designer or programmatically.

SSISSSIS 디자이너에서 설정할 수 있는 속성에 대한 자세한 내용을 보려면 다음 항목을 클릭하십시오.For more information about the properties that you can set in SSISSSIS Designer, click the following topic:

SSISSSIS 디자이너에서 이러한 속성을 설정하는 방법을 보려면 다음 항목을 클릭하십시오.For more information about how to set these properties in SSISSSIS Designer, click the following topic:

오류 메시지 전송 태스크 편집기(일반 페이지)Transfer Error Messages Task Editor (General Page)

오류 메시지 전송 태스크 편집기 대화 상자의 일반 페이지를 사용하여 오류 메시지 전송 태스크의 이름을 지정하고 해당 태스크를 설명할 수 있습니다.Use the General page of the Transfer Error Messages Task Editor dialog box to name and describe the Transfer Error Messages task. 오류 메시지 전송 태스크에서는 하나 이상의 SQL ServerSQL Server 사용자 정의 오류 메시지를 SQL ServerSQL Server인스턴스 간에 전송합니다.The Transfer Error Messages task transfers one or more SQL ServerSQL Server user-defined error messages between instances of SQL ServerSQL Server.

옵션Options

이름Name
오류 메시지 전송 태스크에 사용할 고유 이름을 제공합니다.Type a unique name for the Transfer Error Messages task. 이 이름은 태스크 아이콘에서 레이블로 사용됩니다.This name is used as the label in the task icon.

참고

태스크 이름은 패키지 내에서 고유해야 합니다.Task names must be unique within a package.

DescriptionDescription
오류 메시지 전송 태스크에 대한 설명을 입력합니다.Type a description of the Transfer Error Messages task.

오류 메시지 전송 태스크 편집기(메시지 페이지)Transfer Error Messages Task Editor (Messages Page)

오류 메시지 전송 태스크 편집기 대화 상자의 메시지 페이지를 사용하여 하나 이상의 SQL ServerSQL Server 사용자 정의 오류 메시지를 SQL ServerSQL Server의 한 인스턴스에서 다른 인스턴스로 복사하기 위한 속성을 지정할 수 있습니다.Use the Messages page of the Transfer Error Messages Task Editor dialog box to specify properties for copying one or more SQL ServerSQL Server user-defined error messages from one instance of SQL ServerSQL Server to another.

옵션Options

SourceConnectionSourceConnection
목록에서 SMO 연결 관리자를 선택 하거나 클릭 <새 연결... > 원본 서버에 새 연결을 만듭니다.Select a SMO connection manager in the list, or click <New connection...> to create a new connection to the source server.

DestinationConnectionDestinationConnection
목록에서 SMO 연결 관리자를 선택 하거나 클릭 <새 연결... > 대상 서버에 새 연결을 만듭니다.Select a SMO connection manager in the list, or click <New connection...> to create a new connection to the destination server.

IfObjectExistsIfObjectExists
이름이 동일한 오류 메시지가 이미 대상 서버에 있는 경우 기존 사용자 정의 오류 메시지를 덮어쓸지, 기존 메시지를 건너뛸지, 아니면 태스크가 실패하도록 할지를 선택합니다.Select whether the task should overwrite existing user-defined error messages, skip existing messages, or fail if error messages of the same name already exist on the destination server.

TransferAllErrorMessagesTransferAllErrorMessages
원본 서버에서 대상 서버로 모든 사용자 정의 메시지를 복사할지, 아니면 지정한 사용자 정의 메시지만 복사할지를 선택합니다.Select whether the task should copy all or only the specified user-defined messages from the source server to the destination server.

이 속성의 옵션은 다음 표에 나열되어 있습니다.This property has the options listed in the following table:

ValueValue DescriptionDescription
TrueTrue 모든 사용자 정의 메시지를 복사합니다.Copy all user-defined messages.
FalseFalse 지정한 사용자 정의 메시지만 복사합니다.Copy only the specified user-defined messages.

ErrorMessagesListErrorMessagesList
복사할 오류 메시지를 선택하려면 찾아보기 단추 (…) 를 클릭합니다.Click the browse button (…) to select the error messages to copy.

참고

복사할 오류 메시지를 선택하려면 SourceConnection 을 지정해야 합니다.You must specify the SourceConnection before you can select error messages to copy.

ErrorMessageLanguagesListErrorMessageLanguagesList
사용자 정의 오류 메시지를 대상 서버로 복사할 언어를 선택하려면 찾아보기 단추 (…) 를 클릭합니다.Click the browse button (…) to select the languages for which to copy user-defined error messages to the destination server. 다른 언어 버전의 메시지를 대상 서버로 전송하려면 us_english(코드 페이지 1033) 버전의 메시지가 해당 서버에 있어야 합니다.A us_english (code page 1033) version of the message must exist on the destination server before you can transfer other language versions of the message to that server.

참고

복사할 오류 메시지를 선택하려면 SourceConnection 을 지정해야 합니다.You must specify the SourceConnection before you can select error messages to copy.

관련 항목:See Also

Integration Services 태스크 Integration Services Tasks
제어 흐름Control Flow