MessageQueueTask 클래스

정의

네임스페이스:

Microsoft.SqlServer.Dts.Tasks.MessageQueueTask

어셈블리:

Microsoft.SqlServer.MSMQTask.dll

메시지 큐 작업에서 사용하는 메서드와 속성을 포함합니다. 이 클래스는 상속할 수 없습니다.

public ref class MessageQueueTask sealed : Microsoft::SqlServer::Dts::Runtime::Task, Microsoft::SqlServer::Dts::Runtime::IDTSBreakpointSite, Microsoft::SqlServer::Dts::Runtime::IDTSComponentPersist, Microsoft::SqlServer::Dts::Tasks::MessageQueueTask::IMessageQueueTask

[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.messagequeuetask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.MessageQueueTask.MSMQTaskMessages), SamplesTag="SsisMessageQueueTask", TaskContact="Message Queue Task; Microsoft Corporation; SQL Server 2019; © 2019 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.MessageQueueTask.MessageQueueTaskUI, Microsoft.SqlServer.MSMQTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
public sealed class MessageQueueTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.MessageQueueTask.IMessageQueueTask

[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.messagequeuetask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.MessageQueueTask.MSMQTaskMessages), SamplesTag="SsisMessageQueueTask", TaskContact="Message Queue Task; Microsoft Corporation; SQL Server 2019; © 2019 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.MessageQueueTask.MessageQueueTaskUI, Microsoft.SqlServer.MSMQTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
type MessageQueueTask = class
    inherit Task
    interface IDTSComponentPersist
    interface IMessageQueueTask
    interface IDTSBreakpointSite
    interface IDTSSuspend

Public NotInheritable Class MessageQueueTask
Inherits Task
Implements IDTSBreakpointSite, IDTSComponentPersist, IMessageQueueTask

상속

Object

DtsObject

Task

MessageQueueTask

특성

DtsTaskAttribute

구현

IDTSBreakpointSite IDTSComponentPersist IDTSSuspend IMessageQueueTask

설명

메시지 큐 작업 클래스는 객체가 메시지 큐잉(MSMQ)의 큐와 메시지를 주고받을 수 있도록 합니다. Microsoft Distributed Transaction Coordinator(MSDTC)를 실행할 때 분산 트랜잭션에 참여할 수 있습니다. 메시지 큐 작업의 단일 인스턴스는 지정된 큐에 한 메시지를 보내거나 지정된 큐에서 단일 메시지를 받으며, 필요 시 메시지가 도착하기를 기다립니다. 다음과 같은 유형의 메시지를 보낼 수 있습니다:

• 속성의 값으로 제공되는 문자열 메시지입니다.

• 지정된 데이터 파일의 내용에서 생성된 데이터 파일 메시지입니다.

• 변수 메시지로, 하나 이상의 SQL Server Integration Services 변수의 이름과 값에서 생성됩니다.

열거 MQMessageType 는 특정 메시지 큐 작업에서 사용할 메시지 형식을 결정합니다.

자세한 내용은 메시지 큐 작업을 참조하세요.

API나 SSIS Designer에서 작동하려면 MessageQueueTask SQL Server Integration Services를 설치해야 합니다. 이 기능은 SQL Server Data Tools(SSDT)만 설치되어 있으면 작동하지 않습니다.

Important

메시지 큐 작업을 구성할 때, 현재 메시지 큐잉에서 지원하는 암호화 알고리즘인 RC2와 RC4를 사용하여 메시지를 암호화할 수 있습니다. 이 두 암호화 알고리즘은 메시지 큐에서 현재 지원하지 않는 최신 알고리즘에 비해 암호화 방식이 취약한 것으로 간주됩니다. 따라서 메시지 큐 작업을 사용하여 메시지를 보낼 때 암호화 요구 사항을 신중하게 고려해야 합니다.

생성자

Name	Description
MessageQueueTask()	MessageQueueTask 클래스의 새 인스턴스를 초기화합니다.

속성

