ReplicationMonitor.EnumQueueReaderAgentSessions 方法

定义

命名空间:

Microsoft.SqlServer.Replication

程序集:

Microsoft.SqlServer.Rmo.dll

返回有关队列读取器代理会话的信息（包括状态和统计信息）的列表。

public:
 System::Data::DataSet ^ EnumQueueReaderAgentSessions(System::String ^ distributionDatabase, int publicationId, int sessionDuration, bool returnOnlyErrorSessions);

public System.Data.DataSet EnumQueueReaderAgentSessions (string distributionDatabase, int publicationId, int sessionDuration, bool returnOnlyErrorSessions);

member this.EnumQueueReaderAgentSessions : string * int * int * bool -> System.Data.DataSet

Public Function EnumQueueReaderAgentSessions (distributionDatabase As String, publicationId As Integer, sessionDuration As Integer, returnOnlyErrorSessions As Boolean) As DataSet

参数

distributionDatabase

String

一个指定分发数据库的 String 值。

publicationId

Int32

一个 Int32 值，该值指定唯一标识发布的 ID 值。

sessionDuration

Int32

一个 Int32 值，该值指定当前时间之前的小时数，以便将结果限制在这个时间范围之内。 例如，如果值为 24，则将返回有关最近 24 小时之内的代理会话的信息。 如果值为 -1，则返回有关最近 100 个会话的信息；如果值为 0，则返回有关所有会话的信息。

returnOnlyErrorSessions

Boolean

一个 Boolean 值，该值指定是仅返回有关导致错误的会话的信息，还是返回有关所有会话的信息。 如果为 true，则仅返回错误会话。 如果为 false，则返回所有会话。

返回

DataSet

一个包含以下列的 DataSet 对象。

列	数据类型	说明
runstatus	Int32	运行状态： 1 = 开始 2 = 成功 3 = 正在进行 4 = 空闲 5 = 重试 6 = 失败
start_time	String	上一次执行代理的日期和时间。
time	String	记录会话的日期和时间。
comments	String	代理记录的消息文本。
duration	Int32	会话的持续时间，以秒为单位。
delivery_rate	Single	每秒传递的平均命令数。
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) ] (http://msdn.microsoft.com/library/c6e023c1-2c32-4269-8d76-e442ea309e4b) 系统表中错误的 ID。 使用 EnumErrorRecords(Int32) 方法可以返回有关错误的详细信息。

注解

应在调用此方法之前将 ReplicationMonitor 任何属性更改提交到对象，因为如果尚未加载此对象的属性，则可能需要加载这些属性。

方法EnumQueueReaderAgentSessions只能由分发数据库上的 或 replmonitor 固定数据库角色的成员db_owner调用。

另请参阅

• 如何以编程方式监视复制（RMO 编程）