Agent de lecture de la file d’attente de réplication
L’Agent de lecture de la file d’attente de réplication est un fichier exécutable qui lit les messages stockés dans une file d’attente Microsoft SQL Server ou une file d’attente de messages Microsoft, puis qui applique ces messages au serveur de publication. L'Agent de lecture de la file d'attente est utilisé avec les publications transactionnelles et les publications d'instantané qui autorisent la mise à jour en attente.
Remarque
Les paramètres peuvent être spécifiés dans n'importe quel ordre. Lorsque les paramètres optionnels ne sont pas spécifiés, les valeurs prédéfinies basées sur le profil d'agent par défaut sont utilisées.
Syntaxe
qrdrsvc [-?]
[-Continuous]
[-DefinitionFiledefinition_file]
[-Distributorserver_name[\instance_name]]
[-DistributionDBdistribution_database]
[-DistributorLogindistributor_login]
[-DistributorPassworddistributor_password]
[-DistributorSecurityMode [0|1]]
[-EncryptionLevel [0|1|2]]
[-HistoryVerboseLevel [0|1|2|3]]
[-LoginTimeOutlogin_time_out_seconds]
[-Outputoutput_path_and_file_name]
[-OutputVerboseLevel [0|1|2]]
[-PollingIntervalpolling_interval]
[-PublisherFailoverPartnerserver_name[\instance_name] ]
[-ProfileNameagent_profile_name]
[-QueryTimeOutquery_time_out_seconds]
[-ResolverState [1|2|3]]
Arguments
-?
Affiche des informations sur l’utilisation.
-Continuous
Spécifie si l'agent tente de traiter les transactions en attente de manière continue. S'il est spécifié, l'agent poursuit l'exécution même si aucune transaction n'est en attente au niveau des Abonnés.
-DefinitionFile def_path_and_file_name
Chemin d'accès du fichier de définition d'agent. Un fichier de définition d'agent contient des arguments de ligne de commande pour l'agent. Le contenu du fichier est analysé en tant que fichier exécutable. Utilisez des guillemets doubles (") pour spécifier des valeurs d'argument qui contiennent des caractères arbitraires.
-Distributor server_name[\instance_name]
Nom du serveur de distribution. Spécifiez server_name pour l’instance par défaut de SQL Server sur ce serveur. Spécifiez server_name instance_name\ pour une instance nommée de SQL Server sur ce serveur. S’il n’est pas spécifié, le nom correspond par défaut au nom de l’instance par défaut de SQL Server sur l’ordinateur local.
-DistributionDB distribution_database
Nom de la base de données de distribution.
-DistributorLogin distributor_login
Nom de connexion du serveur de distribution.
-DistributorPassword distributor_password
Mot de passe du serveur de distribution.
-DistributorSecurityMode [ 0| 1]
Spécifie le mode de sécurité du serveur de distribution. La valeur 0 indique le mode d’authentification SQL Server (par défaut) et la valeur 1 indique le mode d’authentification Windows.
-EncryptionLevel [ 0 | 1 | 2 ]
Niveau du chiffrement SSL (Secure Sockets Layer) utilisé par l'Agent de lecture de la file d'attente lors de l'établissement de connexions.
| Valeur EncryptionLevel | Description |
|---|---|
| 0 | Spécifie que le chiffrement SSL n'est pas utilisé. |
| 1 | Spécifie que le chiffrement SSL est utilisé, mais que l'agent ne vérifie pas si le certificat de serveur SSL est signé par un émetteur de confiance. |
| 2 | Spécifie que le chiffrement SSL est utilisé et que le certificat est vérifié. |
Remarque
Un certificat SSL valide est défini avec le nom de domaine complet de l’instance SQL Server. Pour que l’agent puisse se connecter lorsque vous définissez EncryptionLevel sur 2, créez un alias sur l’instance locale de SQL Server. Le paramètre « Nom de l’alias » doit correspondre au nom du serveur, et le paramètre « Serveur » doit être défini sur le nom complet de l’instance SQL Server.
Pour plus d’informations, consultez Réplication SQL Server Sécurité.
-HistoryVerboseLevel [ 0| 1| 2| 3]
Spécifie la quantité d'informations d'historique journalisées pendant une opération de lecture de la file d'attente. Vous pouvez réduire l'effet de la journalisation d'historique sur les performances en sélectionnant 1.
| Valeur HistoryVerboseLevel | Description |
|---|---|
| 0 | Aucune journalisation d'historique (non recommandé). |
| 1 | Par défaut. Met toujours à jour un message d'historique précédent du même état (démarrage, progression, succès, et ainsi de suite). Si aucun enregistrement précédent du même état n'existe, insère un nouvel enregistrement. |
| 2 | Insère de nouveaux enregistrements d'historique, y compris des messages inactifs ou des messages de travail de longue durée. |
| 3 | Insère de nouveaux enregistrements d'historique incluant des détails supplémentaires qui peuvent s'avérer utiles pour le dépannage. |
-LoginTimeOut login_time_out_seconds
Nombre de secondes avant l’expiration de la connexion. La valeur par défaut est de 15 secondes.
-Output output_path_and_file_name
Chemin d'accès du fichier de sortie de l'agent. Si le nom du fichier n'est pas spécifié, la sortie est envoyée à la console. Si le nom de fichier spécifié existe, la sortie est ajoutée au fichier.
-OutputVerboseLevel [ 0| 1| 2]
Spécifie si la sortie doit être en clair. Si le niveau de détail est 0, seuls les messages d'erreur sont imprimés. Si le niveau de détail est 1, tous les messages du rapport de progression sont imprimés. Si le niveau de détail est 2 (valeur par défaut), tous les messages d'erreur et tous les messages du rapport de progression sont imprimés, ce qui peut s'avérer utile lors du débogage.
-PollingInterval polling_interval
N’est pertinent que pour la mise à jour des abonnements qui utilisent des files d’attente basées sur SQL Server. Spécifie la fréquence à laquelle, en secondes, la file d’attente SQL Server est interrogée pour les transactions en file d’attente en attente. La valeur peut être comprise entre 0 et 240 secondes. La valeur par défaut est 5 secondes.
-PublisherFailoverPartner server_name[\instance_name]
Spécifie l’instance de partenaire de basculement de SQL Server participant à une session de mise en miroir de bases de données avec la base de données de publication. Pour plus d’informations, consultez Mise en miroir de bases de données et réplication (SQL Server).
-ProfileName agent_profile_name
Nom d'un profil d'agent utilisé pour fournir un jeu de valeurs par défaut à l'agent. Pour plus d’informations, consultez Profils de l’Agent de réplication.
-QueryTimeOut query_time_out_seconds
Nombre de secondes avant l’expiration de la requête. La valeur par défaut est 1800 secondes.
-ResolverState [ 1| 2| 3]
Spécifie comment les conflits de mise à jour en attente sont résolus. La valeur 1 indique que le serveur de publication remporte le conflit. Dans ce cas, la transaction en file d'attente actuellement en conflit est restaurée sur le serveur de publication et sur l'Abonné de mise à jour d'origine ; le traitement des transactions en file d'attente suivantes continue. La valeur 2 indique que l'Abonné remporte le conflit, et la transaction en file d'attente remplace les valeurs sur le serveur de publication. La valeur 3 indique que tout conflit provoquera la réinitialisation de l'Abonné ; le serveur de publication remporte le conflit, le traitement des transactions en file d'attente suivantes est terminé, et l'abonnement est réinitialisé. Le paramètre par défaut est 1 pour les publications transactionnelles et 3 pour les publications d'instantané.
Notes
Pour démarrer l'Agent de lecture de la file d'attente, exécutez qrdrsvc.exe à l'invite de commandes. Pour plus d'informations, consultez Concepts des exécutables de l'agent de réplication.