PublisherMonitor.EnumSnapshotAgentSessions(String, Int32, Boolean) 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 des informations sur les sessions de l'Agent d'instantané.
public:
System::Data::DataSet ^ EnumSnapshotAgentSessions(System::String ^ agentName, int sessionDuration, bool returnOnlyErrorSessions);public System.Data.DataSet EnumSnapshotAgentSessions (string agentName, int sessionDuration, bool returnOnlyErrorSessions);member this.EnumSnapshotAgentSessions : string * int * bool -> System.Data.DataSetPublic Function EnumSnapshotAgentSessions (agentName As String, sessionDuration As Integer, returnOnlyErrorSessions As Boolean) As DataSetParamètres
- agentName
- String
Valeur String qui spécifie le nom de l'Agent de lecture du journal. Vous pouvez obtenir cette valeur de la propriété LogReaderAgentName de la base de données publiée.
- 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. |
| delivered_commands | Int32 | Nombre total de commandes 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 EnumSnapshotAgentSessions 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.