PublisherMonitor.EnumDistributionAgentSessions(String, Int32, Boolean) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ディストリビューション エージェントセッションに関する情報を返します。
public:
System::Data::DataSet ^ EnumDistributionAgentSessions(System::String ^ agentName, int sessionDuration, bool returnOnlyErrorSessions);public System.Data.DataSet EnumDistributionAgentSessions(string agentName, int sessionDuration, bool returnOnlyErrorSessions);member this.EnumDistributionAgentSessions : string * int * bool -> System.Data.DataSetPublic Function EnumDistributionAgentSessions (agentName As String, sessionDuration As Integer, returnOnlyErrorSessions As Boolean) As DataSetパラメーター
- agentName
- String
ディストリビューション エージェントジョブの名前を指定するStringの値です。 TransSubscriptionオブジェクトのSynchronizationAgentName特性を使ってこの値を得ることができます。
- sessionDuration
- Int32
現在の時間までに制限する時間数を示す Int32 値。 例えば、24の値は過去24時間のディストリビューション エージェントセッションに関する情報を返します。 -1 の値は直近100セッションの情報を返し、0の値はすべてのセッションの情報を返します。
- returnOnlyErrorSessions
- Boolean
エラーを引き起こしたセッションのみを返すか、すべてのセッションに対して情報を返すかを指定する Boolean の値は。
true場合はエラーセッションのみが返されます。
falseがいれば、すべてのセッションは返却されます。
返品
以下の列を含む DataSet オブジェクトです。
| コラム | データ タイプ | 説明 |
|---|---|---|
| ランステータス | Int32 | 運行状況: 1 = スタート 2 = 成功 3 = 進行中 4 = アイドル 5 = 再挑戦 6 = 失敗 |
| start_time | String | 最後のエージェント処刑の日時。 |
| time | String | セッションが記録された日時。 |
| コメント | String | エージェントが記録したメッセージのテキスト。 |
| 期間 | Int32 | セッションの経過時間を秒単位で示す。 |
| delivery_rate | Single | 1秒あたりに平均数のコマンドを伝えます。 |
| delivery_latency | Int32 | トランザクションが配布データベースに入力されてから加入者に適用されるまでの遅延(ミリ秒単位)です。 |
| (列名なし) | 該当しない | 内部使用のみ。 |
| delivered_transactions | Int32 | セッションで配信されたトランザクションの総数。 |
| delivered_commands | Int32 | セッションで実行されたコマンドの総数。 |
| average_commands | Int32 | セッションで配信されたトランザクションあたりの平均コマンド数。 |
| action_count | Int32 | セッション中に記録されたエージェントログメッセージの数。 |
| error_id | Int32 | [MSrepl_errors (Transact-SQL)](http://msdn.microsoft.com/library/c6e023c1-2c32-4269-8d76-e442ea309e4b) システムテーブル内のエラーIDです。 EnumErrorRecords(Int32)メソッドを使ってエラーの詳細情報を返してください。 |
注釈
このメソッドを呼び出す前に、プロパティの変更を PublisherMonitor オブジェクトにコミットすべきです。なぜなら、このオブジェクトのプロパティがまだ読み込まれていない場合は読み込む必要があるからです。
EnumDistributionAgentSessionsメソッドは、db_ownerのメンバーのみ、または配布データベース上の固定されたデータベースロールreplmonitor呼び出すことができます。