ReplicationMonitor.EnumQueueReaderAgentSessions Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne une liste d'informations sur les sessions de l'Agent de lecture de la file d'attente, notamment des informations statistiques et d'état.
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
Paramètres
- publicationId
- Int32
Valeur Int32 qui spécifie la valeur d’ID qui identifie de manière unique la publication.
- 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 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
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 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 écoulé, en millisecondes, entre la validation d'une commande dans la base de données publiée et sa validation dans la base de données de distribution. |
publication_id | Int32 | ID de la publication. |
transactions_processed | Int32 | Nombre total de transactions transmises dans la session. |
commands_processed | 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 toutes les modifications apportées à la propriété de l’objet ReplicationMonitor avant d’appeler cette méthode, car les propriétés de cet objet peuvent avoir besoin d’être chargées si elles n’ont pas déjà été chargées.
La EnumQueueReaderAgentSessions 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.