Agent de lecture du journal des réplications
L’Agent de lecture du journal des réplications est un fichier exécutable qui analyse le journal des transactions de chaque base de données configurée pour la réplication transactionnelle, et qui copie les transactions devant être répliquées à partir du journal des transactions dans la base de données de distribution.
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
logread [-?]
-Publisherserver_name[\instance_name]
-PublisherDBpublisher_database
[-Continuous]
[-DefinitionFiledef_path_and_file_name]
[-Distributorserver_name[\instance_name]]
[-DistributorLogindistributor_login]
[-DistributorPassworddistributor_password]
[-DistributorSecurityMode [0|1]]
[-EncryptionLevel [0|1|2]]
[-ExtendedEventConfigFileconfiguration_path_and_file_name]
[-HistoryVerboseLevel [0|1|2]]
[-KeepAliveMessageIntervalkeep_alive_message_interval_seconds]
[-LoginTimeOutlogin_time_out_seconds]
[-LogScanThresholdscan_threshold]
[-MaxCmdsInTrannumber_of_commands]
[-MessageIntervalmessage_interval]
[-Outputoutput_path_and_file_name]
[-OutputVerboseLevel [0|1|2|3|4]]
[-PacketSizepacket_size]
[-PollingIntervalpolling_interval]
[-ProfileNameprofile_name]
[-PublisherFailoverPartnerserver_name[\instance_name] ]
[-PublisherSecurityMode [0|1]]
[-PublisherLoginpublisher_login]
[-PublisherPasswordpublisher_password]
[-QueryTimeOutquery_time_out_seconds]
[-ReadBatchSizenumber_of_transactions]
[-ReadBatchThresholdread_batch_threshold]
[-RecoverFromDataErrors]
Arguments
-?
Affiche des informations sur l’utilisation.
-Publisher server_name[\instance_name]
Nom du serveur de publication. Spécifiez server_name pour l’instance par défaut de Microsoft SQL Server sur ce serveur. Spécifiez server_name instance_name\ pour une instance nommée de SQL Server sur ce serveur.
-PublisherDB publisher_database
Nom de la base de données du serveur de publication.
-Continuous
Spécifie si l'Agent tente d'interroger les transactions répliquées de manière continue. S'il est spécifié, l'Agent interroge les transactions répliquées à partir de la source à des fréquences d'interrogation définies, même s'il n'y a pas de transactions en attente.
-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.
-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 (valeur par défaut) et la valeur 1 indique le mode d’authentification Microsoft Windows.
-EncryptionLevel [ 0 | 1 | 2 ]
Niveau du chiffrement SSL (Secure Sockets Layer) utilisé par l'Agent de lecture du journal 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é.
-ExtendedEventConfigFile configuration_path_and_file_name
Spécifie le chemin d'accès et le nom du fichier de configuration XML d'événements étendus. Le fichier de configuration d'événements étendu vous permet de configurer des sessions et d'activer des événements pour le suivi.
-HistoryVerboseLevel [ 0| 1| 2]
Spécifie la quantité d'informations d'historique journalisées pendant une opération du lecteur du journal. Vous pouvez réduire l'effet de la journalisation d'historique sur les performances en sélectionnant 1.
| Valeur HistoryVerboseLevel | Description |
|---|---|
| 0 | |
| 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, sauf s'il s'agit d'un enregistrement concernant notamment un message inactif ou un message de travail de longue durée, auquel cas les enregistrements précédents sont mis à jour. |
-KeepAliveMessageInterval keep_alive_message_interval_seconds
Durée en secondes au terme de laquelle le thread d'historique doit vérifier si l'une des connexions existantes attend une réponse du serveur. Vous pouvez réduire cette valeur pour éviter que l'agent de vérification ne marque l'Agent de lecture du journal comme suspect lors de l'exécution d'un lot de longue durée. La valeur par défaut est 300 secondes.
-LoginTimeOut login_time_out_seconds
Nombre de secondes avant l’expiration de la connexion. La valeur par défaut est de 15 secondes.
-LogScanThreshold scan_threshold
Utilisation interne uniquement.
-MaxCmdsInTran number_of_commands
Indique le nombre maximal d'instructions groupées dans une transaction lorsque le Lecteur du journal enregistre des commandes sur la base de données de distribution. L'utilisation de ce paramètre permet à l'Agent de lecture du journal et à l'Agent de distribution de scinder les transactions importantes (constituées de plusieurs commandes) sur le serveur de publication en plusieurs transactions plus petites lors de leur application sur l'Abonné. La spécification de ce paramètre permet de réduire les contentions sur le serveur de distribution et de réduire la latence entre le serveur de publication et l'Abonné. Du fait que la transaction d'origine est appliquée en plusieurs morceaux, l'Abonné peut accéder aux lignes d'une importante transaction logique du serveur de publication avant la fin de la transaction d'origine, ce qui rompt la stricte atomicité transactionnelle. La valeur par défaut est 0, ce qui permet de conserver les limites de la transaction du serveur de publication.
Remarque
Ce paramètre est ignoré pour les publications autres que SQL Server. Pour plus d'informations, consultez la section « Configuration du travail du jeu de transactions » dans Performance Tuning for Oracle Publishers.
-MessageInterval message_interval
Intervalle de temps utilisé pour la journalisation d'historique. Un événement d'historique est journalisé lorsque la valeur MessageInterval est atteinte une fois le dernier événement d'historique journalisé.
Si aucune transaction répliquée n'est disponible à la source, l'agent signale un message de non-transaction au serveur de distribution. Cette option spécifie combien de temps l'agent doit attendre avant de signaler un autre message de non-transaction. Les agents signalent toujours un message de non-transaction lorsqu'ils détectent qu'aucune transaction n'est disponible à la source après avoir précédemment traité des transactions répliquées. La valeur par défaut est de 60 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 | 3 | 4 ]
Spécifie si la sortie doit être en clair.
| Valeur | Description |
|---|---|
| 0 | Seuls les messages d'erreur sont imprimés. |
| 1 | Tous les messages du rapport de progression de l'agent sont imprimés. |
| 2 (par défaut) | Tous les messages d'erreur et tous les messages du rapport de progression sont imprimés. |
| 3 | Les 100 premiers octets de chaque commande répliquée sont imprimés. |
| 4 | Toutes les commandes répliquées sont imprimées. |
Les valeurs 2-4 sont utiles lors du débogage.
-PacketSize packet_size
Taille du paquet en octets. La valeur par défaut est 4 096 octets.
-PollingInterval polling_interval
Fréquence, en secondes, d'interrogation du journal pour l'obtention de transactions répliquées. La valeur par défaut est 5 secondes.
-ProfileName profile_name
Spécifie un profil d'agent à utiliser pour les paramètres d'agent. Si ProfileName a la valeur NULL, le profil d'agent est désactivé. Si ProfileName n'est pas spécifié, le profil par défaut du type d'agent est utilisé. Pour plus d’informations, consultez Profils de l’Agent de réplication.
-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).
-PublisherSecurityMode [ 0| 1]
Spécifie le mode de sécurité du serveur de publication. La valeur 0 indique l’authentification SQL Server (valeur par défaut) et la valeur 1 indique le mode d’authentification Windows.
-PublisherLogin publisher_login
Nom de connexion du serveur de publication.
-PublisherPassword publisher_password
Mot de passe du serveur de publication.
-QueryTimeOut query_time_out_seconds
Nombre de secondes avant l’expiration de la requête. La valeur par défaut est 1800 secondes.
-ReadBatchSize number_of_transactions
Nombre maximal de transactions lues dans le journal des transactions de la base de données de publication par cycle de traitement, avec 500 comme valeur par défaut. L'agent continue à lire les transactions par lots jusqu'à ce que toutes les transactions aient été lues dans le journal. Ce paramètre n'est pas pris en charge pour les serveurs de publication Oracle.
-ReadBatchThreshold number_of_commands
Nombre de commandes de réplication à lire dans le journal des transactions avant que l'Agent de distribution ne les envoie à l'Abonné. La valeur par défaut est 0. Si ce paramètre n'est pas spécifié, l'Agent de lecture du journal lit la totalité du journal ou jusqu'au nombre spécifié - ReadBatchSize (nombre de transactions).
-RecoverFromDataErrors
Spécifie que l'Agent de lecture du journal poursuit son exécution lorsqu'il rencontre des erreurs dans les données de colonne publiées à partir d'un serveur de publication non-SQL Server. Par défaut, de telles erreurs provoquent l'échec de l'Agent de lecture du journal. Lorsque vous utilisez -RecoverFromDataErrors, les données de colonne erronées sont répliquées soit en tant que valeur NULL, soit en tant que valeur non nulle appropriée, et des messages d'avertissement sont journalisés dans la table MSlogreader_history . Ce paramètre est uniquement pris en charge pour les serveurs de publication Oracle.
Notes
Important
Si vous avez installé SQL Server Agent pour s’exécuter sous un compte système local au lieu d’un compte d’utilisateur de domaine (la valeur par défaut), le service peut accéder uniquement à l’ordinateur local. Si l’Agent de lecture du journal qui s’exécute sous SQL Server Agent est configuré pour utiliser le mode d’authentification Windows lorsqu’il se connecte à SQL Server, l’Agent de lecture du journal échoue. Le paramètre par défaut est l’authentification SQL Server. Pour plus d'informations sur la modification des comptes de sécurité, consultez View and Modify Replication Security Settings.
Pour démarrer l'Agent de lecture du journal, exécutez logread.exe à l'invite de commandes. Pour plus d’informations, consultez Concepts des exécutables de l’agent de réplication.
Historique des modifications
| Mise à jour du contenu |
|---|
| Ajout du paramètre ExtendedEventConfigFile . |