データベース転送タスク
適用対象: SQL Server Azure Data Factory の SSIS 統合ランタイム
データベース転送タスクは、SQL Server の 2 つのインスタンスの間で SQL Server データベースを転送します。 SQL Server オブジェクトをコピーして転送するだけの他のタスクに対し、データベース転送タスクでは、データベースをコピーまたは移動できます。 このタスクを使用して、同じサーバー内でデータベースをコピーすることもできます。
オフライン モードとオンライン モード
データベースは、オンライン モードまたはオフライン モードで転送できます。 オンライン モードでは、データベースがアタッチされたまま、SQL 管理オブジェクト (SMO) を使用して転送され、データベース オブジェクトがコピーされます。 オフライン モードでは、データベースがデタッチされた後、データベース ファイルがコピーまたは移動されます。転送が正常に完了した後、データベースが転送先にアタッチされます。 データベースのコピーの場合、コピーが正常に完了するとデータベースは転送元に再びアタッチされます。 オフライン モードでは、データベースは短時間にコピーされますが、転送が行われている間はデータベースを利用できなくなります。
オフライン モードを使用する場合は、転送元サーバーと転送先サーバー上でデータベース ファイルを格納するネットワーク ファイル共有を指定する必要があります。 このフォルダーが共有されていてユーザーがフォルダーにアクセスできる場合、\\computername\Program Files\myfolder\ という構文を使用してネットワーク共有を参照できます。 それ以外の場合は、\\computername\c$\Program Files\myfolder\ という構文を使用する必要があります。 後者の構文を使用するには、転送元と転送先のネットワーク共有に対する書き込みアクセスがユーザーに許可されている必要があります。
SQL Server のバージョン間でのデータベースの転送
データベース転送タスクは、異なるバージョンの SQL Server のインスタンス間でデータベースを転送できます。
events
データベース転送タスクでは、エラー メッセージ転送の進捗状況は報告されません。0% または 100% 完了した場合のみ報告されます。
実行値
タスクの ExecutionValue プロパティで定義される実行値は、値 1 を返します。これは、他の転送タスクとは異なり、データベース転送タスクでは 1 つのデータベースしか転送できないためです。
データベース転送タスクの ExecValueVariable プロパティにユーザー定義変数を割り当てると、エラー メッセージ転送に関する情報をパッケージ内の他のオブジェクトで利用できるようになります。 詳細については、「Integration Services (SSIS) の変数」と「パッケージで変数を使用する」を参照してください。
ログ エントリ
データベース転送タスクには、次のカスタム ログ エントリが含まれています。
SourceSQLServer: このログ エントリは、転送元サーバーの名前を一覧表示します。
DestSQLServer: このログ エントリは、転送先サーバーの名前を一覧表示します。
SourceDB: このログ エントリは、転送されたデータベースの名前を一覧表示します。
さらに、転送先データベースが上書きされたときに、 OnInformation イベントのログ エントリが書き込まれます。
セキュリティとアクセス許可
オフライン モードを使用してデータベースを転送するには、パッケージを実行するユーザーが sysadmin サーバー ロールのメンバーである必要があります。
オンライン モードを使用してデータベースを転送するには、パッケージを実行するユーザーが sysadmin サーバー ロールのメンバーであるか、または選択されたデータベースのデータベース所有者 (dbo) である必要があります。
データベース転送タスクの構成
データベースの転送が失敗した場合に転送元データベースへの再アタッチを試行するかどうかを指定できます。
さらに、データベース転送タスクでは、転送先に同じ名前のデータベースが存在する場合にそのデータベースを上書きするように構成できます。
転送プロセスの一部として、転送元データベースの名前を変更することもできます。 転送先の SQL Server のインスタンスに同じ名前のデータベースが存在する場合にデータベースを転送するには、転送元データベースの名前を変更することでデータベースを転送できます。 ただし、データベース ファイルの名前も異なっている必要があります。同じ名前のデータベース ファイルが転送先に既に存在すると、タスクは失敗します。
データベースをコピーする場合、データベースのサイズは、コピー先サーバーの model データベースのサイズより小さくすることはできません。 コピーするデータベースのサイズを大きくするか、 modelデータベースのサイズを小さくできます。
実行時、データベース転送タスクは、1 つまたは 2 つの SMO 接続マネージャーを使用して、転送元サーバーと転送先サーバーに接続します。 同じサーバー上にデータベースのコピーを作成する場合は、SMO 接続マネージャーが 1 つだけ必要です。 これらの SMO 接続マネージャーはデータベース転送タスクとは別に構成され、データベース転送タスクで参照されます。 SMO 接続マネージャーは、サーバーと、タスクがこのサーバーにアクセスするときに使用する認証モードを指定します。 詳細については、「 SMO 接続マネージャー」をご覧ください。
プロパティを設定するには SSIS デザイナーから行うか、またはプログラムによって設定します。
SSIS デザイナーで設定できるプロパティの詳細については、次のトピックを参照してください。
SSIS デザイナーでこれらのプロパティを設定する方法については、次のトピックを参照してください。
プログラムによるデータベース転送タスクの構成
プログラムによってこれらのプロパティを設定する方法の詳細については、次のトピックを参照してください。
[データベース転送タスク エディター] ([全般] ページ)
[データベース転送タスク エディター] ダイアログ ボックスの [全般] ページを使用すると、データベース転送タスクの名前と説明を入力できます。 データベース転送タスクは、SQL Server の 2 つのインスタンスの間で SQL Server データベースをコピーまたは移動します。 このタスクを使用して、同じサーバー内でデータベースをコピーすることもできます。
オプション
Name
データベース転送タスクの一意な名前を入力します。 この名前は、タスク アイコンのラベルとして使用されます。
Note
タスク名はパッケージ内で一意である必要があります。
説明
データベース転送タスクの説明を入力します。
[データベース転送タスク エディター] ([データベース] ページ)
[データベース転送タスク エディター] ダイアログ ボックスの [データベース] ページを使用すると、データベース転送タスクに使用される転送元および転送先のデータベースのプロパティを指定できます。 データベース転送タスクは、SQL Server の 2 つのインスタンスの間で SQL Server データベースをコピーまたは移動します。 このタスクを使用して、同じサーバー内でデータベースをコピーすることもできます。
オプション
SourceConnection
SMO 接続マネージャーを一覧から選択するか、<[新しい接続]> をクリックしてコピー元のサーバーへの新しい接続を作成します。
DestinationConnection
SMO 接続マネージャーを一覧から選択するか、<[新しい接続]> をクリックしてコピー先のサーバーへの新しい接続を作成します。
[DestinationDatabaseName]
転送先サーバーの SQL Server データベースの名前を指定します。
このフィールドにソース データベースの名前を自動的に入力するには、 [SourceConnection] と [SourceDatabaseName] を先に指定します。
転送先サーバー上のデータベースの名前を変更するには、このフィールドに新しい名前を入力します。
[DestinationDatabaseFiles]
転送先サーバーにおけるデータベース ファイルの名前と場所を指定します。
このフィールドにソース データベース ファイルの名前と場所を自動的に入力するには、 [SourceConnection] 、 [SourceDatabaseName] 、 [SourceDatabaseFiles] を先に指定します。
データベース ファイルの名前を変更するか、転送先サーバー上の新しい場所を指定するには、このフィールドにソース データベースの情報を入力した後、参照ボタンをクリックします。 [転送先データベース ファイル] ダイアログ ボックスで、 [転送先ファイル] 、 [転送先フォルダー] 、または [ネットワーク ファイル共有] を編集します。
Note
参照ボタンを使用してデータベース ファイルを指定した場合、ファイルの場所はローカル ドライブの表記 (c:\ など) を使用して入力されます。 これをコンピューター名と共有名を含むネットワーク共有の表記に変える必要があります。 既定の管理共有を使用する場合、$ 表記を使用し、その共有に対する管理アクセスを行える必要があります。
[DestinationOverwrite]
転送先サーバーのデータベースを上書きできるかどうかを指定します。
このプロパティには、次の表に示すオプションがあります。
値 | 説明 |
---|---|
True にします | 転送先サーバーのデータベースを上書きします。 |
False | 転送先サーバーのデータベースを上書きしません。 |
注意事項
[DestinationOverwrite] に [True] を指定した場合、転送先サーバーのデータベースのデータが上書きされます。これにより、データが失われる可能性があります。 データが失われないようにするには、データベース転送タスクを実行する前に、転送先サーバーのデータベースを別の場所にバックアップしておきます。
操作
タスクによってデータベースを転送先サーバーにコピー ( [Copy] ) するのか移動 ( [Move] ) するのかを指定します。
方法
転送元サーバーのデータベースがオンライン モードのときにタスクを実行するか、オフライン モードのときに実行するかを指定します。
オフライン モードを使用してデータベースを転送するには、パッケージを実行するユーザーが sysadmin 固定サーバー ロールのメンバーである必要があります。
オンライン モードを使用してデータベースを転送するには、パッケージを実行するユーザーが sysadmin 固定サーバー ロールのメンバーであるか、選択されたデータベースのデータベース所有者 (dbo) である必要があります。
[SourceDatabaseName]
コピーまたは移動されるデータベースの名前を選択します。
[SourceDatabaseFiles]
参照ボタンをクリックして、データベース ファイルを選択します。
[ReattachSourceDatabase]
失敗した場合に、ソース データベースの再アタッチを試行するかどうかを指定します。
このプロパティには、次の表に示すオプションがあります。
値 | 説明 |
---|---|
True にします | ソース データベースを再アタッチします。 |
False | ソース データベースを再アタッチしません。 |
[転送元のデータベース ファイル]
[転送元のデータベース ファイル] ダイアログ ボックスを使用すると、ソース サーバーのデータベース ファイルの名前と場所を表示したり、データベース転送タスクのネットワーク ファイル共有の場所を指定したりできます。
このダイアログ ボックスにソース サーバーのデータベース ファイルの名前と場所を入力するには、最初に [データベース転送タスク エディター] ダイアログ ボックスの [データベース] ページで [SourceConnection] および [SourceDatabaseName] を指定します。
オプション
[転送元ファイル]
転送する対象のソース サーバーのデータベース ファイル名です。 [転送元ファイル] は読み取り専用です。
[同期元フォルダー]
転送する対象データベース ファイルが存在する転送元サーバーのフォルダーです。 [転送元フォルダー] は読み取り専用です。
[ネットワーク ファイル共有]
データベース ファイルの転送元となるソース サーバーのネットワーク共有フォルダーです。 [ネットワーク ファイル共有] は、データベースをオフライン モードで転送する場合に使用します。 [データベース転送タスク エディター] ダイアログ ボックスの [データベース] ページの [Method] に、 [DatabaseOffline] を指定します。
ネットワーク ファイル共有の場所を入力するか、参照ボタン ([...]) をクリックしてネットワーク ファイル共有の場所を見つけます。
オフライン モードでデータベースを転送すると、データベースは転送先サーバーに転送される前に、転送元サーバーの [ネットワーク ファイル共有] の場所にコピーされます。
[転送先データベース ファイル]
[転送先データベース ファイル] ダイアログ ボックスを使用すると、転送先サーバーのデータベース ファイルの名前と場所を表示または変更したり、データベース転送タスクのネットワーク ファイルの場所を指定したりできます。
このダイアログ ボックスで転送元サーバーのデータベース ファイルの名前と場所を自動的に入力するには、最初に [データベース転送タスク エディター] ダイアログ ボックスの [データベース] ページで、 [SourceConnection] 、 [SourceDatabaseName] 、および [SourceDatabaseFiles] を指定します。
オプション
[転送先ファイル]
転送先サーバーの転送されたデータベース ファイルの名前です。
ファイル名を入力するか、ファイル名をクリックして編集します。
[同期先フォルダー]
データベース ファイルの転送先となる転送先サーバーのフォルダーです。
フォルダー パスを入力するか、フォルダー パスをクリックして編集するか、参照ボタンをクリックしてデータベース ファイルを転送する転送先サーバーのフォルダーを指定します。
[ネットワーク ファイル共有]
データベース ファイルの転送先となる転送先サーバーのネットワーク共有フォルダーです。 [ネットワーク ファイル共有] は、データベースをオフライン モードで転送する場合に使用します。 [データベース転送タスク エディター] ダイアログ ボックスの [データベース] ページの [Method] に、 [DatabaseOffline] を指定します。
ネットワーク ファイル共有の場所を入力するか、参照ボタンをクリックしてネットワーク ファイル共有の場所を見つけます。
オフライン モードでデータベースを転送すると、データベース ファイルは [転送先フォルダー] で指定した場所に転送される前に、 [ネットワーク ファイル共有] で指定した場所にコピーされます。