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 |
実行ステータスです。 1 = 開始 2 = 成功 3 = 進行中 4 = アイドル状態 5 = 再試行 6 = 失敗 |
|
start_time |
前回のエージェント実行の日時です。 |
|
time |
セッションがログに記録された日時です。 |
|
comments |
エージェントによってログに記録されたメッセージ テキストです。 |
|
duration |
セッションの経過時間 (秒) です。 |
|
delivery_rate |
1 秒あたりに配信される平均コマンド数です。 |
|
delivery_latency |
コマンドが、パブリッシュされたデータベースにコミットされてから、ディストリビューション データベースにコミットされるまでの時間 (ミリ秒) です。 |
|
publication_id |
パブリケーションの ID です。 |
|
transactions_processed |
セッション中に配信されたトランザクションの総数です。 |
|
commands_processed |
セッション中に配信されたコマンドの総数です。 |
|
average_commands |
セッション中に配信された、トランザクションごとの平均コマンド数です。 |
|
action_count |
セッションで記録されたエージェント ログ メッセージ数です。 |
|
error_id |
MSrepl_errors (Transact-SQL) システム テーブル内のエラー ID です。エラーの詳細情報を返すには、EnumErrorRecords メソッドを使用します。 |
説明
ReplicationMonitor オブジェクトのプロパティがまだ読み込まれていない場合は、読み込むことが必要になる可能性があるため、このメソッドを呼び出す前にこのオブジェクトのプロパティに対する変更をすべてコミットする必要があります。
EnumQueueReaderAgentSessions メソッドを呼び出すことができるのは、ディストリビューション データベースの固定データベース ロール db_owner または replmonitor のメンバーだけです。
関連項目
参照
Microsoft.SqlServer.Replication 名前空間