次の方法で共有


ReplicationMonitor.EnumQueueReaderAgentSessions メソッド

状態情報および統計情報を含む、キュー リーダー エージェント セッションに関する情報の一覧を返します。

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

構文

'宣言
Public Function EnumQueueReaderAgentSessions ( _
    distributionDatabase As String, _
    publicationId As Integer, _
    sessionDuration As Integer, _
    returnOnlyErrorSessions As Boolean _
) As DataSet
'使用
Dim instance As ReplicationMonitor 
Dim distributionDatabase As String 
Dim publicationId As Integer 
Dim sessionDuration As Integer 
Dim returnOnlyErrorSessions As Boolean 
Dim returnValue As DataSet 

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

パラメーター

  • distributionDatabase
    型: System.String
    ディストリビューション データベースを指定する String 値です。
  • publicationId
    型: System.Int32
    パブリケーションを一意に識別する ID 値を指定する Int32 値です。
  • sessionDuration
    型: System.Int32
    結果の制限範囲を示す現在の時刻までの時間数を指定する Int32 値です。 たとえば、値 24 は、現在までの過去 24 時間の間のエージェント セッションに関する情報を返します。 値 -1 は、現在までの過去 100 セッションに関する情報を返し、値 0 はすべてのセッションに関する情報を返します。
  • returnOnlyErrorSessions
    型: System.Boolean
    結果がエラーになったセッションに関する情報のみを返すか、すべてのセッションに関する情報を返すかを指定する Boolean 値です。 true の場合、エラー セッションのみが返されます。 false の場合、すべてのセッションが返されます。

戻り値

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

データ型

説明

runstatus

Int32

実行ステータスです。

1 = 開始

2 = 成功

3 = 進行中

4 = アイドル状態

5 = 再試行

6 = 失敗

start_time

String

前回のエージェント実行の日時です。

time

String

セッションがログに記録された日時です。

comments

String

エージェントによってログに記録されたメッセージ テキストです。

duration

Int32

セッションの経過時間 (秒) です。

delivery_rate

Single

1 秒あたりに配信される平均コマンド数です。

delivery_latency

Int32

コマンドが、パブリッシュされたデータベースにコミットされてから、ディストリビューション データベースにコミットされるまでの時間 (ミリ秒) です。

publication_id

Int32

パブリケーションの ID です。

transactions_processed

Int32

セッション中に配信されたトランザクションの総数です。

commands_processed

Int32

セッション中に配信されたコマンドの総数です。

average_commands

Int32

セッション中に配信された、トランザクションごとの平均コマンド数です。

action_count

Int32

セッションで記録されたエージェント ログ メッセージ数です。

error_id

Int32

MSrepl_errors (Transact-SQL) システム テーブル内のエラー ID です。エラーの詳細情報を返すには、EnumErrorRecords メソッドを使用します。

説明

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

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

関連項目

参照

ReplicationMonitor クラス

Microsoft.SqlServer.Replication 名前空間

その他の技術情報

レプリケーションをプログラムから監視する (RMO プログラミング)