ExecuteSQLTask 클래스

정의

SQL 실행 태스크를 구성하고 실행하는 데 사용되는 멤버를 포함합니다. SQL 실행 태스크를 사용하여 관계형 데이터베이스 테이블 또는 뷰에 대해 SQL 명령을 실행할 수 있습니다.

public ref class ExecuteSQLTask : Microsoft::SqlServer::Dts::Runtime::Task, Microsoft::SqlServer::Dts::Runtime::IDTSComponentPersist, Microsoft::SqlServer::Dts::Tasks::ExecuteSQLTask::IDTSExecuteSQL
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL 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.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("EBC1FA93-45A9-444F-BBDC-B4F5265863C3")]
public class ExecuteSQLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.IDTSExecuteSQL
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL 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.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("855117DC-EA42-4532-8D53-8E4FC09662CE")]
public class ExecuteSQLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.IDTSExecuteSQL
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL 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.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("736DDEB9-5DA1-4841-B5A7-F08CC574307F")]
public class ExecuteSQLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.IDTSExecuteSQL
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL 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.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("EBC1FA93-45A9-444F-BBDC-B4F5265863C3")>]
type ExecuteSQLTask = class
    inherit Task
    interface IDTSExecuteSQL
    interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL 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.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("855117DC-EA42-4532-8D53-8E4FC09662CE")>]
type ExecuteSQLTask = class
    inherit Task
    interface IDTSExecuteSQL
    interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL 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.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("736DDEB9-5DA1-4841-B5A7-F08CC574307F")>]
type ExecuteSQLTask = class
    inherit Task
    interface IDTSExecuteSQL
    interface IDTSComponentPersist
Public Class ExecuteSQLTask
Inherits Task
Implements IDTSComponentPersist, IDTSExecuteSQL
상속
ExecuteSQLTask
파생
특성
구현

설명

이 작업의 기능에 대한 자세한 내용은 SQL 작업 실행(Execute SQL Task)을 참조하세요.

생성자

ExecuteSQLTask()

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

속성

BypassPrepare

SQL 문을 RDBMS(관계형 데이터베이스 관리 시스템)로 보낼 때 SQL 실행 태스크가 문 준비를 건너뛰는지 여부를 나타내는 부울을 가져오거나 설정합니다.

CodePage

유니코드 와이드 문자로 저장된 변수 값을 멀티바이트로 변환할 때 사용할 코드 페이지를 가져오거나 설정합니다. 데이터베이스의 값을 저장하거나 추출할 때 변환이 발생합니다.

Connection

SQL 실행 태스크가 실행되는 RDBMS(관계형 데이터베이스 관리 시스템)에 연결하는 연결 관리자의 이름을 가져오거나 설정합니다.

ExecutionValue

SQL 문의 영향을 받은 행 수를 반환합니다.

IsStoredProcedure

SQL 실행 태스크에서 지정한 SQL 문이 저장 프로시저인지 여부를 나타내는 부울을 가져오거나 설정합니다.

ParameterBindings

IDTSParameterBindings를 구현하는 개체를 반환합니다.

ResultSetBindings

IDTSParameterBindings를 구현하는 개체를 반환합니다.

ResultSetType

SQL 실행 태스크가 실행하는 SQL 문에서 반환하는 결과 집합 유형을 나타내는 값을 가져오거나 설정합니다.

SqlStatementSource

SQL 실행 태스크가 실행하는 SQL 문을 포함하는 원본의 이름을 가져오거나 설정합니다.

SqlStatementSourceType

SQL 실행 태스크가 실행하는 SQL 문을 포함하는 원본 유형을 나타내는 값을 가져오거나 설정합니다.

TargetServerVersion

SQL 실행 태스크를 구성하고 실행하는 데 사용되는 멤버를 포함합니다. SQL 실행 태스크를 사용하여 관계형 데이터베이스 테이블 또는 뷰에 대해 SQL 명령을 실행할 수 있습니다.

(다음에서 상속됨 Task)
TimeOut

제한 시간이 초과되기 전, 태스크를 실행할 수 있는 최대 시간(초)을 나타내는 정수를 가져오거나 설정합니다.

TypeConversionMode

실행 SQL 태스크에서 사용하는 변환 모델을 가져오거나 설정합니다.

Version

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

(다음에서 상속됨 Task)

메서드

CanUpdate(String)

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

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

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

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

작업을 실행합니다.

GetConnectionID(Connections, String)

연결의 ID를 포함하는 문자열을 가져옵니다.

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

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

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

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

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

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

LoadFromXML(XmlElement, IDTSInfoEvents)

이 메서드는 애플리케이션 코드에서 호출할 수 없습니다. .xml로 저장된 패키지를 로드하려면 LoadPackage(String, IDTSEvents) 메서드를 사용합니다.

SaveToXML(XmlDocument, IDTSInfoEvents)

이 메서드는 애플리케이션 코드에서 호출할 수 없습니다. 패키지를 .xml로 저장하려면 SaveToXml(String, Package, IDTSEvents) 메서드를 사용합니다.

Update(String)

멤버가 사용되지 않습니다. 은 비고를 참조하세요. 이 메서드는 true로 설정된 경우 CanUpdate(String) 이전 패키지 XML을 새 패키지 XML로 업데이트합니다.

(다음에서 상속됨 Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

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

적용 대상