PublisherMonitor.EnumDistributionAgentSessions(String, Int32, Boolean) Méthode

Définition

Espace de noms:

Microsoft.SqlServer.Replication

Assembly:

Microsoft.SqlServer.Rmo.dll

Retourne des informations sur les sessions de l'Agent de distribution.

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.DataSet

Public Function EnumDistributionAgentSessions (agentName As String, sessionDuration As Integer, returnOnlyErrorSessions As Boolean) As DataSet

Paramètres

agentName

String

Valeur String qui spécifie le nom du travail de l'Agent de distribution. Vous pouvez utiliser la propriété SynchronizationAgentName de l'objet TransSubscription pour obtenir cette valeur.

sessionDuration

Int32

Valeur Int32 qui spécifie le nombre d'heures avant l'heure réelle à laquelle les résultats doivent être limités. Par exemple, la valeur 24 retournera les informations sur les sessions d'Agent de distribution qui ont eu lieu au cours des dernières 24 heures. La valeur -1 retourne les informations sur les 100 dernières sessions, et la valeur 0 retourne les informations sur toutes les sessions.

returnOnlyErrorSessions

Boolean

Valeur Boolean qui spécifie si les informations doivent être retournées uniquement sur les sessions qui ont généré une erreur ou sur toutes les sessions. Si la valeur est true, seules les sessions d'erreur sont retournées. Si la valeur est false, toutes les sessions sont retournées.

Retours

DataSet

Objet DataSet qui contient les colonnes suivantes.

Colonne	Type de données	Description
runstatus	Int32	État d'exécution : 1 = Démarrage 2 = Succès 3 = En cours 4 = Inactif 5 = Nouvelle tentative 6 = Échec
start_time	String	Date et heure de la dernière exécution de l’agent.
time	String	Date et heure de connexion à la session.
comments	String	Texte du message enregistré par l'agent.
duration	Int32	Temps écoulé de la session, en secondes.
delivery_rate	Single	Nombre moyen de commandes transmises par seconde.
delivery_latency	Int32	Temps de latence, en millisecondes, entre l'entrée de la transaction dans la base de données de distribution et son application à l'abonné.
(Aucun nom de colonne)	Non applicable	À usage interne uniquement
delivered_transactions	Int32	Nombre total de transactions transmises dans la session.
delivered_commands	Int32	Nombre total de commandes transmises dans la session.
average_commands	Int32	Nombre moyen de commandes par transaction transmises dans la session.
action_count	Int32	Nombre de messages du journal de l'agent enregistré dans la session.
error_id	Int32	ID de l’erreur dans la table système [MSrepl_errors (Transact-SQL)](http://msdn.microsoft.com/library/c6e023c1-2c32-4269-8d76-e442ea309e4b) . Utilisez la méthode EnumErrorRecords(Int32) pour retourner les informations détaillées sur une erreur.

Remarques

Vous devez valider les modifications de propriété apportées à l’objet PublisherMonitor avant d’appeler cette méthode, car les propriétés de cet objet doivent peut-être être chargées si elles n’ont pas déjà été chargées.

La EnumDistributionAgentSessions méthode ne peut être appelée que par les db_owner membres des rôles de base de données fixes ou replmonitor sur la base de données de distribution.

Voir aussi

• Procédure : analyser la réplication par programmation (programmation RMO)