sp_replmonitorhelpmergesession (Transact-SQL)

適用対象: SQL ServerAzure SQL Managed Instance

特定のレプリケーション マージ エージェントの過去のセッションに関する情報を返します。フィルター条件に一致するセッションごとに 1 行が返されます。 マージ レプリケーションの監視に使用されるこのストアド プロシージャは、ディストリビューション データベースのディストリビューターまたはサブスクリプション データベースのサブスクライバーで実行されます。

Transact-SQL 構文表記規則

構文

sp_replmonitorhelpmergesession
    [ [ @agent_name = ] N'agent_name' ]
    [ , [ @hours = ] hours ]
    [ , [ @session_type = ] session_type ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
    [ , [ @publication = ] N'publication' ]
[ ; ]

引数

[ @agent_name = ] N'agent_name'

エージェントの名前。 @agent_nameは nvarchar(100) で、既定値はありません。

[ @hours = ] 時間

エージェント セッションの履歴情報が返される時間の範囲 (時間単位)。 @hoursは int であり、次のいずれかの範囲にすることができます。

値	説明
< 0	過去のエージェントの実行に関する情報を返します。最大 100 回の実行です。
0 (既定)	過去のすべてのエージェント実行に関する情報を返します。
> 0	過去 数時間 に発生したエージェントの実行に関する情報を返します。

[ @session_type = ] session_type

セッションの終了結果に応じて結果セットにフィルターを適用します。 @session_typeは int であり、これらの値のいずれかになります。

値	説明
1 (既定値)	再試行されたか成功したエージェント セッション。
0	失敗した結果を含むエージェント セッション。

[ @publisher = ] N'publisher'

パブリッシャーの名前。 @publisherは sysname で、既定値は NULL. このパラメーターは、サブスクライバーで実行 sp_replmonitorhelpmergesession するときに使用されます。

[ @publisher_db = ] N'publisher_db'

パブリケーション データベースの名前。 @publisher_dbは sysname で、既定値は NULL. このパラメーターは、サブスクライバーで実行 sp_replmonitorhelpmergesession するときに使用されます。

[ @publication = ] N'publication'

出版物の名前。 @publicationは sysname で、既定値は NULL. このパラメーターは、サブスクライバーで実行 sp_replmonitorhelpmergesession するときに使用されます。

結果セット

列名	データ型	説明
Session_id	int	エージェント ジョブ セッションの ID。
Status	int	エージェントの実行状態: 1 = 開始 2 = 成功 3 = 進行中 4 = アイドル 5 = 再試行 6 = 失敗
StartTime	datetime	タイム エージェント ジョブ セッションが開始されました。
EndTime	datetime	タイム エージェント ジョブ セッションが完了しました。
Duration	int	このジョブ セッションの累積期間 (秒)。
UploadedCommands	int	エージェント セッション中にアップロードされたコマンドの数。
DownloadedCommands	int	エージェント セッション中にダウンロードされたコマンドの数。
ErrorMessages	int	エージェント セッション中に生成されたエラー メッセージ数。
ErrorID	int	発生したエラーの ID です。
PercentageDone	decimal	アクティブなセッションで既に配信されている変更の合計の推定割合。
TimeRemaining	int	アクティブなセッションの残りの推定秒数。
CurrentPhase	int	アクティブなセッションの現在のフェーズ。次のいずれかになります。 1 = アップロード 2 = ダウンロード
LastMessage	nvarchar(500)	セッション中にマージ エージェントによってログに記録された最後のメッセージ。

リターン コードの値

0 (成功) または 1 (失敗)。

解説

sp_replmonitorhelpmergesession は、マージ レプリケーションを監視するために使用されます。

サブスクライバーで実行された場合、sp_replmonitorhelpmergesession最後の 5 つのマージ エージェント セッションに関する情報のみが返されます。

アクセス許可

ディストリビューターのディストリビューション データベースまたはサブスクライバーの サブスクリプション データベースで、db_owner または replmonitor 固定データベース ロールのメンバーのみが実行 sp_replmonitorhelpmergesessionできます。

関連するコンテンツ

• プログラムによるレプリケーションの監視