EnumMergeAgentSessions2 メソッド

マージ エージェント セッションに関する追加情報を返します。

名前空間:  Microsoft.SqlServer.Replication
アセンブリ:  Microsoft.SqlServer.Rmo (Microsoft.SqlServer.Rmo.dll)

構文

'宣言
Public Function EnumMergeAgentSessions2 ( _
    agentName As String, _
    sessionDuration As Integer, _
    returnOnlyErrorSessions As Boolean _
) As DataSet
'使用
Dim instance As PublisherMonitor
Dim agentName As String
Dim sessionDuration As Integer
Dim returnOnlyErrorSessions As Boolean
Dim returnValue As DataSet

returnValue = instance.EnumMergeAgentSessions2(agentName, _
    sessionDuration, returnOnlyErrorSessions)
public DataSet EnumMergeAgentSessions2(
    string agentName,
    int sessionDuration,
    bool returnOnlyErrorSessions
)
public:
DataSet^ EnumMergeAgentSessions2(
    String^ agentName, 
    int sessionDuration, 
    bool returnOnlyErrorSessions
)
member EnumMergeAgentSessions2 : 
        agentName:string * 
        sessionDuration:int * 
        returnOnlyErrorSessions:bool -> DataSet 
public function EnumMergeAgentSessions2(
    agentName : String, 
    sessionDuration : int, 
    returnOnlyErrorSessions : boolean
) : DataSet

パラメーター

  • sessionDuration
    型: System. . :: . .Int32
    結果の制限範囲を示す現在の時刻までの時間数を指定する Int32 値です。たとえば、値 24 は、現在までの過去 24 時間の間のエージェント セッションに関する情報を返します。値 -1 は、現在までの過去 100 セッションに関する情報を返し、値 0 はすべてのセッションに関する情報を返します。
  • returnOnlyErrorSessions
    型: System. . :: . .Boolean
    結果がエラーになったセッションに関する情報のみを返すか、すべてのセッションに関する情報を返すかを指定する Boolean 値です。true の場合、エラー セッションのみが返されます。false の場合、すべてのセッションが返されます。

戻り値

型: System.Data. . :: . .DataSet
次の列を含む DataSet オブジェクトです。

データ型

説明

Session_id

Int32

エージェント ジョブ セッションの ID です。

Status

Int32

エージェント実行状態。

1 = 開始

2 = 成功

3 = 進行中

4 = アイドル状態

5 = 再試行

6 = 失敗

StartTime

DateTime

エージェント ジョブ セッションが開始した時刻です。

EndTime

DateTime

エージェント ジョブ セッションが完了した時刻です。

Duration

Int32

エージェント ジョブ セッションの累積時間 (秒) です。

UploadedCommands

Int32

エージェント ジョブ セッションの間にアップロードされたコマンド数です。

DownloadedCommands

Int32

エージェント ジョブ セッションの間にダウンロードされたコマンド数です。

ErrorMessages

Int32

エージェント ジョブ セッションの間に生成されたエラー メッセージの数です。

ErrorID

Int32

発生したエラーの ID です。

PercentageDone

Decimal

アクティブなセッションで既に配信された総変更数の推定割合です。

TimeRemaining

Int32

アクティブなセッションでの推定残り秒数。

CurrentPhase

Int32

アクティブなセッションの現在のフェーズです。次のいずれかの値をとります。

1 = アップロード

2 = ダウンロード

LastMessage

String

セッション中にマージ エージェントによってログに記録された最後のメッセージです。

説明

PublisherMonitor オブジェクトのプロパティがまだ読み込まれていない場合は、読み込むことが必要になる可能性があるため、このメソッドを呼び出す前にこのオブジェクトのプロパティに対する変更をすべてコミットする必要があります。

EnumMergeAgentSessions2 メソッドを呼び出せるのは、ディストリビューション データベースの固定データベース ロール db_owner または replmonitor のメンバだけです。

EnumMergeAgentSessions2 を呼び出すと、sp_replmonitorhelpmergesession (Transact-SQL) を実行したのと同じことになります。

この名前空間、クラス、またはメンバは、.NET Framework 2.0 でのみサポートされています。