BulkInsertTask Classe

Definição

Fornece as propriedades e os métodos para a tarefa de inserção em massa, que é a maneira mais rápida de copiar grandes quantidades de dados em uma tabela ou exibição de SQL Server. Essa classe não pode ser herdada.

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
Herança
BulkInsertTask
Atributos
Implementações

Comentários

Para obter mais informações, veja Tarefa Inserção em Massa.

Construtores

BulkInsertTask()

Inicializa uma nova instância da classe BulkInsertTask.

Propriedades

BatchSize

Obtém ou define o número de linhas de cada lote.

CheckConstraints

Obtém ou define um booliano que indica se você deseja impor restrições de verificação de tabela e coluna.

CodePage

Obtém ou define a página de código dos dados no arquivo de dados.

DataFileType

Obtém ou define um valor da enumeração DTSBulkInsert_DataFileType que indica o valor do tipo de dados a ser usado na operação de carregamento.

DebugMode

Obtém ou define um valor Boolean que indica se uma tarefa deve determinar se os pontos de interrupção estão habilitados.

DestinationConnection

Obtém ou define o nome do objeto de conexão de destino.

DestinationTableName

Obtém ou define o nome da tabela ou exibição de destino.

ExecutionValue

Retorna um objeto definido pelo usuário. Este campo é somente leitura.

(Herdado de Task)
FieldTerminator

Obtém ou define o terminador de campo para uso em arquivos de dados char e widechar.

FireTriggers

Obtém ou define um booliano que indica se os gatilhos de inserção devem ser executados na tabela durante a operação.

FirstRow

Obtém ou define a primeira linha da qual iniciar a cópia.

FormatFile

Obtém ou define o caminho completo de um arquivo de formato.

KeepIdentity

Obtém ou define um booliano que especifica como o valor de identidade ou os valores no arquivo de dados importado são usados para a coluna de identidade

KeepNulls

Obtém ou define um booliano que indica se as colunas vazias devem reter um valor nulo durante a operação de carregamento em massa ou inserir valores padrão nas colunas.

LastRow

Obtém ou define o número da última linha a ser copiada.

MaximumErrors

Obtém ou define o número máximo de erros que podem ocorrer antes de uma falha na operação de inserção em massa.

RowTerminator

Obtém ou define o terminador de linha para uso em arquivos de dados char e widechar.

SortedData

Obtém ou define a cláusula order by na instrução BULK INSERT

SourceConnection

Obtém ou define o nome do objeto de conexão de origem.

SqlStatement

Obtém uma matriz de cadeia de caracteres que contém a instrução Transact-SQL a ser executada.

SuspendRequired

Obtém ou define um valor Boolean que indica se as tarefas devem ser suspensas quando encontram um ponto de interrupção. Esse valor é definido pelo mecanismo de runtime para tarefas e contêineres quando um ponto de interrupção é encontrado.

TableLock

Obtém ou define um booliano que indica se a tabela está bloqueada durante a operação de inserção em massa.

TargetServerVersion (Herdado de Task)
UseFormatFile

Obtém ou define um booliano que indica se a tarefa de inserção em massa usa um arquivo de formato.

Version

***  Membro preterido; consulte comentários. ** _ Retorna a versão da tarefa. Esta propriedade é somente para leitura.

(Herdado de Task)

Métodos

AcceptBreakpointManager(BreakpointManager)

Chamado pelo mecanismo de tempo de execução quando uma tarefa ou um contêiner é criado e um BreakpointManager é transmitido para permitir que a tarefa crie, remova e verifique o status dos pontos de interrupção. Esse método é chamado pelo runtime e não é usado em código.

CanUpdate(String)

***  Membro preterido; consulte comentários. ** _ Um booliano que indica se o novo XML do pacote pode atualizar o XML do pacote antigo.

(Herdado de Task)
Equals(Object)

Determina se duas instâncias de objeto são iguais.

(Herdado de DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)

Executa a tarefa de Inserção em Massa.

GetConnectionID(Connections, String)

Obtém uma cadeia de caracteres que contém a ID da conexão.

(Herdado de Task)
GetConnectionName(Connections, String)

Obtém uma cadeia de caracteres que contém o nome da conexão.

(Herdado de Task)
GetHashCode()

Retorna o código hash para a instância.

(Herdado de DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)

Inicializa as propriedades associadas à tarefa. Esse método é chamado pelo runtime e não é usado em código.

LoadFromXML(XmlElement, IDTSInfoEvents)

Esse método não pode ser chamado por seu código de aplicativo. Para carregar um pacote salvo como .xml, use o método LoadPackage(String, IDTSEvents).

ResumeExecution()

Retoma a execução da tarefa depois de pausar. A tarefa ou o contêiner é retomado pelo mecanismo de runtime.

SaveToXML(XmlDocument, IDTSInfoEvents)

Esse método não pode ser chamado por seu código de aplicativo. Para salvar um pacote como .xml, use o método SaveToXml(String, Package, IDTSEvents).

SuspendExecution()

Indica se o executável precisa ser suspenso. Esse método é chamado pelo mecanismo de runtime.

Update(String)

***  Membro preterido; consulte comentários. ** _ Esse método atualizará o XML do pacote antigo com o novo XML do pacote se CanUpdate(String) for definido como true.

(Herdado de Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

Verifica se o componente da tarefa de Inserção em Massa está configurado corretamente.

Aplica-se a