BulkInsertTask Clase

Definición

Proporciona las propiedades y los métodos para la tarea Inserción masiva, que es la forma más rápida de copiar grandes cantidades de datos en una tabla o vista de SQL Server. Esta clase no puede heredarse.

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
Herencia
BulkInsertTask
Atributos
Implementaciones

Comentarios

Para más información, consulte Bulk Insert Task.

Constructores

BulkInsertTask()

Inicializa una nueva instancia de la clase BulkInsertTask.

Propiedades

BatchSize

Obtiene o establece el número de filas en cada lote.

CheckConstraints

Obtiene o establece un valor booleano que indica si desea aplicar restricciones de comprobación de tablas y columnas.

CodePage

Obtiene o establece la página de códigos de los datos incluidos en el archivo de datos.

DataFileType

Obtiene o establece un valor de la enumeración DTSBulkInsert_DataFileType que indica el valor de tipo de datos que se va a utilizar en la operación de la carga.

DebugMode

Obtiene o establece un valor de tipo Boolean que indica si una tarea debería determinar si los puntos de interrupción están habilitados.

DestinationConnection

Obtiene o establece el nombre del objeto de conexión de destino.

DestinationTableName

Obtiene o establece el nombre de la tabla o vista de destino.

ExecutionValue

Devuelve un objeto definido por el usuario. Este campo es de solo lectura.

(Heredado de Task)
FieldTerminator

Obtiene o establece el terminador de campo para su uso en archivos de datos char y widechar.

FireTriggers

Obtiene o establece un valor booleano que indica si los desencadenadores de inserción se deben ejecutar en la tabla durante la operación.

FirstRow

Obtiene o establece la primera fila desde la que desea empezar a copiar.

FormatFile

Obtiene o establece la ruta de acceso completa de un archivo de formato.

KeepIdentity

Obtiene o establece un valor booleano que especifica cómo se usan los valores o el valor de identidad en el archivo de datos importado para la columna de identidad.

KeepNulls

Obtiene o establece un valor booleano que indica si las columnas vacías deben conservar un valor NULL durante la operación de carga masiva o insertar valores predeterminados en las columnas.

LastRow

Obtiene o establece el número de la última fila que se debe copiar.

MaximumErrors

Obtiene o establece el número máximo de errores que pueden ocurrir antes de que la operación de inserción masiva deje de funcionar.

RowTerminator

Obtiene o establece el terminador de fila para su uso en archivos de datos char y widechar.

SortedData

Obtiene o establece la cláusula Order by en la instrucción bulk insert.

SourceConnection

Obtiene o establece el nombre del objeto de conexión de origen.

SqlStatement

Obtiene una matriz String que contiene la instrucción Transact-SQL que se va a ejecutar.

SuspendRequired

Obtiene o establece un valor de tipo Boolean que indica si las tareas se deberían suspender al encontrar un punto de interrupción. El motor en tiempo de ejecución establece este valor para tareas y contenedores cuando se encuentra un punto de interrupción.

TableLock

Obtiene o establece un valor booleano que indica si la tabla está bloqueada durante la operación de inserción masiva.

TargetServerVersion

Proporciona las propiedades y los métodos para la tarea Inserción masiva, que es la forma más rápida de copiar grandes cantidades de datos en una tabla o vista de SQL Server. Esta clase no puede heredarse.

(Heredado de Task)
UseFormatFile

Obtiene o establece un valor booleano que indica si la tarea Inserción masiva usa un archivo de formato.

Version

*** Miembro desusado; ver Comentarios. *** Devuelve la versión de la tarea. Esta propiedad es de solo lectura.

(Heredado de Task)

Métodos

AcceptBreakpointManager(BreakpointManager)

Lo llama el motor en tiempo de ejecución al crear una tarea o un contenedor, y se le pasa un objeto BreakpointManager para permitir a la tarea crear, quitar y comprobar el estado de los puntos de interrupción. El motor en tiempo de ejecución llama a este método, que no se usa en el código.

CanUpdate(String)

*** Miembro desusado; ver Comentarios. Valor booleano que indica si el nuevo xml del paquete puede actualizar el XML del paquete anterior.

(Heredado de Task)
Equals(Object)

Determina si dos instancias de objeto son iguales.

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

Ejecuta la tarea Inserción masiva.

GetConnectionID(Connections, String)

Obtiene una cadena que contiene el identificador de la conexión.

(Heredado de Task)
GetConnectionName(Connections, String)

Obtiene una cadena que contiene el nombre de la conexión.

(Heredado de Task)
GetHashCode()

Devuelve el código hash de esta instancia.

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

Inicializa las propiedades asociadas a la tarea. El motor en tiempo de ejecución llama a este método, que no se usa en el código.

LoadFromXML(XmlElement, IDTSInfoEvents)

No se pueden realizar llamadas a este método desde el código de la aplicación. Para cargar un paquete guardado como .xml, utilice el método LoadPackage(String, IDTSEvents).

ResumeExecution()

Reanuda la ejecución de la tarea después de una pausa. El motor de ejecución se encarga de reanudar la tarea o el contenedor.

SaveToXML(XmlDocument, IDTSInfoEvents)

No se pueden realizar llamadas a este método desde el código de la aplicación. Para guardar un paquete como .xml, utilice el método SaveToXml(String, Package, IDTSEvents).

SuspendExecution()

Indica que el ejecutable se debe suspender. El motor de ejecución llama a este método.

Update(String)

*** Miembro desusado; ver Comentarios. Este método actualiza el XML del paquete antiguo con el nuevo XML de paquete si CanUpdate(String) se establece en true.

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

Comprueba si el componente de tarea de Inserción masiva está configurado correctamente.

Se aplica a