BulkInsertTask 클래스

정의

대량 삽입 태스크에 대한 속성과 메서드를 제공합니다. 대량의 데이터를 SQL Server 테이블이나 뷰에 복사하는 가장 빠른 방법입니다. 이 클래스는 상속될 수 없습니다.

public ref class BulkInsertTask sealed : Microsoft::SqlServer::Dts::Runtime::Task, Microsoft::SqlServer::Dts::Runtime::IDTSBreakpointSite, Microsoft::SqlServer::Dts::Runtime::IDTSComponentPersist, Microsoft::SqlServer::Dts::Tasks::BulkInsertTask::IDTSBulkInsertTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.bulkinserttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskMessages), SamplesTag="SsisBulkInsertTask", UITypeName="Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskUI, Microsoft.SqlServer.BulkInsertTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
public sealed class BulkInsertTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.IDTSBulkInsertTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.bulkinserttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskMessages), SamplesTag="SsisBulkInsertTask", UITypeName="Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskUI, Microsoft.SqlServer.BulkInsertTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
public sealed class BulkInsertTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.IDTSBulkInsertTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.bulkinserttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskMessages), SamplesTag="SsisBulkInsertTask", UITypeName="Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskUI, Microsoft.SqlServer.BulkInsertTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
public sealed class BulkInsertTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.IDTSBulkInsertTask
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.bulkinserttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskMessages), SamplesTag="SsisBulkInsertTask", UITypeName="Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskUI, Microsoft.SqlServer.BulkInsertTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
type BulkInsertTask = class
    inherit Task
    interface IDTSComponentPersist
    interface IDTSBulkInsertTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.bulkinserttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskMessages), SamplesTag="SsisBulkInsertTask", UITypeName="Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskUI, Microsoft.SqlServer.BulkInsertTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
type BulkInsertTask = class
    inherit Task
    interface IDTSComponentPersist
    interface IDTSBulkInsertTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.bulkinserttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskMessages), SamplesTag="SsisBulkInsertTask", UITypeName="Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTaskUI, Microsoft.SqlServer.BulkInsertTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
type BulkInsertTask = class
    inherit Task
    interface IDTSComponentPersist
    interface IDTSBulkInsertTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
Public NotInheritable Class BulkInsertTask
Inherits Task
Implements IDTSBreakpointSite, IDTSBulkInsertTask, IDTSComponentPersist
상속
BulkInsertTask
특성
구현

설명

자세한 내용은 Bulk Insert Task을 참조하세요.

생성자

BulkInsertTask()

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

속성

BatchSize

각 일괄 처리의 행 수를 가져오거나 설정합니다.

CheckConstraints

테이블 및 열 검사 제약 조건을 적용할지 여부를 나타내는 부울을 가져오거나 설정합니다.

CodePage

데이터 파일에서 데이터의 코드 페이지를 가져오거나 설정합니다.

DataFileType

로드 작업에서 사용할 데이터 형식 값을 나타내는 DTSBulkInsert_DataFileType 열거형의 값을 가져오거나 설정합니다.

DebugMode

중단점 활성화 여부를 태스크에서 확인할지를 나타내는 Boolean을 가져오거나 설정합니다.

DestinationConnection

대상 연결 개체의 이름을 가져오거나 설정합니다.

DestinationTableName

대상 테이블 또는 뷰의 이름을 가져오거나 설정합니다.

ExecutionValue

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

(다음에서 상속됨 Task)
FieldTerminator

char 및 widechar 데이터 파일에 사용할 필드 종결자를 가져오거나 설정합니다.

FireTriggers

작업 중에 테이블에서 삽입 트리거를 실행할지 여부를 나타내는 부울을 가져오거나 설정합니다.

FirstRow

복사를 시작할 첫 행을 가져오거나 설정합니다.

FormatFile

서식 파일의 전체 경로를 가져오거나 설정합니다.

KeepIdentity

가져온 데이터 파일의 ID 값이 ID 열에 사용되는 방법을 지정하는 부울을 가져오거나 설정합니다.

KeepNulls

대량 로드 작업 중에 빈 열이 null 값을 유지해야 하는지 또는 열에 기본값을 삽입해야 하는지 여부를 나타내는 부울을 가져오거나 설정합니다.

LastRow

복사할 마지막 행 수를 가져오거나 설정합니다.

MaximumErrors

대량 삽입 작업이 실패하기 전에 발생할 수 있는 최대 오류 수를 가져오거나 설정합니다.

RowTerminator

char 및 widechar 데이터 파일에 사용할 행 종결자를 가져오거나 설정합니다.

SortedData

대량 삽입 문의 Order by 절을 가져오거나 설정합니다.

SourceConnection

원본 연결 개체의 이름을 가져오거나 설정합니다.

SqlStatement

실행할 Transact-SQL 문이 포함된 문자열 배열을 가져옵니다.

SuspendRequired

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

TableLock

대량 삽입 작업 중에 테이블이 잠겨 있는지 여부를 나타내는 부울을 가져오거나 설정합니다.

TargetServerVersion

대량 삽입 태스크에 대한 속성과 메서드를 제공합니다. 대량의 데이터를 SQL Server 테이블이나 뷰에 복사하는 가장 빠른 방법입니다. 이 클래스는 상속될 수 없습니다.

(다음에서 상속됨 Task)
UseFormatFile

대량 삽입 태스크에서 서식 파일을 사용하는지 여부를 나타내는 부울을 가져오거나 설정합니다.

Version

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

(다음에서 상속됨 Task)

메서드

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)

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

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

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

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

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

LoadFromXML(XmlElement, IDTSInfoEvents)

이 메서드는 애플리케이션 코드에서 호출할 수 없습니다. .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)

대량 삽입 태스크 구성 요소가 제대로 구성되었는지 확인합니다.

적용 대상