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_namenvarchar(100)で、既定値はありません。

[ @hours = ] 時間

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

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

[ @session_type = ] session_type

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

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

[ @publisher = ] N'publisher'

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

[ @publisher_db = ] N'publisher_db'

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

[ @publication = ] N'publication'

出版物の名前。 @publicationsysname で、既定値は 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を実行できます。