Agent de lecture du journal des réplications

Syntaxe

logread [-?] 
-Publisher server_name[\instance_name] 
-PublisherDB publisher_database 
[-Continuous]
[-DefinitionFile def_path_and_file_name]
[-Distributor server_name[\instance_name]]
[-DistributorLogin distributor_login]
[-DistributorPassword distributor_password]
[-DistributorSecurityMode [0|1]]
[-EncryptionLevel [0|1|2]]
[-HistoryVerboseLevel [0|1|2]]
[-KeepAliveMessageInterval keep_alive_message_interval_seconds]
[-LoginTimeOut login_time_out_seconds]
[-LogScanThreshold scan_threshold]
[-MaxCmdsInTran number_of_commands]
[-MessageInterval message_interval]
[-Output output_path_and_file_name]
[-OutputVerboseLevel [0|1|2|3|4]]
[-PacketSize packet_size]
[-PollingInterval polling_interval]
[-ProfileName profile_name] 
[-PublisherFailoverPartner server_name[\instance_name] ]
[-PublisherSecurityMode [0|1]]
[-PublisherLogin publisher_login]
[-PublisherPassword publisher_password] 
[-QueryTimeOut query_time_out_seconds]
[-ReadBatchSize number_of_transactions] 
[-ReadBatchThreshold read_batch_threshold]
[-RecoverFromDataErrors]

Arguments

• -?
  Affiche les informations d'utilisation.

• -Publisherserver_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.

• -PublisherDBpublisher_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.

• -DefinitionFiledef_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.

• -Distributorserver_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.

• -DistributorLogindistributor_login
  Nom de connexion du serveur de distribution.

• -DistributorPassworddistributor_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), tandis que 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é.

  Pour plus d'informations, consultez Vue d'ensemble de la sécurité (réplication).

• -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 de l'historique sur les performances en sélectionnant 1.

  Valeur HistoryVerboseLevel	Description
  0
  1	Valeur 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, à moins qu'il ne s'agisse 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.

• -KeepAliveMessageIntervalkeep_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.

• -LoginTimeOutlogin_time_out_seconds
  Nombre de secondes avant l'expiration de la connexion. La valeur par défaut est 15 secondes.

• -LogScanThresholdscan_threshold
  À usage interne uniquement.

• -MaxCmdsInTrannumber_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 conflits 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.

  Notes

  Ce paramètre est ignoré pour les publications non-SQL Server. Pour plus d'informations, consultez la section « Configuration du travail du jeu de transactions » dans Réglage des performances pour les serveurs de publication Oracle.

• -MessageIntervalmessage_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 laquelle l'agent doit attendre avant d'envoyer un autre message indiquant l'inexistence de transactions. 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 60 secondes.

• -Outputoutput_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 (valeur 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.

• -PacketSizepacket_size
  Taille du paquet en octets. La valeur par défaut est 4 096 octets.

• -PollingIntervalpolling_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.

• -ProfileNameprofile_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.

• -PublisherFailoverPartnerserver_name[**\**instance_name]
  Spécifie l'instance du serveur 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 Réplication et mise en miroir des bases de données.

• -PublisherSecurityMode [ 0| 1]
  Spécifie le mode de sécurité du serveur de publication. La valeur 0 indique le mode d'authentification SQL Server (par défaut), tandis que la valeur 1 indique le mode d'authentification Windows.

• -PublisherLoginpublisher_login
  Nom de connexion du serveur de publication.

• -PublisherPasswordpublisher_password
  Mot de passe du serveur de publication.

• -QueryTimeOutquery_time_out_seconds
  Nombre de secondes avant l'expiration de la requête. La valeur par défaut est 1 800 secondes.

• -ReadBatchSizenumber_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.

• -ReadBatchThresholdnumber_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

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.

Voir aussi

Concepts