BulkInsertTask Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit les propriétés et méthodes de la tâche Insertion en masse, qui est le moyen le plus rapide de copier de grandes quantités de données dans une table ou une vue SQL Server. Cette classe ne peut pas être héritée.
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
- Héritage
- Attributs
- Implémente
Remarques
Pour plus d’informations, consultez Tâche d’insertion en bloc.
Constructeurs
| Nom | Description |
|---|---|
| BulkInsertTask() |
Initialise une nouvelle instance de la classe BulkInsertTask. |
Propriétés
| Nom | Description |
|---|---|
| BatchSize |
Obtient ou définit le nombre de lignes dans chaque lot. |
| CheckConstraints |
Obtient ou définit un booléen qui indique si vous souhaitez appliquer des contraintes de vérification de table et de colonne. |
| CodePage |
Obtient ou définit la page de codes des données dans le fichier de données. |
| DataFileType |
Obtient ou définit une valeur de l’énumération DTSBulkInsert_DataFileType qui indique la valeur du type de données à utiliser lors de l’opération de chargement. |
| DebugMode |
Obtient ou définit un booléen qui indique si une tâche doit déterminer si les points d’arrêt sont activés. |
| DestinationConnection |
Obtient ou définit le nom de l’objet de connexion de destination. |
| DestinationTableName |
Obtient ou définit le nom de la table ou de la vue de destination. |
| ExecutionValue |
Retourne un objet défini par l’utilisateur. Ce champ est en lecture seule. (Hérité de Task) |
| FieldTerminator |
Obtient ou définit le terminateur de champ pour être utilisé dans les fichiers de données char et widechar. |
| FireTriggers |
Obtient ou définit un booléen qui indique si les déclencheurs d’insertion doivent être exécutés sur la table pendant l’opération. |
| FirstRow |
Obtient ou définit la première ligne à partir de laquelle commencer à copier. |
| FormatFile |
Obtient ou définit le chemin complet d’un fichier format. |
| KeepIdentity |
Obtient ou définit un booléen qui spécifie comment la ou les valeurs d’identité dans le fichier de données importé sont utilisées pour la colonne d’identité |
| KeepNulls |
Obtient ou définit un booléen qui indique si les colonnes vides doivent conserver une valeur nulle lors de l’opération de chargement en masse, ou insérer des valeurs par défaut dans les colonnes. |
| LastRow |
Obtient ou fixe le numéro de la dernière ligne à copier. |
| MaximumErrors |
Obtient ou règle le nombre maximal d’erreurs pouvant survenir avant l’échec de l’opération d’insertion en masse. |
| RowTerminator |
Obtient ou définit le terminator de ligne pour être utilisé dans les fichiers de données char et widechar. |
| SortedData |
Obtient ou définit la clause Order by dans l’instruction bulk insert |
| SourceConnection |
Obtient ou définit le nom de l’objet source de connexion. |
| SqlStatement |
Obtient un tableau de chaînes qui contient l’instruction Transact-SQL à exécuter. |
| SuspendRequired |
Obtient ou définit un booléen qui indique si les tâches doivent être suspendues lorsqu’elles rencontrent un point d’arrêt. Cette valeur est définie par le moteur d’exécution pour les tâches et conteneurs lorsqu’un point d’arrêt est rencontré. |
| TableLock |
Obtient ou pose un booléen qui indique si la table est verrouillée lors de l’opération d’insertion en masse. |
| TargetServerVersion |
Fournit les propriétés et méthodes de la tâche Insertion en masse, qui est le moyen le plus rapide de copier de grandes quantités de données dans une table ou une vue SQL Server. Cette classe ne peut pas être héritée. (Hérité de Task) |
| UseFormatFile |
Obtient ou définit un Booléen qui indique si la tâche Insertion en masse utilise un fichier formaté. |
| Version |
membre déprécié ; voir Remarques. Retourne la version de la tâche. Cette propriété est en lecture seule. (Hérité de Task) |
Méthodes
| Nom | Description |
|---|---|
| AcceptBreakpointManager(BreakpointManager) |
Appelé par le moteur d’exécution lors de la création d’une tâche ou d’un conteneur, et est transmis pour BreakpointManager permettre à la tâche de créer, supprimer et vérifier l’état des points d’arrêt. Cette méthode est appelée par l’exécution et n’est pas utilisée dans le code. |
| CanUpdate(String) |
membre déprécié ; voir Remarques. Un booléen qui indique si le nouveau package XML peut mettre à jour l’ancien package XML. (Hérité de Task) |
| Equals(Object) |
Détermine si deux instances d’objet sont égales. (Hérité de DtsObject) |
| Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object) |
Exécute la tâche Insertion en masse. |
| GetConnectionID(Connections, String) |
Obtient une chaîne contenant l’ID de la connexion. (Hérité de Task) |
| GetConnectionName(Connections, String) |
Obtient une chaîne contenant le nom de la connexion. (Hérité de Task) |
| GetHashCode() |
Retourne le code de hachage pour cette instance. (Hérité de DtsObject) |
| InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker) |
Initialise les propriétés associées à la tâche. Cette méthode est appelée par l’exécution et n’est pas utilisée dans le code. |
| LoadFromXML(XmlElement, IDTSInfoEvents) |
Cette méthode n’est pas appelable par votre code d’application. Pour charger un colis enregistré en tant que .xml, utilisez la LoadPackage(String, IDTSEvents) méthode. |
| ResumeExecution() |
Reprend l’exécution de la tâche après une pause. La tâche ou le conteneur est repris par le moteur d’exécution. |
| SaveToXML(XmlDocument, IDTSInfoEvents) |
Cette méthode n’est pas appelable par votre code d’application. Pour enregistrer un paquet en tant que .xml, utilisez la SaveToXml(String, Package, IDTSEvents) méthode. |
| SuspendExecution() |
Indique que l’exécutable doit être suspendu. Cette méthode est appelée par le moteur d’exécution. |
| Update(String) |
membre déprécié ; voir Remarques. Cette méthode met à jour l’ancien package XML avec le nouveau package XML si CanUpdate(String) est réglé sur true. (Hérité de Task) |
| Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging) |
Vérifie que le composant de tâche Insertion en masse est correctement configuré. |