Agent de fusion de réplicationReplication Merge Agent

L'Agent de fusion de réplication est un fichier exécutable d'utilitaire qui applique l'instantané initial contenu dans les tables de base de données aux Abonnés.The Replication Merge Agent is a utility executable that applies the initial snapshot held in the database tables to the Subscribers. Il fusionne également les modifications de données incrémentielles ayant eu lieu sur le serveur de publication après la création de l'instantané initial, puis harmonise les conflits soit en fonction des règles que vous configurez, soit à l'aide d'un programme de résolution personnalisé que vous créez.It also merges incremental data changes that occurred at the Publisher after the initial snapshot was created, and reconciles conflicts either according to the rules you configure or using a custom resolver you create.

Note

Les paramètres peuvent être spécifiés dans n'importe quel ordre.Parameters can be specified in any order. Lorsque les paramètres optionnels ne sont pas spécifiés, les valeurs des paramètres du Registre prédéfinis sur l'ordinateur local sont utilisées.When optional parameters are not specified, values from predefined registry settings on the local computer are used.

SyntaxeSyntax


replmerg [-?]   
-Publisher server_name[\instance_name]  
-PublisherDB publisher_database  
-Publication publication  
-Subscriber server_name[\instance_name]  
-SubscriberDB subscriber_database  
[-AltSnapshotFolder alt_snapshot_folder_path]  
[-Continuous]  
[-DefinitionFile def_path_and_file_name]  
[-DestThreads number_of_destination_threads]  
[-Distributor server_name[\instance_name]]  
[-DistributorLogin distributor_login]  
[-DistributorPassword distributor_password]  
[-DistributorSecurityMode [0|1]]  
[-DownloadGenerationsPerBatch download_generations_per_batch]  
[-DownloadReadChangesPerBatch download_read_changes_per_batch]  
[-DownloadWriteChangesPerBatch download_write_changes_per_batch]  
[-DynamicSnapshotLocation dynamic_snapshot_location]  
[-EncryptionLevel [0|1|2]]  
[-ExchangeType [1|2|3]]  
[-FastRowCount [0|1]]  
[-FileTransferType [0|1]]  
[-ForceConvergenceLevel [0|1|2 (Publisher|Subscriber|Both)]]  
[-FtpAddress ftp_address]  
[-FtpPassword ftp_password]  
[-FtpPort ftp_port]  
[-FtpUserNameftp_user_name]  
[-HistoryVerboseLevel [0|1|2|3]]  
[-Hostname host_name]  
[-InteractiveResolution [0|1]]  
[-InternetLogin internet_login]  
[-InternetPassword internet_password]  
[-InternetProxyLogin internet_proxy_login]  
[–InternetProxyPassword internet_proxy_password]  
[-InternetProxyServer internet_proxy_server]  
[-InternetSecurityMode [0|1]]  
[-InternetTimeout internet_timeout]  
[-InternetURL internet_url]  
[-KeepAliveMessageInterval keep_alive_message_interval_seconds]  
[-LoginTimeOut login_time_out_seconds]  
[-MakeGenerationInterval make_generation_interval_seconds]  
[-MaxBcpThreads number_of_threads]  
[-MaxDownloadChanges number_of_download_changes]  
[-MaxUploadChanges number_of_upload_changes]  
[-MetadataRetentionCleanup [0|1]]  
[-Output]  
[-OutputVerboseLevel [0|1|2]]  
[-ParallelUploadDownload [0|1]]  
[-PacketSize packet_size]   
[-PollingInterval polling_interval]  
[-ProfileName profile_name]  
[-PublisherFailoverPartner server_name[\instance_name] ]  
[-PublisherLogin publisher_login]  
[-PublisherPassword publisher_password]  
[-PublisherSecurityMode [0|1]]  
[-QueryTimeOut query_time_out_seconds]  
[-SrcThreads number_of_source_threads]  
[-StartQueueTimeout start_queue_timeout_seconds]  
[-SubscriberConflictClean [0|1]]  
[-SubscriberDatabasePath subscriber_path]  
[-SubscriberDBAddOption [0|1|2|3]]  
[-SubscriberLogin subscriber_login]  
[-SubscriberPassword subscriber_password   
[-SubscriberSecurityMode [0|1]]  
[-SubscriberType [0|1|2|3|4|5|6|7|8|9]]  
[-SubscriptionType [0|1|2]]  
[-SyncToAlternate [0|1]  
[-UploadGenerationsPerBatch upload_generations_per_batch]  
[-UploadReadChangesPerBatch upload_read_changes_per_batch]  
[-UploadWriteChangesPerBatch upload_write_changes_per_batch]  
[-UseInprocLoader]  
[-Validate [0|1|2|3]]  
[-ValidateInterval validate_interval]  

ArgumentsArguments

-?-?
Imprime tous les paramètres disponibles.Prints all available parameters.

-Publisher server_name[\instance_name]-Publisher server_name[\instance_name]
Nom du serveur de publication.Is the name of the Publisher. Spécifiez server_name pour l'instance par défaut de MicrosoftMicrosoft SQL ServerSQL Server sur ce serveur.Specify server_name for the default instance of MicrosoftMicrosoft SQL ServerSQL Server on that server. Spécifiez server_name\instance_name pour une instance nommée de SQL ServerSQL Server sur ce serveur.Specify server_name\instance_name for a named instance of SQL ServerSQL Server on that server.

-PublisherDB publisher_database-PublisherDB publisher_database
Nom de la base de données du serveur de publication.Is the name of the Publisher database.

-Publication publication-Publication publication
Nom de la publication.Is the name of the publication. Ce paramètre est uniquement valide si la publication est configurée de telle sorte qu'un instantané soit toujours disponible pour les nouveaux abonnements ou les abonnements réinitialisés.This parameter is only valid if the publication is set to always have a snapshot available for new or reinitialized subscriptions.

-Subscriber server_name[\instance_name]-Subscriber server_name[\instance_name]
Nom de l'Abonné.Is the name of the Subscriber. Spécifiez server_name pour l'instance par défaut de SQL ServerSQL Server sur ce serveur.Specify server_name for the default instance of SQL ServerSQL Server on that server. Spécifiez server_name\instance_name pour une instance nommée de SQL ServerSQL Server sur ce serveur.Specify server_name\instance_name for a named instance of SQL ServerSQL Server on that server.

-SubscriberDB subscriber_database-SubscriberDB subscriber_database
Nom de la base de données de l'Abonné.Is the name of the Subscriber database.

-AltSnapshotFolder alt_snapshot_folder_path-AltSnapshotFolder alt_snapshot_folder_path
Chemin d'accès au dossier contenant l'instantané initial pour un abonnement.Is the path to the folder that contains the initial snapshot for a subscription.

-Continuous-Continuous
Spécifie si l'agent tente d'interroger les transactions répliquées de manière continue.Specifies whether the agent attempts to poll replicated transactions continually. S'il est spécifié, l'Agent interroge les transactions répliquées de la source à des fréquences d'interrogation définies, même s'il n'y a pas de transactions en attente.If specified, the agent polls replicated transactions from the source at polling intervals, even if there are no transactions pending.

-DestThreads number_of_destination_threads-DestThreads number_of_destination_threads
Spécifie le nombre de threads de destination utilisés par l'Agent de fusion pour appliquer les modifications à la destination.Specifies the number of destination threads that the Merge Agent uses to apply changes at the destination. La destination est le serveur de publication au cours du téléchargement ascendant et l'Abonné au cours du téléchargement descendant.The destination is the Publisher during upload and the Subscriber during download. La valeur par défaut est 4.The default is 4.

-DefinitionFile def_path_and_file_name-DefinitionFile def_path_and_file_name
Chemin d'accès du fichier de définition d'agent.Is the path of the agent definition file. Un fichier de définition d'agent contient des arguments d'invite de commandes pour l'agent.An agent definition file contains command prompt arguments for the agent. Le contenu du fichier est analysé en tant que fichier exécutable.The content of the file is parsed as an executable file. Utilisez des guillemets doubles (") pour spécifier des valeurs d'argument qui contiennent des caractères arbitraires.Use double quotation marks (") to specify argument values containing arbitrary characters.

-Distributor server_name[\instance_name]-Distributor server_name[\instance_name]
Nom du serveur de distribution.Is the Distributor name. Spécifiez server_name pour l'instance par défaut de SQL ServerSQL Server sur ce serveur.Specify server_name for the default instance of SQL ServerSQL Server on that server. Spécifiez server_name\instance_name pour une instance nommée de SQL ServerSQL Server sur ce serveur.Specify server_name\instance_name for a named instance of SQL ServerSQL Server on that server. Pour la distribution du serveur de distribution (transmission de type push), le nom a comme valeur par défaut l'instance par défaut de SQL ServerSQL Server sur l'ordinateur local.For Distributor (push) distribution, the name defaults to the name of the default instance of SQL ServerSQL Server on the local computer.

-DistributorLogin distributor_login-DistributorLogin distributor_login
Nom de connexion du serveur de distribution.Is the Distributor login name.

-DistributorPassword distributor_password-DistributorPassword distributor_password
Mot de passe du serveur de distribution.Is the Distributor password.

-DistributorSecurityMode [ 0| 1]-DistributorSecurityMode [ 0| 1]
Spécifie le mode de sécurité du serveur de distribution.Specifies the security mode of the Distributor. La valeur 0 indique le mode d'authentification SQL ServerSQL Server (par défaut), tandis que la valeur 1 indique le mode d'authentification Windows.A value of 0 indicates SQL ServerSQL Server Authentication Mode (default), and a value of 1 indicates Windows Authentication Mode.

-DownloadGenerationsPerBatch download_generations_per_batch-DownloadGenerationsPerBatch download_generations_per_batch
Nombre de générations à traiter dans un lot unique lors du téléchargement des modifications du serveur de publication vers l'Abonné.Is the number of generations to be processed in a single batch while downloading changes from the Publisher to the Subscriber. Une génération est définie comme un groupe logique de modifications par article.A generation is defined as a logical group of changes per article. La valeur par défaut pour un lien de communication fiable est 100.The default for a reliable communication link is 100. La valeur par défaut pour un lien de communication non fiable est 10.The default for an unreliable communication link is 10.

-DownloadReadChangesPerBatch download_read_changes_per_batch-DownloadReadChangesPerBatch download_read_changes_per_batch
Nombre de modifications à lire dans un lot unique lors du téléchargement des modifications du serveur de publication vers l'Abonné.Is the number of changes to be read in a single batch while downloading changes from the Publisher to the Subscriber. La valeur par défaut est 100.The default is 100.

-DownloadWriteChangesPerBatch download_write_changes_per_batch-DownloadWriteChangesPerBatch download_write_changes_per_batch
Nombre de modifications à appliquer dans un lot unique lors du téléchargement des modifications du serveur de publication vers l'Abonné.Is the number of changes to be applied in a single batch while downloading changes from the Publisher to the Subscriber. La valeur par défaut est 100.The default is 100.

-DynamicSnapshotLocation dynamic_snapshot_location-DynamicSnapshotLocation dynamic_snapshot_location
Emplacement des fichiers d'instantanés de données filtrées lorsque la publication utilise des filtres de lignes paramétrables.Is the location of the filtered data snapshot files when the publication uses parameterized row filters.

-EncryptionLevel [ 0 | 1 | 2 ]-EncryptionLevel [ 0 | 1 | 2 ]
Niveau du chiffrement SSL (Secure Sockets Layer) utilisé par l'Agent de fusion lors de l'établissement de connexions.Is the level of Secure Sockets Layer (SSL) encryption used by the Merge Agent when making connections.

Valeur EncryptionLevelEncryptionLevel value DescriptionDescription
00 Spécifie que le chiffrement SSL n'est pas utilisé.Specifies that SSL is not used.
11 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.Specifies that SSL is used, but the agent does not verify that the SSL server certificate is signed by a trusted issuer.
22 Spécifie que le chiffrement SSL est utilisé et que le certificat est vérifié.Specifies that SSL is used, and that the certificate is verified.

Pour plus d’informations, consultez Vue d’ensemble de la sécurité (Réplication).For more information, see Security Overview (Replication).

-ExchangeType [ 1| 2| 3]-ExchangeType [ 1| 2| 3]

Avertissement

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server.This feature will be removed in a future version of Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et modifiez dès que possible les applications qui utilisent actuellement cette fonctionnalité.Do not use this feature in new development work, and modify applications that currently use this feature as soon as possible. Afin de limiter le téléchargement, utilisez @subscriber_upload_options de sp_addmergearticle à la place. To restrict uploading, use the @subscriber_upload_options of sp_addmergearticle instead.

Spécifie le type d'échange de données au cours de la synchronisation parmi les types suivants :Specifies the type of data exchange during synchronization, which can be one of the following:

Valeur ExchangeTypeExchangeType value DescriptionDescription
11 L'agent doit télécharger les modifications de données de l'Abonné vers le serveur de publication.Agent should upload data changes from the Subscriber to the Publisher.
22 L'agent doit télécharger les modifications de données du serveur de publication vers l'Abonné.Agent should download data changes from the Publisher to the Subscriber.
3 (valeur par défaut)3 (default) L'agent doit tout d'abord télécharger les modifications de l'Abonné vers le serveur de publication, puis du serveur de publication vers l'Abonné.Agent should first upload data changes from the Subscriber to the Publisher and then download data changes from the Publisher to the Subscriber. Vous devez utiliser cette option avec la synchronisation Web.You must use this option with Web synchronization.

Les articles en téléchargement uniquement vous permettent de contrôler le comportement de synchronisation d'articles individuels dans une publication, et peuvent aussi accroître les performances.Download-only articles enable you to control the synchronization behavior of individual articles in a publication, and they can provide a performance benefit. Pour plus d’informations, consultez Optimiser les performances de la réplication de fusion avec les articles en téléchargement seul.For more information, see Optimize Merge Replication Performance with Download-Only Articles.

Si vous utilisez ExchangeType pour séparer la phase de téléchargement (upload et download) de la réplication de fusion en sessions distinctes, vous devez exécuter l'agent de fusion avec ExchangeType défini à 1, puis réexécuter l'agent de fusion avec la valeur 2.If using ExchangeType to separate the upload and download phase of merge replication into separate sessions, you must run the merge agent with ExchangeType set to 1 first and then run the merge agent again with the value 2. Si vous n'arrivez pas à exécuter l'agent de fusion avec les deux paramètres, les métadonnées seront supprimées et vous devrez réinitialiser l'abonnement (sans téléchargement).Failure to run the merge agent with both parameters will cause metadata to be deleted and require you to reinitialize the subscription (without upload).

-FastRowCount [0|1]-FastRowCount [0|1]
Spécifie le type de méthode de calcul du nombre de lignes à utiliser pour la validation du nombre de lignes.Specifies what type of rowcount calculation method should be used for rowcount validation. La valeur 1 (valeur par défaut) indique la méthode rapide.A value of 1 (default) indicates the fast method. La valeur 0 indique la méthode complète de calcul du nombre de lignes.A value of 0 indicates the full rowcount method.

-FileTransferType [0|1]-FileTransferType [0|1]
Spécifie le type de transfert de fichier.Specifies the file transfer type. La valeur 0 indique la convention d'affectation des noms (UNC), tandis que la valeur 1 indique le protocole de transfert de fichiers (FTP).A value of 0 indicates UNC (universal naming convention), and a value of 1 indicates FTP (file transfer protocol).

-ForceConvergenceLevel [0|1|2 ( Publisher| Subscriber| Both)]-ForceConvergenceLevel [0|1|2 ( Publisher| Subscriber| Both)]
Spécifie le niveau de convergence que l'Agent de fusion doit utiliser. Il peut prendre l'une des valeurs suivantes :Specifies the level of convergence the Merge Agent should use, and can be one of the following:

Valeur ForceConvergenceLevelForceConvergenceLevel value DescriptionDescription
0 (valeur par défaut)0 (default) Valeur par défaut.Default. Effectue une fusion standard sans convergence supplémentaire.Perform a standard merge without additional convergence.
11 Force la convergence pour toutes les générations.Force convergence for all generations.
22 Force la convergence pour toutes les générations et corrige les lignages endommagés.Force convergence for all generations and correct corrupt lineages. Lorsque vous spécifiez cette valeur, indiquez à quel niveau les lignages doivent être corrigés : le serveur de publication, l'Abonné ou bien les deux.When specifying this value, specify where lineages should be corrected: the Publisher, the Subscriber, or both the Publisher and the Subscriber.

-FtpAddress ftp_address-FtpAddress ftp_address
Adresse réseau du service FTP du serveur de distribution.Is the network address of the FTP service for the Distributor. S'il n'est pas spécifié, Distributor est utilisé.When not specified, Distributor is used.

-FtpPassword ftp_password-FtpPassword ftp_password
Mot de passe de l'utilisateur utilisé pour la connexion au service FTP.Is the user password used to connect to the FTP service.

-FtpPort ftp_port-FtpPort ftp_port
Numéro de port du service FTP du serveur de distribution.Is the port number of the FTP service for the Distributor. S'il n'est pas spécifié, le numéro de port par défaut pour le service FTP (21) est utilisé.When not specified, the default port number for FTP service (21) is used.

-FtpUserName ftp_user_name-FtpUserName ftp_user_name
Nom d'utilisateur utilisé pour la connexion au service FTP.Is the user name used to connect to the FTP service. S'il n'est pas spécifié, anonymous est utilisé.When not specified, anonymous is used.

-HistoryVerboseLevel [1|2|3]-HistoryVerboseLevel [1|2|3]
Spécifie la quantité d'informations d'historique journalisées pendant une opération de fusion.Specifies the amount of history logged during a merge operation. Vous pouvez réduire l'effet de la journalisation d'historique sur les performances en sélectionnant 1.You can minimize the effect of history logging on performance by selecting 1.

Valeur HistoryVerboseLevelHistoryVerboseLevel value DescriptionDescription
00 Journalise le dernier message d'état de l'agent, les derniers détails de session et les erreurs éventuelles.Log the final agent status message, final session details, and any errors.
11 Journalise les détails incrémentiels de session à chaque état de session, y compris le pourcentage accompli, ainsi que le dernier message d'état de l'agent, les derniers détails de session et les erreurs éventuelles.Log incremental session details at each session status, including percent complete, in addition to the final agent status message, final session details, and any errors.
22 Valeur par défaut.Default. Journalise les détails incrémentiels de session à chaque état de session et les détails de session au niveau de l'article, y compris le pourcentage accompli, ainsi que le dernier message d'état de l'agent, les derniers détails de session et les erreurs éventuelles.Log both incremental session details at each session status and article level session details, including percent complete, in addition to the final agent status message, final session details, and any errors. Les messages de l'état de l'agent sont également journalisés.Agent status messages are also logged.
33 Identique à -HistoryVerboseLevel = 2, à la différence qu'un nombre plus important de messages de progression de l'agent sont journalisés.The same as -HistoryVerboseLevel = 2, except that more agent progress messages are logged.

-Hostname host_name-Hostname host_name
Nom de réseau de l'ordinateur local.Is the network name of the local computer. La valeur par défaut est le nom de l'ordinateur local.The default is the local computer name.

-InteractiveResolution [0|1]-InteractiveResolution [0|1]
Spécifie si la résolution de conflit interactive est utilisée lorsqu'un conflit se produit pendant la synchronisation.Specifies whether interactive conflict resolution is used when a conflict occurs during synchronization. La valeur par défaut est 0, indiquant que la résolution de conflit interactive n'est pas utilisée.The default is 0, indicating that interactive conflict resolution is not used.

-InternetLogin internet_login-InternetLogin internet_login
Spécifie le nom de connexion utilisé lors de la connexion à une DLL ISAPI d'écoute de réplication SQL ServerSQL Server qui nécessite une authentification.Specifies the login name used when connecting to a SQL ServerSQL Server replication listener ISAPI DLL that requires authentication.

-InternetPassword internet_password-InternetPassword internet_password
Spécifie le mot de passe utilisé lors de la connexion à une DLL ISAPI d'écoute de réplication SQL ServerSQL Server qui nécessite une authentification.Specifies the password used when connecting to a SQL ServerSQL Server replication listener ISAPI DLL that requires authentication.

-InternetProxyLogin internet_proxy_login-InternetProxyLogin internet_proxy_login
Spécifie le nom de connexion utilisé lors de la connexion à un serveur proxy, défini dans internet_proxy_server, qui nécessite une authentification.Specifies the login name used when connecting to a proxy server, defined in internet_proxy_server, that requires authentication.

–InternetProxyPassword internet_proxy_password–InternetProxyPassword internet_proxy_password
Spécifie le mot de passe utilisé lors de la connexion à un serveur proxy, défini dans internet_proxy_server, qui nécessite une authentification.Specifies the password used when connecting to a proxy server, defined in internet_proxy_server, that requires authentication.

-InternetProxyServer internet_proxy_server-InternetProxyServer internet_proxy_server
Spécifie le serveur proxy à utiliser lors de l'accès à la ressource HTTP spécifiée dans internet_url.Specifies the proxy server to use when accessing the HTTP resource specified in internet_url.

-InternetSecurityMode [0|1]-InternetSecurityMode [0|1]
Spécifie le mode de sécurité IIS utilisé lors de la connexion au serveur Web pendant la synchronisation Web.Specifies the IIS security mode used when connecting to the Web server during Web synchronization. La valeur 0 indique l'authentification de base, tandis que la valeur 1 indique l'authentification intégrée Windows (par défaut).A value of 0 indicates Basic Authentication, and a value of 1 indicates Windows Integrated Authentication (default).

-InternetTimeout internet_timeout-InternetTimeout internet_timeout
Nombre de secondes avant l'expiration d'une connexion à la DLL ISAPI d'écoute de réplication SQL ServerSQL Server .Is the number of seconds before a connection to the to the SQL ServerSQL Server replication listener ISAPI DLL times out.

-InternetURL internet_url-InternetURL internet_url
Spécifie l'URL utilisée pour la connexion à la DLL ISAPI d'écoute de réplication SQL ServerSQL Server .Specifies the URL used to connect to the SQL ServerSQL Server replication listener ISAPI DLL. Cette propriété doit être spécifiée.This property must be specified.

-KeepAliveMessageInterval keep_alive_message_interval_seconds-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.Is the number of seconds before the history thread checks if any of the existing connections is waiting for a response from the server. Vous pouvez réduire cette valeur pour éviter que l'agent de vérification ne marque l'Agent de fusion comme suspect lors de l'exécution d'un lot de longue durée.This value can be decreased to avoid having the checkup agent mark the Merge Agent as suspect when executing a long-running batch. La valeur par défaut est 300 secondes.The default is 300 seconds.

-LoginTimeOut login_time_out_seconds-LoginTimeOut login_time_out_seconds
Nombre de secondes avant l'expiration de la connexion. La valeur par défaut est 15 secondes.Is the number of seconds before the login times out. The default is 15 seconds.

-MakeGenerationInterval make_generation_interval_seconds-MakeGenerationInterval make_generation_interval_seconds
Délai en secondes entre les créations des générations, ou lots de modifications, à télécharger vers le client.Is the number of seconds to wait between creating generations, or batches of changes, to download to the client. La valeur par défaut est 1 seconde.The default is 1 second.

Makegeneration est le processus qui prépare les modifications du serveur de publication à télécharger vers les abonnés et peut constituer un goulot d'étranglement lors des téléchargements.Makegeneration is the process that prepares Publisher changes to be downloaded to Subscribers, and it can be a performance bottleneck during downloads. Si le processus makegeneration s'est déjà exécuté dans l'intervalle spécifié par -MakeGenerationInterval, le processus est ignoré pour la session de synchronisation actuelle.If the makegeneration process already ran within the interval specified by -MakeGenerationInterval, the process is skipped for the current synchronization session. Cela peut profiter à la concurrence de synchronisation et s'avère particulièrement utile si les abonnés ne pensent pas télécharger les modifications.This can benefit synchronization concurrency and is especially helpful if Subscribers do not expect to download changes.

-MaxBcpThreads number_of_threads-MaxBcpThreads number_of_threads
Spécifie le nombre d'opérations de copie en bloc pouvant être effectuées en parallèle.Specifies the number of bulk copy operations that can be performed in parallel. Le nombre maximal de threads et de connexions ODBC pouvant exister simultanément est, en privilégiant la valeur la plus petite, MaxBcpThreads ou le nombre de demandes de copie en bloc qui apparaissent dans la table système sysmergeschemachange dans la base de données de publication.The maximum number of threads and ODBC connections that exist simultaneously is the lesser of MaxBcpThreads or the number of bulk copy requests that appear in the system table sysmergeschemachange in the publication database. MaxBcpThreads doit avoir une valeur supérieure à 0 et n'a aucune limite supérieure codée en dur.MaxBcpThreads must have a value greater than 0 and has no hard-coded upper limit. La valeur par défaut est 1.The default is 1.

-MaxDownloadChanges number_of_download_changes-MaxDownloadChanges number_of_download_changes
Spécifie le nombre maximal de lignes modifiées qui doivent être téléchargées du serveur de publication vers l'Abonné.Specifies the maximum number of changed rows that should be downloaded from the Publisher to the Subscriber. Le nombre de lignes téléchargées peut être supérieur au nombre maximal spécifié. Cela est dû au fait que des générations complètes sont traitées et que des threads de destination parallèles peuvent s'exécuter, chacun traitant au moins 100 modifications lors du premier passage.The number of rows downloaded may be higher than the specified maximum because: complete generations are processed; and parallel destination threads may run, each of which processes at least 100 changes in its first pass. Par défaut, toutes les modifications qui sont prêtes à être téléchargées sont envoyées.By default all changes that are ready to be downloaded are sent.

-MaxUploadChanges number_of_upload_changes-MaxUploadChanges number_of_upload_changes
Spécifie le nombre maximal de lignes modifiées qui doivent être téléchargées de l'Abonné au serveur de publication.Specifies the maximum number of changed rows that should be uploaded from the Subscriber to the Publisher. Le nombre de lignes téléchargées peut être supérieur au nombre maximal spécifié. Cela est dû au fait que des générations complètes sont traitées et que des threads de destination parallèles peuvent s'exécuter, chacun traitant au moins 100 modifications lors du premier passage.The number of rows uploaded may be higher than the specified maximum because: complete generations are processed; and parallel destination threads may run, each of which processes at least 100 changes in its first pass. Par défaut, toutes les modifications qui sont prêtes à être téléchargées sont envoyées.By default all changes that are ready to be uploaded are sent.

-MetadataRetentionCleanup [0|1]-MetadataRetentionCleanup [0|1]
Spécifie si des métadonnées sont supprimées de MSmerge_genhistory, MSmerge_contents, MSmerge_tombstone, MSmerge_past_partition_mappingset de MSmerge_current_partition_mappings en fonction de la période de rétention de publication.Specifies if metadata is removed from MSmerge_genhistory, MSmerge_contents, MSmerge_tombstone, MSmerge_past_partition_mappings, and MSmerge_current_partition_mappings based on the publication retention period. La valeur par défaut est 1, indiquant que le nettoyage doit se produire.The default is 1, indicating that cleanup should occur. La valeur 0 indique que le nettoyage ne doit pas avoir lieu automatiquement.A value of 0 indicates that cleanup should not occur automatically.

-Output output_path_and_file_name-Output output_path_and_file_name
Chemin d'accès du fichier de sortie de l'agent.Is the path of the agent output file. Si le nom du fichier n'est pas spécifié, la sortie est envoyée à la console.If the file name is not provided, the output is sent to the console. Si le nom de fichier spécifié existe, la sortie est ajoutée au fichier.If the specified file name exists, the output is appended to the file.

-OutputVerboseLevel [0|1|2]-OutputVerboseLevel [0|1|2]
Spécifie si la sortie doit être en clair.Specifies whether the output should be verbose. Si le niveau de détail est 0, seuls les messages d'erreur sont imprimés.If the verbose level is 0, only error messages are printed. Si le niveau de détail est 1, tous les messages du rapport de progression sont imprimés.If the verbose level is 1, all of the progress report messages are printed. 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.If the verbose level is 2 (default), all error messages and progress report messages are printed, which is useful for debugging.

-ParallelUploadDownload [0|1]-ParallelUploadDownload [0|1]
Spécifie si l'Agent de fusion doit traiter en parallèle les modifications téléchargées vers le serveur de publication et celles téléchargées vers l'Abonné, ce qui peut s'avérer utile dans les environnements de grands volumes avec une bande passante réseau élevée.Specifies whether the Merge Agent should process in parallel the changes uploaded to the Publisher and those downloaded to the Subscriber, which is useful in high volume environments with high network bandwidth. Si ParallelUploadDownload a la valeur 1, le traitement parallèle est activé.If ParallelUploadDownload is 1, then parallel processing is enabled.

-PacketSize-PacketSize
Taille du paquet en octets.Is the packet size, in bytes. La valeur par défaut est 4 096 octets.The default is 4096 (bytes).

-PollingInterval polling_interval-PollingInterval polling_interval
Fréquence, en secondes, le serveur de publication ou l'Abonné est interrogé pour obtenir les modifications de données.Is how often, in seconds, the Publisher or Subscriber is queried for data changes. La valeur par défaut est 60 secondes.The default is 60 seconds.

-ProfileName profile_name-ProfileName profile_name
Spécifie un profil d'agent à utiliser pour les paramètres d'agent.Specifies an agent profile to use for agent parameters. Si ProfileName a la valeur NULL, le profil d'agent est désactivé.If ProfileName is NULL, the agent profile is disabled. Si ProfileName n'est pas spécifié, le profil par défaut du type d'agent est utilisé.If ProfileName is not specified, the default profile for the agent type is used. Pour plus d’informations, consultez Profils de l’Agent de réplication.For information, see Replication Agent Profiles.

-PublisherFailoverPartner server_name[\instance_name]-PublisherFailoverPartner server_name[\instance_name]
Spécifie l'instance du partenaire de basculement de SQL ServerSQL Server participant à une session de mise en miroir de bases de données avec la base de données de publication.Specifies the failover partner instance of SQL ServerSQL Server participating in a database mirroring session with the publication database. Pour plus d’informations, consultez Database Mirroring and Replication (SQL Server).For more information, see Database Mirroring and Replication (SQL Server).

-PublisherLogin publisher_login-PublisherLogin publisher_login
Nom de connexion du serveur de publication.Is the Publisher login name. Si PublisherSecurityMode a la valeur 0 (pour l'authentification SQL ServerSQL Server ), ce paramètre doit être spécifié.If PublisherSecurityMode is 0 (for SQL ServerSQL Server Authentication), this parameter must be specified.

-PublisherPassword publisher_password-PublisherPassword publisher_password
Mot de passe du serveur de publication.Is the Publisher password. Si PublisherSecurityMode a la valeur 0 (pour l'authentification SQL ServerSQL Server ), ce paramètre doit être spécifié.If PublisherSecurityMode is 0 (for SQL ServerSQL Server Authentication), this parameter must be specified.

-PublisherSecurityMode [0|1]-PublisherSecurityMode [0|1]
Spécifie le mode de sécurité du serveur de publication.Specifies the security mode of the Publisher. La valeur 0 indique le mode d'authentification SQL ServerSQL Server (par défaut), tandis que la valeur 1 indique le mode d'authentification Windows.A value of 0 indicates SQL ServerSQL Server Authentication (default), and a value of 1 indicates Windows Authentication Mode.

-QueryTimeOut query_time_out_seconds-QueryTimeOut query_time_out_seconds
Nombre de secondes avant l'expiration de la requête. La valeur par défaut est 300 secondes.Is the number of seconds before the query times out. The default is 300 seconds. L'Agent de fusion utilise également la valeur de QueryTimeout pour déterminer combien de temps il doit attendre la génération d'un instantané partitionné lorsque cette valeur est supérieure à 1 800.The Merge Agent also uses the value of QueryTimeout to determine how long to wait for generation of a partitioned snapshot when this value is greater than 1800.

-SrcThreads number_of_source_threads-SrcThreads number_of_source_threads
Spécifie le nombre de threads source utilisés par l'Agent de fusion pour énumérer les modifications de la source.Specifies the number of source threads that the Merge Agent uses to enumerate changes from the source. La source est l'Abonné au cours du téléchargement ascendant et le serveur de publication au cours du téléchargement descendant.The source is the Subscriber during upload and the Publisher during download. La valeur par défaut est 3.The default is 3.

-StartQueueTimeout start_queue_timeout_seconds-StartQueueTimeout start_queue_timeout_seconds
Durée maximale en secondes de l'attente de l'Agent de fusion lorsque le nombre de processus de fusion simultanés en cours d'exécution a atteint la limite définie par la propriété @max_concurrent_merge de sp_addmergepublication.Is the maximum number of seconds that the Merge Agent waits when the number of concurrent merge processes running is at the limit set by the @max_concurrent_merge property of sp_addmergepublication. Si le nombre maximal de secondes est atteint et que l'Agent de fusion attend toujours, celui-ci se ferme.If the maximum number of seconds is reached and the Merge Agent is still waiting, it will exit. La valeur 0 signifie que l'Agent attend indéfiniment, bien qu'il soit possible de l'annuler.A value of 0 means that the agent waits indefinitely, although it can be cancelled.

-SubscriberDatabasePath subscriber_database_path-SubscriberDatabasePath subscriber_database_path
Chemin d'accès à la base de données Jet (fichier .mdb) si SubscriberType a la valeur 2 (autorise une connexion à une base de données Jet sans nom de la source de données ODBC).Is the path to the Jet database (.mdb file) if SubscriberType is 2 (allows a connection to a Jet database without an ODBC Data Source Name (DSN)).

-SubscriberDBAddOption [0| 1| 2| 3]-SubscriberDBAddOption [0| 1| 2| 3]
Indique si une base de données de l'Abonné existe.Specifies whether there is an existing Subscriber database.

Valeur SubscriberDBAddOptionSubscriberDBAddOption value DescriptionDescription
00 Utilise la base de données existante (valeur par défaut).Use the existing database (default).
11 Crée une base de données d'Abonné vide.Create a new, empty Subscriber database.
22 Crée une base de données et la joint au fichier spécifié.Create a new database and attach it to the specified file.
33 Crée une base de données, joint la base de données et active tous les abonnements qui peuvent exister au niveau du fichier.Create a new database, attach the database, and enable all subscriptions that might exist at the file.

Note

Lorsque vous utilisez les valeurs 2 et 3, le chemin d'accès à la base de données pour l'Abonné doit être spécifié dans l'option SubscriberDatabasePath .When you use values 2 and 3, the database path for the Subscriber must be specified in the SubscriberDatabasePath option.

-SubscriberLogin subscriber_login-SubscriberLogin subscriber_login
Nom de connexion de l'Abonné.Is the Subscriber login name. Si SubscriberSecurityMode a la valeur 0 (pour l'authentification SQL ServerSQL Server ), ce paramètre doit être spécifié.If SubscriberSecurityMode is 0 (for SQL ServerSQL Server Authentication), this parameter must be specified.

-SubscriberPassword subscriber_password-SubscriberPassword subscriber_password
Mot de passe de l'Abonné.Is the Subscriber password. Si SubscriberSecurityMode a la valeur 0 (pour l'authentification SQL ServerSQL Server ), ce paramètre doit être spécifié.If SubscriberSecurityMode is 0 (for SQL ServerSQL Server Authentication), this parameter must be specified.

-SubscriberSecurityMode [ 0| 1]-SubscriberSecurityMode [ 0| 1]
Spécifie le mode de sécurité de l'Abonné.Specifies the security mode of the Subscriber. La valeur 0 indique le mode d'authentification SQL ServerSQL Server (par défaut), tandis que la valeur 1 indique le mode d'authentification Windows.A value of 0 indicates SQL ServerSQL Server Authentication (default), and a value of 1 indicates Windows Authentication Mode.

-SubscriberConflictClean [ 0| 1]-SubscriberConflictClean [ 0| 1]
Indique si les tables en conflit sont nettoyées au niveau de l'Abonné pendant le processus de synchronisation. La valeur 1 indique que les tables en conflit au niveau de l'Abonné sont nettoyées.Is if conflict tables are cleaned-up at the Subscriber during the synchronization process, where a value of 1 indicates that conflict tables at the Subscriber are cleaned-up. Ce paramètre est utilisé uniquement pour les abonnements aux publications avec une journalisation des conflits décentralisée.This parameter is used only for subscriptions to publications with decentralized conflict logging.

-SubscriberType [ 0| 1| 3| 4| 5| 6| 7| 8]-SubscriberType [ 0| 1| 3| 4| 5| 6| 7| 8]
Spécifie le type de connexion d'Abonné utilisé par l'Agent de fusion.Specifies the type of Subscriber connection used by the Merge Agent. Seule la valeur par défaut 0 est prise en charge pour ce paramètre.Only the default value of 0 is supported for this parameter.

-SubscriptionType[ 0| 1| 2]-SubscriptionType[ 0| 1| 2]
Spécifie le type d'abonnement pour la distribution.Specifies the subscription type for distribution. La valeur 0 indique un abonnement par émission de données (valeur par défaut), la valeur 1 un abonnement par extraction et la valeur 2 un abonnement anonyme.A value of 0 indicates a push subscription (default), a value of 1 indicates a pull subscription, and a value of 2 indicates an anonymous subscription.

-SyncToAlternate [ 0|1]-SyncToAlternate [ 0|1]
Spécifie si l'Agent de fusion se synchronise avec un Abonné ou un autre serveur de publication.Specifies whether the Merge Agent is synchronizing between a Subscriber and an alternate Publisher. La valeur 1 indique qu'il s'agit d'un autre serveur de publication.A value of 1 indicates that it is an alternate Publisher. La valeur par défaut est 0.The default is 0.

-UploadGenerationsPerBatch upload_generations_per_batch-UploadGenerationsPerBatch upload_generations_per_batch
Nombre de générations à traiter dans un lot unique lors du téléchargement des modifications de l'Abonné au serveur de publication.Is the number of generations to be processed in a single batch while uploading changes from the Subscriber to the Publisher. Une génération est définie comme un groupe logique de modifications par article.A generation is defined as a logical group of changes per article. La valeur par défaut pour un lien de communication fiable est 100.The default for a reliable communication link is 100. La valeur par défaut pour un lien de communication non fiable est 1.The default for an unreliable communication link is 1.

-UploadReadChangesPerBatch upload_read_changes_per_batch-UploadReadChangesPerBatch upload_read_changes_per_batch
Nombre de modifications à lire dans un lot unique lors du téléchargement des modifications de l'Abonné au serveur de publication.Is the number of changes to be read in a single batch while uploading changes from the Subscriber to the Publisher. La valeur par défaut est 100.The default is 100.

-UploadWriteChangesPerBatch upload_write_changes_per_batch-UploadWriteChangesPerBatch upload_write_changes_per_batch
Nombre de modifications à appliquer dans un lot unique lors du téléchargement des modifications de l'Abonné au serveur de publication.Is the number of changes to be applied in a single batch while uploading changes from the Subscriber to the Publisher. La valeur par défaut est 100.The default is 100.

-UseInprocLoader-UseInprocLoader
Améliore les performances de l'instantané initial en forçant l'Agent de fusion à utiliser la commande BULK INSERT lors de l'application des fichiers d'instantanés à l'Abonné.Improves the performance of the initial snapshot by causing the Merge Agent to use the BULK INSERT command when applying snapshot files to the Subscriber. Ce paramètre est déconseillé parce qu'il n'est pas compatible avec le type de données XML.This parameter is deprecated because it is not compatible with the XML data type. Si vous ne répliquez pas de données XML, ce paramètre peut être utilisé.If you are not replicating XML data, this parameter can be used. Ce paramètre ne peut pas être utilisé avec les instantanés en mode caractère.This parameter cannot be used with character mode snapshots. Si vous utilisez ce paramètre, le compte de service SQL ServerSQL Server au niveau de l'Abonné doit posséder des autorisations en lecture sur le répertoire où se trouvent les fichiers de données .bcp d'instantané.If you use this parameter, the SQL ServerSQL Server service account at the Subscriber must have read permissions on the directory where the snapshot .bcp data files are located. Lorsque ce paramètre n'est pas utilisé, le pilote ODBC chargé par l'agent lit les fichiers. Le contexte de sécurité du compte de service SQL ServerSQL Server n'est donc pas utilisé.When this parameter is not used, the ODBC driver loaded by the agent reads from the files, so the security context of the SQL ServerSQL Server service account is not used.

-Validate [0|1|2|3]-Validate [0|1|2|3]
Spécifie si la validation doit être réalisée à la fin de la session de fusion et, le cas échéant, le type de validation à utiliser.Specifies whether validation should be done at the end of the merge session, and, if so, what type of validation. La valeur 3 est recommandée.The value of 3 is the recommended value.

Valeur ValidateValidate value DescriptionDescription
0 (valeur par défaut)0 (default) Pas de validationNo validation.
11 Validation du décompte de lignes uniquement.Rowcount-only validation.
22 Validation du nombre de lignes et de la somme de contrôle.Rowcount and checksum validation.
33 Validation du nombre de lignes et de la somme de contrôle binaire.Rowcount and binary checksum validation.

Note

Une validation utilisant la somme de contrôle binaire ou la somme de contrôle peut signaler de façon incorrecte un échec si les types de données sont différents entre l'Abonné et le serveur de publication.Validation by using binary checksum or checksum can incorrectly report a failure if data types are different at the Subscriber than they are at the Publisher. Pour plus d’informations, consultez la section « Considérations sur la validation des données » dans la rubrique Valider des données répliquées.For more information, see the section "Considerations for Data Validation" in Validate Replicated Data.

-ValidateInterval validate_interval-ValidateInterval validate_interval
Fréquence, en minutes, de validation de l'abonnement en mode continu.Is how often, in minutes, the subscription is validated in continuous mode. La valeur par défaut est 60 minutes.The default is 60 minutes.

NotesRemarks

Important

Si vous avez installé l'Agent SQL ServerSQL Server pour s'exécuter sous un compte système local plutôt que sous un compte d'utilisateur de domaine (option par défaut), le service peut uniquement accéder à l'ordinateur local.If you have installed SQL ServerSQL Server Agent to run under a local system account rather than under a domain user account (the default), the service can access only the local computer. Si l'Agent de fusion qui s'exécute sous l'Agent SQL ServerSQL Server est configuré pour utiliser le mode d'authentification Windows lorsqu'il se connecte à SQL ServerSQL Server, l'Agent de fusion échoue.If the Merge Agent that runs under SQL ServerSQL Server Agent is configured to use Windows Authentication Mode when it logs in to SQL ServerSQL Server, the Merge Agent fails. Le paramètre par défaut est l'authentification SQL ServerSQL Server .The default setting is SQL ServerSQL Server Authentication.

Pour démarrer l'Agent de fusion, exécutez replmerg.exe à l'invite de commandes.To start the Merge Agent, execute replmerg.exe from the command prompt. Pour plus d'informations, consultez Concepts des exécutables de l'agent de réplication.For information, see Replication Agent Executables.

L'historique de l'agent de fusion pour la session active n'est pas supprimé lors de l'exécution en mode continu.The merge agent history for the current session is not removed while running in continuous mode. Un agent dont l'exécution est longue peut générer un grand nombre d'entrées dans les tables de l'historique de fusion, ce qui peut impacter les performances.A long running agent can result in a large number of entries in the merge history tables which could impact performance. Pour résoudre ce problème, passez en mode planifié, ou continuez à utiliser le mode continu mais créez une tâche dédiée pour redémarrer régulièrement l'agent de fusion, ou baissez le niveau de détail de l'historique pour réduire le nombre de lignes et, par conséquent, l'impact sur les performances.To resolve this problem switch to scheduled mode, or continue to use continuous mode but create a dedicated job to periodically restart the merge agent, or reduce the verbosity of the history level to reduce the number of rows and therefor reduce the performance impact.

Voir aussiSee Also

Administration de l’Agent de réplicationReplication Agent Administration