Partilhar via


TransferDatabaseTask Classe

Definição

Permite a transferência de um banco de dados entre um servidor de origem e um servidor de destino que usa dois métodos diferentes: banco de dados online e banco de dados offline. A tarefa requer o uso de um Gerenciador de Conexões SMO.

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

Comentários

A transferência pode ocorrer entre bancos de dados da mesma versão ou para uma versão mais alta. Para obter mais informações, consulte Transferir Tarefa de Banco de Dados.

Construtores

TransferDatabaseTask()

Inicializa uma nova instância da classe TransferDatabaseTask.

Propriedades

Action

Obtém ou define um valor da enumeração TransferAction que indica se a tarefa de Banco de dados de Transferência está copiando ou movendo bancos de dados.

DestinationConnection

Obtém ou define uma cadeia de caracteres que contém o nome do gerenciador de conexões SMO para o banco de dados de destino.

DestinationDatabaseFiles

Obtém ou define uma cadeia de caracteres que contém o nome dos arquivos de banco de dados para o banco de dados de destino.

DestinationDatabaseName

Obtém ou define uma cadeia de caracteres que contém o nome do banco de dados no destino.

DestinationOverwrite

Obtém ou define um booliano que indica se o banco de dados de destino pode ser substituído se ele existir.

ExecutionValue

Retorna o resultado da execução da tarefa.

Method

Obtém ou define um valor da enumeração TransferMethod que indica se deve-se usar o método de transferência Online ou Offline.

ReattachSourceDatabase

Um booliano que indica se o banco de dados deve ser reanexado ou não.

SourceConnection

Obtém ou define uma cadeia de caracteres que contém o nome do gerenciador de conexões SMO para o banco de dados de origem.

SourceDatabaseFiles

Obtém ou define uma cadeia de caracteres que contém os nomes dos arquivos de banco de dados de origem a serem transferidos.

SourceDatabaseName

Obtém ou define uma cadeia de caracteres que contém o nome do banco de dados de origem a ser transferido.

TargetServerVersion

Permite a transferência de um banco de dados entre um servidor de origem e um servidor de destino que usa dois métodos diferentes: banco de dados online e banco de dados offline. A tarefa requer o uso de um Gerenciador de Conexões SMO.

(Herdado de Task)
Version

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

(Herdado de Task)

Métodos

CanUpdate(String)

Membro preterido; ver Comentários. Um Boolean 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.

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).

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).

Update(String)

Membro preterido; ver Comentários. Esse método atualiza 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 está configurado corretamente.

Aplica-se a