Master ストアド プロシージャ転送タスク
Master ストアド プロシージャ転送タスクは、SQL Server のインスタンス上の master データベース間で、1 つ以上のユーザー定義ストアド プロシージャを転送します。master データベースからストアド プロシージャを転送するには、プロシージャの所有者が dbo である必要があります。
Master ストアド プロシージャ転送タスクは、すべてのストアド プロシージャまたは指定したストアド プロシージャのみを転送するように設定できます。このタスクでは、システム ストアド プロシージャはコピーされません。
転送する master ストアド プロシージャが既に転送先に存在している場合もあります。Master ストアド プロシージャ転送タスクでは、既存のストアド プロシージャの処理を次のように設定できます。
- 既存のストアド プロシージャを上書きします。
- 重複するストアド プロシージャが存在する場合、タスクを失敗とします。
- 重複するストアド プロシージャをスキップします。
Master ストアド プロシージャ転送タスクは実行時に、2 つの SMO 接続マネージャを使用して、転送元および転送先サーバーに接続します。SMO 接続マネージャの構成は Master ストアド プロシージャ転送タスクとは別に行い、Master ストアド プロシージャ転送タスクは SMO 接続マネージャを参照します。SMO 接続マネージャは、サーバーと、サーバーに接続する際に使用する認証モードを指定します。詳細については、「SMO 接続マネージャ」を参照してください。
SQL Server のインスタンス間でのストアド プロシージャの転送
Master ストアド プロシージャ転送タスクでは、転送元または転送先として、SQL Server 2000 または SQL Server 2005 をサポートします。転送元または転送先として使用するバージョンに関する制限はありません。
イベント
Master ストアド プロシージャ転送タスクでは、転送されたストアド プロシージャの数を報告する情報イベントと、ストアド プロシージャが上書きされた場合の警告イベントが発生します。
Master ストアド プロシージャ転送タスクでは、増分中のログイン転送タスクの進捗状況は報告されません。0% または 100 % 完了した場合のみ報告されます。
実行値
タスクの ExecutionValue プロパティで定義する実行値は、転送されたストアド プロシージャの数を返します。Master ストアド プロシージャ転送タスクの ExecValueVariable プロパティにユーザー定義変数を割り当てると、パッケージの他のオブジェクトからストアド プロシージャの転送に関する情報を使用できるようになります。詳細については、「Integration Services の変数」および「パッケージでの変数の使用」を参照してください。
ログ エントリ
Master ストアド プロシージャ転送タスクには、次のようなカスタム ログ エントリがあります。
- TransferStoredProceduresTaskStartTransferringObjects 転送が開始されたことを報告するログ エントリです。ログ エントリには開始時刻が含まれます。
- TransferSStoredProceduresTaskFinishedTransferringObjects 転送が終了したことを報告するログ エントリです。ログ エントリには終了時刻が含まれます。
また、OnInformation イベントのログ エントリは転送されたストアド プロシージャの数を報告し、OnWarning イベントのログ エントリは転送先でストアド プロシージャが上書きされると書き込まれます。
セキュリティおよび権限
ソースの master データベースでストアド プロシージャの一覧を表示する権限が必要です。また、転送先サーバーの sysadmin サーバー ロールのメンバであるか、転送先サーバーの master データベースでストアド プロシージャを作成する権限を持つユーザーである必要があります。
Master ストアド プロシージャ転送タスクの構成
プロパティを設定するには、SSIS デザイナから行うか、またはプログラムによって設定します。
SSIS デザイナで設定できるプロパティの詳細については、次のトピックのいずれかを参照してください。
- [Master ストアド プロシージャ転送タスク エディタ] ([全般] ページ)
- [Master ストアド プロシージャ転送タスク エディタ] ([ストアド プロシージャ] ページ)
- [式] ページ
SSIS デザイナでこれらのプロパティを設定する方法については、次のトピックを参照してください。
プログラムによる Master ストアド プロシージャ転送タスクの構成
プログラムによってこれらのプロパティを設定する方法の詳細については、次のトピックを参照してください。
参照
概念
SQL Server オブジェクトの転送タスク
Integration Services タスク
パッケージの制御フローの作成