Name	Description
CurrentExecutingPackageID	현재 실행 중인 패키지의 ID를 받거나 설정합니다.
DataFileOverWritable	데이터 파일 메시지가 기존 데이터 파일을 덮어쓸 수 있는지 여부를 나타내는 불리언을 받거나 설정합니다.
DebugMode	객체가 디버그 모드에 있는지, 실행 중 이벤트를 발생 OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) 시켜야 하는지 여부를 나타내는 불리언을 받거나 설정합니다.
DTSMessageLineageID	메시지 계보 식별자를 받거나 설정합니다.
DTSMessagePackageID	메시지 소스인 패키지의 식별자를 받거나 설정합니다.
DTSMessageVersionID	메시지 버전을 받거나 설정합니다.
EncryptionAlgo	사적인 메시지의 본문을 암호화하는 데 사용되는 암호화 알고리즘의 이름을 얻거나 설정합니다.
ErrorIfMessageTimeOut	메시지가 타임아웃될 때 작업이 실패하는지 지정하는 불리언을 받거나 설정합니다.
ExecutionValue	사용자 정의 객체를 반환합니다. 이 필드는 읽기 전용입니다. (다음에서 상속됨 Task)
MessageDataFile	가 로 설정DTSMQMessageType_DataFile되었을 때 MessageType 사용되는 데이터 파일 이름을 얻거나 설정합니다.
MessageString	가 로 설정DTSMQMessageType_String되었을 때 MessageType 메시지를 받거나 설정하여 사용하도록 설정합니다.
MessageType	가 가 있을 DTSMQType_Sender때 TaskType 전송되는 메시지 유형을 나타내는 값을 받거나 설정합니다.
MessageVariables	열거가 MQMessageType 로 DTSMQMessageType_Variables설정될 때 변수 목록을 얻거나 설정합니다.
MsmqConnection	MSMQ 작업의 연결 이름을 받거나 설정합니다.
OperationDescription	연산의 설명을 얻거나 설정합니다.
ReceiveMessageTimeOut	수신된 메시지가 타임아웃되기 전 몇 초를 지정하는지 값을 받거나 설정합니다.
ReceiveMessageType	수신할 메시지 유형을 나타내는 값을 받거나 설정합니다 MQMessageType .
ReceiveVariableMessage	메시지를 저장할 변수의 이름을 받거나 설정합니다.
RemoveFromQueue	메시지를 큐에서 제거할지 여부를 지정하는 불리언을 받거나 설정합니다.
SaveDataFileName	들어오는 데이터 파일 메시지가 저장되는 파일 이름을 받거나 설정합니다.
StringCompareType	문자열 메시지 유형 TaskTypeDTSMQType_Receiver에 대해 문자열 비교 방법을 지정하는 값입니다.
StringCompareValue	이 가 될 DTSMQType_Receiver때 TaskType 문자열 메시지를 비교하는 문자열을 얻거나 설정합니다.
StringMessageToVariableName	메시지 내용이 저장된 변수의 이름을 받거나 설정합니다.
SuspendRequired	작업이 브레이크포인트에 도달했을 때 일시 중단해야 하는지 알려주는 불리언을 받거나 설정합니다. 이 값은 실행 엔진이 작업과 컨테이너에 대해 브레이크포인트가 발생했을 때 설정합니다.
TargetServerVersion	메시지 큐 작업에서 사용하는 메서드와 속성을 포함합니다. 이 클래스는 상속할 수 없습니다. (다음에서 상속됨 Task)
TaskType	메시지 작업이 전송 중인지 수신 중인지를 나타내는 값을 받거나 설정합니다.
Use2000Format	메시지가 SQL Server 2000 형식을 사용한다는 불리언을 받거나 설정합니다.
UseEncryption	메시지가 암호화를 사용하는지 나타내는 불리언을 받거나 설정합니다.
Version	회원 해임; 참고: '비고'. 작업 버전을 반환합니다. 이 속성은 읽기 전용입니다. (다음에서 상속됨 Task)

메서드

Name	Description
AcceptBreakpointManager(BreakpointManager)	과제에 전달합니다 BreakpointManager . 이 메서드는 런타임에서 호출되며 코드에서는 사용되지 않습니다.
CanUpdate(String)	회원 해임; 참고: '비고'. 새 패키지 XML이 이전 패키지 XML을 업데이트할 수 있는지 여부를 나타내는 불리언입니다. (다음에서 상속됨 Task)
Equals(Object)	두 개체 인스턴스가 같은지 여부를 확인합니다. (다음에서 상속됨 DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	일을 수행한다.
GetConnectionID(Connections, String)	연결 ID를 포함하는 문자열을 받습니다. (다음에서 상속됨 Task)
GetConnectionName(Connections, String)	연결 이름을 포함하는 문자열을 얻습니다. (다음에서 상속됨 Task)
GetHashCode()	이 인스턴스의 해시 코드를 반환합니다. (다음에서 상속됨 DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)	작업과 관련된 속성을 초기화합니다. 이 메서드는 런타임에서 호출되며 코드에서는 사용되지 않습니다.
LoadFromXML(XmlElement, IDTSInfoEvents)	이 메서드는 애플리케이션 코드로는 호출할 수 없습니다. XML 형식(파일 이름 확장자the.xml 저장된 패키지를 불러오려면 다음 LoadPackage(String, IDTSEvents) 메서드를 사용하세요.
ResumeExecution()	잠시 일시 중지한 후 다시 작업을 계속한다. 작업 또는 컨테이너의 실행은 런타임 엔진에 의해 재개됩니다.
SaveToXML(XmlDocument, IDTSInfoEvents)	이 메서드는 애플리케이션 코드로는 호출할 수 없습니다. 패키지를 .xml로 저장하려면 다음 SaveToXml(String, Package, IDTSEvents) 방법을 사용하세요.
SuspendExecution()	실행 파일이 일시 중지되어야 함을 나타냅니다. 이 메서드는 런타임 엔진에서 호출됩니다.
Update(String)	회원 해임; 참고: '비고'. 이 메서드는 true로 설정되면 CanUpdate(String) 기존 패키지 XML을 새 패키지 XML로 업데이트합니다. (다음에서 상속됨 Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	작업이 제대로 구성되었는지 확인합니다.