TransferDatabaseTask Classe

Définition

Permet le transfert d’une base de données entre un serveur source et un serveur de destination en utilisant deux méthodes différentes : la base de données en ligne et la base de données hors ligne. La tâche nécessite l’utilisation d’un SMO Gestionnaire des connexions.

public ref class TransferDatabaseTask sealed : Microsoft::SqlServer::Dts::Runtime::Task, Microsoft::SqlServer::Dts::Runtime::IDTSComponentPersist, Microsoft::SqlServer::Dts::Tasks::TransferDatabaseTask::ITransferDatabaseTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.transferdatabasetask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.Localized), SamplesTag="SsisTransferDatabaseTask", TaskContact="Transfer Database Task; Microsoft Corporation; SQL Server 2016; (C) Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.TransferDatabasesTaskUI.TransferDatabasesTaskUI, Microsoft.SqlServer.TransferDatabasesTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("87A575D4-76EA-487F-9493-0A5ACBDFBA3E")]
public sealed class TransferDatabaseTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.ITransferDatabaseTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.transferdatabasetask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.Localized), SamplesTag="SsisTransferDatabaseTask", TaskContact="Transfer Database Task; Microsoft Corporation; SQL Server 2017; (C) Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.TransferDatabasesTaskUI.TransferDatabasesTaskUI, Microsoft.SqlServer.TransferDatabasesTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("B74AA170-4BC7-43DF-B5A6-E560F0E02951")]
public sealed class TransferDatabaseTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.ITransferDatabaseTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.transferdatabasetask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.Localized), SamplesTag="SsisTransferDatabaseTask", TaskContact="Transfer Database Task; Microsoft Corporation; SQL Server 2019; (C) Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.TransferDatabasesTaskUI.TransferDatabasesTaskUI, Microsoft.SqlServer.TransferDatabasesTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("F609B862-C801-4560-A6C0-B152830A7FDB")]
public sealed class TransferDatabaseTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.ITransferDatabaseTask
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.transferdatabasetask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.Localized), SamplesTag="SsisTransferDatabaseTask", TaskContact="Transfer Database Task; Microsoft Corporation; SQL Server 2016; (C) Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.TransferDatabasesTaskUI.TransferDatabasesTaskUI, Microsoft.SqlServer.TransferDatabasesTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("87A575D4-76EA-487F-9493-0A5ACBDFBA3E")>]
type TransferDatabaseTask = class
    inherit Task
    interface ITransferDatabaseTask
    interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.transferdatabasetask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.Localized), SamplesTag="SsisTransferDatabaseTask", TaskContact="Transfer Database Task; Microsoft Corporation; SQL Server 2017; (C) Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.TransferDatabasesTaskUI.TransferDatabasesTaskUI, Microsoft.SqlServer.TransferDatabasesTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("B74AA170-4BC7-43DF-B5A6-E560F0E02951")>]
type TransferDatabaseTask = class
    inherit Task
    interface ITransferDatabaseTask
    interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.transferdatabasetask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask.Localized), SamplesTag="SsisTransferDatabaseTask", TaskContact="Transfer Database Task; Microsoft Corporation; SQL Server 2019; (C) Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.TransferDatabasesTaskUI.TransferDatabasesTaskUI, Microsoft.SqlServer.TransferDatabasesTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("F609B862-C801-4560-A6C0-B152830A7FDB")>]
type TransferDatabaseTask = class
    inherit Task
    interface ITransferDatabaseTask
    interface IDTSComponentPersist
Public NotInheritable Class TransferDatabaseTask
Inherits Task
Implements IDTSComponentPersist, ITransferDatabaseTask
Héritage
TransferDatabaseTask
Attributs
Implémente

Remarques

Le transfert peut se faire entre des bases de données de la même version, ou vers une version supérieure. Pour plus d’informations, voir Transfert de la tâche de base de données.

Constructeurs

Nom Description
TransferDatabaseTask()

Initialise une nouvelle instance de la classe TransferDatabaseTask.

Propriétés

Nom Description
Action

Obtient ou définit une valeur de l’énumération TransferAction indiquant si la tâche Transfert de base de données copie ou déplace des bases de données.

DestinationConnection

Obtient ou définit une chaîne contenant le nom du gestionnaire de connexion SMO pour la base de données de destination.

DestinationDatabaseFiles

Obtient ou définit une chaîne contenant le nom des fichiers de base de données de la base de données de destination.

DestinationDatabaseName

Obtient ou définit une chaîne contenant le nom de la base de données à destination.

DestinationOverwrite

Obtient ou définit un booléen indiquant si la base de données de destination peut être écrasée si elle existe.

ExecutionValue

Retourne le résultat de l’exécution de la tâche.

Method

Obtient ou définit une valeur de l’énumération TransferMethod indiquant s’il faut utiliser la méthode de transfert en ligne ou hors ligne.

ReattachSourceDatabase

Un booléen indiquant si la base doit être rattachée ou non.

SourceConnection

Obtient ou définit une chaîne contenant le nom du gestionnaire de connexion SMO pour la base de données source.

SourceDatabaseFiles

Obtient ou définit une chaîne contenant les noms des fichiers de base de données sources à transférer.

SourceDatabaseName

Obtient ou définit une chaîne contenant le nom de la base de données source à transférer.

TargetServerVersion

Permet le transfert d’une base de données entre un serveur source et un serveur de destination en utilisant deux méthodes différentes : la base de données en ligne et la base de données hors ligne. La tâche nécessite l’utilisation d’un SMO Gestionnaire des connexions.

(Hérité de Task)
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
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)

Il exécute la tâche.

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.

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.

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 est correctement configuré.

S’applique à