다음을 통해 공유


MessageQueueTask 클래스

정의

메시지 큐 태스크에서 사용하는 메서드 및 속성을 포함합니다. 이 클래스는 상속될 수 없습니다.

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 2016; © 2015 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=13.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 2017; © 2017 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=14.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")]
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 2016; © 2015 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=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
type MessageQueueTask = class
    inherit Task
    interface IDTSComponentPersist
    interface IMessageQueueTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
[<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 2017; © 2017 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=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
type MessageQueueTask = class
    inherit Task
    interface IDTSComponentPersist
    interface IMessageQueueTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
[<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
상속
MessageQueueTask
특성
구현

설명

메시지 큐 태스크 클래스를 사용하면 개체가 메시지 큐(MSMQ라고도 함)의 큐에서 메시지를 보내고 받을 수 있습니다. MSDTC(Microsoft Distributed Transaction Coordinator)를 실행할 때 분산 트랜잭션 참여가 허용됩니다. 메시지 큐 태스크의 단일 인스턴스는 지정된 큐에 하나의 메시지를 보내거나 지정된 큐에서 단일 메시지를 수신하고 필요한 경우 메시지가 도착할 때까지 기다립니다. 다음과 같은 유형의 메시지를 보낼 수 있습니다.

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

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

  • 하나 이상의 SQL Server Integration Services 변수의 이름 및 값에서 생성되는 변수 메시지입니다.

열거형 MQMessageType 은 특정 메시지 큐 태스크에서 사용되는 메시지 형식을 결정합니다.

자세한 내용은 메시지 큐 태스크를 참조하세요.

MessageQueueTask API 또는 SSIS 디자이너에서 작동하려면 SQL Server Integration Services를 설치해야 합니다. SSDT(SQL Server Data Tools)만 설치된 경우에는 이 기능이 작동하지 않습니다.

중요

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

생성자

MessageQueueTask()

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

속성

CurrentExecutingPackageID

현재 실행 패키지의 ID를 가져오거나 설정합니다.

DataFileOverWritable

데이터 파일 메시지가 기존 데이터 파일을 덮어쓸 수 있는지 여부를 나타내는 부울 값을 가져오거나 설정합니다.

DebugMode

개체가 디버그 모드에 있는지 여부와 실행하는 동안 이벤트를 발생 OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) 시켜야 하는지 여부를 나타내는 부울 값을 가져오거나 설정합니다.

DTSMessageLineageID

메시지 계보 식별자를 가져오거나 설정합니다.

DTSMessagePackageID

메시지 원본인 패키지의 식별자를 가져오거나 설정합니다.

DTSMessageVersionID

메시지 버전을 가져오거나 설정합니다.

EncryptionAlgo

프라이빗 메시지의 메시지 본문을 암호화하는 데 사용되는 암호화 알고리즘의 이름을 가져오거나 설정합니다.

ErrorIfMessageTimeOut

메시지 시간이 초과되면 작업이 실패할지 여부를 지정하는 부울 값을 가져오거나 설정합니다.

ExecutionValue

사용자 정의 개체를 반환합니다. 이 필드는 읽기 전용입니다.

(다음에서 상속됨 Task)
MessageDataFile

MessageTypeDTSMQMessageType_DataFile로 설정되어 있을 때 사용되는 데이터 파일 이름을 가져오거나 설정합니다.

MessageString

MessageTypeDTSMQMessageType_String으로 설정되어 있을 때 사용할 메시지를 가져오거나 설정합니다.

MessageType

TaskTypeDTSMQType_Sender일 때 보낼 메시지 유형을 나타내는 값을 가져오거나 설정합니다.

MessageVariables

MQMessageType 열거형이 DTSMQMessageType_Variables로 설정되어 있을 때 변수 목록을 가져오거나 설정합니다.

MsmqConnection

MSMQ 태스크에 대한 연결의 이름을 가져오거나 설정합니다.

OperationDescription

작업에 대한 설명을 가져오거나 설정합니다.

ReceiveMessageTimeOut

받은 메시지의 제한 시간(초)을 지정하는 값을 가져오거나 설정합니다.

ReceiveMessageType

받을 메시지 유형을 나타내는 MQMessageType 값을 가져오거나 설정합니다.

ReceiveVariableMessage

메시지를 저장할 변수의 이름을 가져오거나 설정합니다.

RemoveFromQueue

메시지를 큐에서 제거할지 여부를 지정하는 부울 값을 가져오거나 설정합니다.

SaveDataFileName

들어오는 데이터 파일 메시지가 저장될 파일의 이름을 가져오거나 설정합니다.

StringCompareType

문자열 메시지 형식 TaskType 에 대한 문자열 비교 메서드를 지정하는 값입니다 DTSMQType_Receiver.

StringCompareValue

문자열 메시지가 있는 경우와 비교할 문자열을 TaskTypeDTSMQType_Receiver가져오거나 설정합니다.

StringMessageToVariableName

메시지 내용이 저장되는 변수의 이름을 가져오거나 설정합니다.

SuspendRequired

중단점이 발생할 때 작업을 일시 중단해야 하는지 여부를 나타내는 부울 값을 가져오거나 설정합니다. 이 값은 중단점에 도달할 때 태스크 및 컨테이너의 런타임 엔진에서 설정됩니다.

TargetServerVersion

메시지 큐 태스크에서 사용하는 메서드 및 속성을 포함합니다. 이 클래스는 상속될 수 없습니다.

(다음에서 상속됨 Task)
TaskType

메시지 태스크에서 보내기를 수행하고 있는지 받기를 수행하고 있는지를 나타내는 값을 가져오거나 설정합니다.

Use2000Format

메시지에서 SQL Server 2000 형식을 사용함을 나타내는 부울 형식을 가져오거나 설정합니다.

UseEncryption

메시지에서 암호화를 사용하는지 여부를 나타내는 부울 값을 가져오거나 설정합니다.

Version

멤버는 더 이상 사용되지 않습니다. 은 비고를 참조하세요. *** 태스크 버전을 반환합니다. 이 속성은 읽기 전용입니다.

(다음에서 상속됨 Task)

메서드

AcceptBreakpointManager(BreakpointManager)

BreakpointManager를 태스크에 전달합니다. 이 메서드는 런타임을 통해 호출되며 코드에 사용되지 않습니다.

CanUpdate(String)

멤버는 더 이상 사용되지 않습니다. 은 비고를 참조하세요. 새 패키지 XML이 이전 패키지 XML을 업데이트할 수 있는지 여부를 나타내는 부울입니다.

(다음에서 상속됨 Task)
Equals(Object)

두 개체 인스턴스가 같은지 확인합니다.

(다음에서 상속됨 DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)

작업을 실행합니다.

GetConnectionID(Connections, String)

연결 ID를 포함하는 String을 가져옵니다.

(다음에서 상속됨 Task)
GetConnectionName(Connections, String)

연결 이름을 포함하는 String을 가져옵니다.

(다음에서 상속됨 Task)
GetHashCode()

이 인스턴스의 해시 코드를 반환합니다.

(다음에서 상속됨 DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)

태스크와 연결된 속성을 초기화합니다. 이 메서드는 런타임을 통해 호출되며 코드에 사용되지 않습니다.

LoadFromXML(XmlElement, IDTSInfoEvents)

이 메서드는 애플리케이션 코드에서 호출할 수 없습니다. .xml 파일 이름 확장명의 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)

태스크가 제대로 구성되었는지 확인합니다.

적용 대상