次の方法で共有


エラー メッセージ転送タスク

適用対象: SQL Server Azure Data Factory の SSIS 統合ランタイム

エラー メッセージ転送タスクは、 SQL Server インスタンス間で 1 つ以上の SQL Serverユーザー定義エラー メッセージを転送します。 ユーザー定義メッセージとは、ID の値が 50000 以上のメッセージのことです。 ID の値が 50000 未満のメッセージはシステム エラー メッセージなので、エラー メッセージ転送タスクを使用して転送することはできません。

エラー メッセージ転送タスクは、すべてのエラー メッセージを転送するか、指定したエラー メッセージだけを転送できるように、構成することができます。 ユーザー定義エラー メッセージはさまざまな言語で利用できます。このタスクでは、選択した言語のメッセージだけを転送するように構成できます。 他言語バージョンのメッセージを転送先サーバーに転送するには、コード ページ 1033 を使用した us_english バージョンのメッセージが転送先サーバーにあらかじめ存在している必要があります。

master データベースの sysmessages テーブルには、SQL Server で使用されるすべてのシステム エラー メッセージおよびユーザー定義エラー メッセージが格納されます。

転送対象のユーザー定義メッセージは、転送先に既に存在している可能性があります。 エラー メッセージは、その識別子と言語が同じ場合は、重複エラー メッセージとして定義されます。 エラー メッセージ転送タスクでは、既存のエラー メッセージの処理方法を次のように構成できます。

  • 既存のエラー メッセージを上書きします。

  • 重複するメッセージが存在する場合、タスクを失敗とします。

  • 重複エラー メッセージをスキップします。

実行時、エラー メッセージ転送タスクは、1 つまたは 2 つの SMO 接続マネージャーを使用して、転送元サーバーと転送先サーバーに接続します。 SMO 接続マネージャーの構成はエラー メッセージ転送タスクとは別に行い、エラー メッセージ転送タスクは接続マネージャーを参照します。 SMO 接続マネージャーは、サーバーと、このサーバーにアクセスするときに使用する認証モードを指定します。 詳細については、「 SMO 接続マネージャー」をご覧ください。

エラー メッセージ転送タスクは、転送元および転送先として SQL Server をサポートしています。 転送元または転送先として使用するバージョンに関する制限はありません。

events

このタスクは、転送されたエラー メッセージの数を報告する情報イベントを発生させます。

エラー メッセージ転送タスクでは、エラー メッセージ転送の進捗状況は報告されません。0% または 100% 完了した場合のみ報告されます。

実行値

このタスクの ExecutionValue プロパティに定義される実行値は、転送されたエラー メッセージの数を返します。 エラー メッセージ転送タスクの ExecValueVariable プロパティにユーザー定義変数を割り当てると、エラー メッセージ転送に関する情報をパッケージ内の他のオブジェクトで利用できるようになります。 詳細については、「Integration Services (SSIS) の変数」と「パッケージで変数を使用する」を参照してください。

ログ エントリ

エラー メッセージ転送タスクには、次のようなカスタム ログ エントリがあります。

  • TransferErrorMessagesTaskStartTransferringObjects: 転送が開始されたことを報告するログ エントリです。 ログ エントリには、開始時刻が含まれます。

  • TransferErrorMessagesTaskFinishedTransferringObjects: 転送が終了したことを報告するログ エントリです。 ログ エントリには、終了時刻が含まれます。

また、 OnInformation イベントのログ エントリは転送されたエラー メッセージの数をレポートし、 OnWarning event のログ エントリは転送先でエラー メッセージが上書きされるたびに書き込まれます。

セキュリティとアクセス許可

新しいエラー メッセージを作成する場合、パッケージを実行するユーザーは、転送先サーバーで sysadmin または serveradmin サーバー ロールのメンバーである必要があります。

エラー メッセージ転送タスクの構成

プロパティを設定するには SSIS デザイナーから行うか、またはプログラムによって設定します。

SSIS デザイナーで設定できるプロパティの詳細については、次のトピックを参照してください。

プログラムによってこれらのプロパティを設定する方法については、次のトピックを参照してください。

SSIS デザイナーでこれらのプロパティを設定する方法については、次のトピックを参照してください。

[エラー メッセージ転送タスク エディター] ([全般] ページ)

[エラー メッセージ転送タスク エディター] ダイアログ ボックスの [全般] ページを使用すると、エラー メッセージ転送タスクに名前を付けて説明を記述することができます。 エラー メッセージ転送タスクは、 SQL Server インスタンス間で 1 つ以上の SQL Serverユーザー定義エラー メッセージを転送します。

オプション

Name
エラー メッセージ転送タスクの一意の名前を入力します。 この名前は、タスク アイコンのラベルとして使用されます。

Note

タスク名はパッケージ内で一意である必要があります。

説明
エラー メッセージ転送タスクの説明を入力します。

[エラー メッセージ転送タスク エディター] ([メッセージ] ページ)

[エラー メッセージ転送タスク エディター] ダイアログ ボックスの [メッセージ] ページを使用すると、 SQL Server のインスタンスからインスタンスへ、 SQL Server ユーザー定義エラー メッセージをコピーする際のプロパティを指定できます。

オプション

SourceConnection
SMO 接続マネージャーを一覧から選択するか、<[新しい接続]> をクリックしてコピー元のサーバーへの新しい接続を作成します。

DestinationConnection
SMO 接続マネージャーを一覧から選択するか、<[新しい接続]> をクリックしてコピー先のサーバーへの新しい接続を作成します。

[IfObjectExists]
転送先サーバーに同じ名前のエラー メッセージが既に存在していた場合に、既存のユーザー定義エラー メッセージを上書きするか、既存のメッセージをスキップするか、タスクを失敗させるかを選択します。

[TransferAllErrorMessages]
転送元サーバーから転送先サーバーにすべてのユーザー定義メッセージをコピーするか、指定したユーザー定義メッセージだけをコピーするかを選択します。

このプロパティには、次の表に示すオプションがあります。

説明
True にします すべてのユーザー定義メッセージをコピーします。
False 指定されたユーザー定義メッセージのみをコピーします。

[ErrorMessagesList]
[...] ボタンをクリックして、コピーするエラー メッセージを選択します。

注意

コピーするエラー メッセージを選択する前に [SourceConnection] を指定する必要があります。

[ErrorMessageLanguagesList]
[...] ボタンをクリックして、転送先サーバーにコピーするユーザー定義エラー メッセージの言語を選択します。 us_english (コード ページ 1033) バージョンのメッセージが、他言語バージョンのメッセージを転送先サーバーに転送する前に、そのサーバーに既に存在している必要があります。

注意

コピーするエラー メッセージを選択する前に [SourceConnection] を指定する必要があります。

参照

Integration Services タスク
制御フロー