sp_replmonitorhelpmergesession (Transact-SQL)

適用対象: SQL Server Azure 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 で、次のいずれかの範囲にすることができます。

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

[ @session_type = ] session_type

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

Value	説明
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を実行できます。

関連するコンテンツ

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