BulkInsertTask Classe

Definição

Namespace:: Microsoft.SqlServer.Dts.Tasks.BulkInsertTask

Assembly:: Microsoft.SqlServer.BulkInsertTask.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece as propriedades e métodos para a tarefa Bulk Insert, que é a forma mais rápida de copiar grandes quantidades de dados para uma tabela ou visualização do 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: Object

DtsObject

Task
BulkInsertTask

Atributos: DtsTaskAttribute

Implementações: IDTSBreakpointSite IDTSComponentPersist IDTSSuspend IDTSBulkInsertTask

Comentários

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

Construtores

Nome	Description
BulkInsertTask()	Inicializa uma nova instância da classe BulkInsertTask.

Propriedades

Nome	Description
BatchSize	Obtém ou define o número de linhas em cada lote.
CheckConstraints	Recebe ou define um Booleano que indica se você quer 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 DTSBulkInsert_DataFileType enumeração que indica o valor do tipo de dado a ser usado na operação de carregamento.
DebugMode	Recebe ou define um Booleano que indica se uma tarefa deve determinar se os pontos de interrupção estão ativados.
DestinationConnection	Recebe ou define o nome do objeto de conexão de destino.
DestinationTableName	Recebe ou define o nome da tabela ou visualização de destino.
ExecutionValue	Retorna um objeto definido pelo usuário. O campo é somente leitura. (Herdado de Task)
FieldTerminator	Obtém ou configura o terminador de campo para uso em arquivos de dados char e widechar.
FireTriggers	Recebe ou define um Booleano 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 de onde começar a copiar.
FormatFile	Obtém ou define o caminho completo de um arquivo de formatação.
KeepIdentity	Obtém ou define um Booleano que especifica como valor ou valores identidade no arquivo de dados importados são usados para a coluna de identidade
KeepNulls	Recebe ou define um Booleano que indica se colunas vazias devem manter um valor nulo durante a operação de carregamento em massa, ou inserir valores padrão nas colunas.
LastRow	Recebe ou define o número da última linha para copiar.
MaximumErrors	Obtém ou define o número máximo de erros que podem ocorrer antes que a operação de inserção em massa falhe.
RowTerminator	Obtém ou configura o exterminador de linha para uso em arquivos de dados char e widechar.
SortedData	Recebe ou define a cláusula Order by na instrução bulk insert
SourceConnection	Recebe ou define o nome do objeto de conexão de origem.
SqlStatement	Recebe um array de String que contém a instrução Transact-SQL para executar.
SuspendRequired	Recebe ou define um Booleano que indica se as tarefas devem ser suspensas quando encontram um ponto de interrupção. Esse valor é definido pelo motor de execução para tarefas e contêineres quando um ponto de interrupção é encontrado.
TableLock	Recebe ou define um Booleano que indica se a tabela está travada durante a operação de inserção em massa.
TargetServerVersion	Fornece as propriedades e métodos para a tarefa Bulk Insert, que é a forma mais rápida de copiar grandes quantidades de dados para uma tabela ou visualização do SQL Server. Essa classe não pode ser herdada. (Herdado de Task)
UseFormatFile	Recebe ou define um Booleano que indica se a tarefa Inserir em Massa usa um arquivo de formatação.
Version	Membro descontinuado; veja Observações. Retorna a versão da tarefa. Esta propriedade é somente para leitura. (Herdado de Task)

Métodos

Nome	Description
AcceptBreakpointManager(BreakpointManager)	Chamado pelo motor de execução quando uma tarefa ou contêiner é criado, e é passado a BreakpointManager 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 no código.
CanUpdate(String)	Membro descontinuado; veja Observações. Um Booleano 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 Inserir em Massa.
GetConnectionID(Connections, String)	Recebe uma String contendo o ID da conexão. (Herdado de Task)
GetConnectionName(Connections, String)	Recebe uma String contendo o nome da conexão. (Herdado de Task)
GetHashCode()	Retorna o código hash dessa 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 no código.
LoadFromXML(XmlElement, IDTSInfoEvents)	Esse método não pode ser chamado pelo seu código de aplicação. Para carregar um pacote salvo como .xml, use o LoadPackage(String, IDTSEvents) método.
ResumeExecution()	Retoma a execução da tarefa após pausar. A tarefa ou contêiner é retomada pelo motor de execução.
SaveToXML(XmlDocument, IDTSInfoEvents)	Esse método não pode ser chamado pelo seu código de aplicação. Para salvar um pacote como .xml, use o SaveToXml(String, Package, IDTSEvents) método.
SuspendExecution()	Indica que o executável precisa ser suspenso. Esse método é chamado pelo motor de runtime.
Update(String)	Membro descontinuado; veja Observações. Esse método atualiza o pacote antigo XML com o novo pacote XML se CanUpdate(String) for definido como verdadeiro. (Herdado de Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Verifica se o componente de tarefa Bulk Insert está corretamente configurado.

Aplica-se a