TransferDatabaseTask クラス

定義

2 つの異なる方法 (データベース オンラインとデータベース オフライン) を使用して、転送元サーバーと転送先サーバー間でのデータベースの転送を可能にします。 このタスクでは、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
継承
TransferDatabaseTask
属性
実装

注釈

同じバージョンのデータベースどうし、またはあるバージョンから上位バージョンのデータベースへの転送が可能です。 詳細については、「 データベース転送タスク」を参照してください。

コンストラクター

TransferDatabaseTask()

TransferDatabaseTask クラスの新しいインスタンスを初期化します。

プロパティ

Action

データベース転送タスクでデータベースをコピーまたは移動するかを示す値を TransferAction 列挙から取得します。値の設定も可能です。

DestinationConnection

変換先データベースの SMO 接続マネージャーの名前を含む文字列 を取得または設定します。

DestinationDatabaseFiles

変換先データベースのデータベース ファイルの名前を含む文字列 を取得または設定します。

DestinationDatabaseName

変換先のデータベースの名前を含む文字列を取得または設定します。

DestinationOverwrite

コピー先データベースが存在する場合に上書きできるかどうかを示すブール型 (Boolean) の値を取得または設定します。

ExecutionValue

タスクの実行結果を返します。

Method

オンラインとオフラインのどちらの転送方法を使用するかを示す値を TransferMethod 列挙から取得します。値の設定も可能です。

ReattachSourceDatabase

データベースを再アタッチするかどうかを示すブール値。

SourceConnection

ソース データベースの SMO 接続マネージャーの名前を含む文字列を取得または設定します。

SourceDatabaseFiles

転送するソース データベース ファイルの名前を含む文字列を取得または設定します。

SourceDatabaseName

転送するソース データベースの名前を含む文字列を取得または設定します。

TargetServerVersion

2 つの異なる方法 (データベース オンラインとデータベース オフライン) を使用して、転送元サーバーと転送先サーバー間でのデータベースの転送を可能にします。 このタスクでは、SMO 接続マネージャーを使用する必要があります。

(継承元 Task)
Version

*** このメンバーは非推奨です。「解説」を参照してください。 タスクのバージョンを返します。 このプロパティは読み取り専用です。

(継承元 Task)

メソッド

CanUpdate(String)

*** このメンバーは非推奨です。「解説」を参照してください。 新しいパッケージ XML が古いパッケージ XML を更新できるかどうかを示すブール値。

(継承元 Task)
Equals(Object)

2 つのオブジェクト インスタンスが等しいかどうかを判断します。

(継承元 DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)

タスクを実行します。

GetConnectionID(Connections, String)

接続の ID を含む文字列を取得します。

(継承元 Task)
GetConnectionName(Connections, String)

接続の名前を含む文字列を取得します。

(継承元 Task)
GetHashCode()

このインスタンスのハッシュ コードを返します。

(継承元 DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)

タスクに関連付けられたプロパティを初期化します。 このメソッドはランタイムから呼び出されるメソッドであり、コードでは使用されません。

LoadFromXML(XmlElement, IDTSInfoEvents)

このメソッドをアプリケーション コードから呼び出すことはできません。 .xml として保存されたパッケージを読み込むには、LoadPackage(String, IDTSEvents) メソッドを使用します。

SaveToXML(XmlDocument, IDTSInfoEvents)

このメソッドをアプリケーション コードから呼び出すことはできません。 パッケージを .xml として保存するには、SaveToXml(String, Package, IDTSEvents) メソッドを使用します。

Update(String)

*** このメンバーは非推奨です。「解説」を参照してください。 このメソッドは、true に設定されている場合 CanUpdate(String) 、新しいパッケージ XML で古いパッケージ XML を更新します。

(継承元 Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

タスク コンポーネントが正しく構成されていることを確認します。

適用対象