sp_replmonitorhelpmergesession (Transact-SQL)
適用対象: 
SQL Server Azure SQL Managed Instance
特定のレプリケーション マージ エージェントの過去のセッションに関する情報を返します。フィルター条件に一致するセッションごとに 1 行が返されます。 マージ レプリケーションの監視に使用されるこのストアド プロシージャは、ディストリビューション データベースのディストリビューターまたはサブスクリプション データベースのサブスクライバーで実行されます。
構文
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を実行できます。