Agente merge replicheReplication Merge Agent

Agente merge repliche è un eseguibile dell'utilità che consente di applicare lo snapshot iniziale incluso nelle tabelle di database ai Sottoscrittori.The Replication Merge Agent is a utility executable that applies the initial snapshot held in the database tables to the Subscribers. Consente inoltre di unire le modifiche ai dati incrementali apportate nel server di pubblicazione dopo la creazione dello snapshot iniziale e di riconciliare i conflitti in base alle regole configurate oppure utilizzando un sistema di risoluzione personalizzato.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.

Nota

I parametri possono essere specificati in qualsiasi ordine.Parameters can be specified in any order. Quando i parametri facoltativi non vengono specificati, vengono usati i valori delle impostazioni predefinite del Registro di sistema nel computer locale.When optional parameters are not specified, values from predefined registry settings on the local computer are used.

SintassiSyntax


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]  

ArgomentiArguments

-?-?
Stampa tutti i parametri disponibili.Prints all available parameters.

-Publisher server_name[\instance_name]-Publisher server_name[\instance_name]
Nome del server di pubblicazione.Is the name of the Publisher. Specificare server_name per l'istanza predefinita di MicrosoftMicrosoft SQL ServerSQL Server in tale server.Specify server_name for the default instance of MicrosoftMicrosoft SQL ServerSQL Server on that server. Specificare server_name\instance_name per un'istanza denominata di SQL ServerSQL Server in tale server.Specify server_name\instance_name for a named instance of SQL ServerSQL Server on that server.

-PublisherDB publisher_database-PublisherDB publisher_database
Nome del database del server di pubblicazione.Is the name of the Publisher database.

-Publication publication-Publication publication
Nome della pubblicazione.Is the name of the publication. Questo parametro è valido solo se la pubblicazione è configurata in modo che sia sempre disponibile uno snapshot per le sottoscrizioni nuove o reinizializzate.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]
Nome del Sottoscrittore.Is the name of the Subscriber. Specificare server_name per l'istanza predefinita di SQL ServerSQL Server in tale server.Specify server_name for the default instance of SQL ServerSQL Server on that server. Specificare server_name\instance_name per un'istanza denominata di SQL ServerSQL Server in tale server.Specify server_name\instance_name for a named instance of SQL ServerSQL Server on that server.

-SubscriberDB subscriber_database-SubscriberDB subscriber_database
Nome del database Sottoscrittore.Is the name of the Subscriber database.

-AltSnapshotFolder alt_snapshot_folder_path-AltSnapshotFolder alt_snapshot_folder_path
Percorso della cartella che contiene lo snapshot iniziale per una sottoscrizione.Is the path to the folder that contains the initial snapshot for a subscription.

-Continuous-Continuous
Specifica se l'agente tenta di eseguire continuamente il polling delle transazioni replicate.Specifies whether the agent attempts to poll replicated transactions continually. Se specificato, l'agente esegue il polling delle transazioni replicate dall'origine in base agli intervalli di polling, anche se non vi sono transazioni in sospeso.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
Specifica il numero di thread di destinazione utilizzati dall'agente di merge per applicare le modifiche nella destinazione.Specifies the number of destination threads that the Merge Agent uses to apply changes at the destination. La destinazione è costituita dal server di pubblicazione durante il caricamento e dal Sottoscrittore durante il download.The destination is the Publisher during upload and the Subscriber during download. Il valore predefinito è 4.The default is 4.

-DefinitionFile def_path_and_file_name-DefinitionFile def_path_and_file_name
Percorso del file di definizione dell'agente.Is the path of the agent definition file. Un file di definizione dell'agente contiene argomenti del prompt dei comandi per l'agente.An agent definition file contains command prompt arguments for the agent. Il contenuto del file viene analizzato come file eseguibile.The content of the file is parsed as an executable file. Utilizzare virgolette doppie (") per specificare valori dell'argomento contenenti caratteri arbitrari.Use double quotation marks (") to specify argument values containing arbitrary characters.

-Distributor server_name[\instance_name]-Distributor server_name[\instance_name]
Nome del database di distribuzione.Is the Distributor name. Specificare server_name per l'istanza predefinita di SQL ServerSQL Server in tale server.Specify server_name for the default instance of SQL ServerSQL Server on that server. Specificare server_name\instance_name per un'istanza denominata di SQL ServerSQL Server in tale server.Specify server_name\instance_name for a named instance of SQL ServerSQL Server on that server. Per la distribuzione (push) del database di distribuzione, per impostazione predefinita viene utilizzato il nome dell'istanza predefinita di SQL ServerSQL Server nel computer locale.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
Nome dell'account di accesso del database di distribuzione.Is the Distributor login name.

-DistributorPassword distributor_password-DistributorPassword distributor_password
Password del database di distribuzione.Is the Distributor password.

-DistributorSecurityMode [ 0| 1]-DistributorSecurityMode [ 0| 1]
Specifica la modalità di sicurezza del database di distribuzione.Specifies the security mode of the Distributor. Un valore 0 indica la modalità di autenticazione di SQL ServerSQL Server (impostazione predefinita), mentre un valore 1 indica la modalità di autenticazione di 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
Numero di generazioni da elaborare in un singolo batch durante il download delle modifiche dal server di pubblicazione al Sottoscrittore.Is the number of generations to be processed in a single batch while downloading changes from the Publisher to the Subscriber. Una generazione è definita come un gruppo logico di modifiche per articolo.A generation is defined as a logical group of changes per article. Il valore predefinito per un collegamento di comunicazione affidabile è 100.The default for a reliable communication link is 100. Il valore predefinito per un collegamento di comunicazione non affidabile è 10.The default for an unreliable communication link is 10.

-DownloadReadChangesPerBatch download_read_changes_per_batch-DownloadReadChangesPerBatch download_read_changes_per_batch
Numero di modifiche da leggere in un singolo batch durante il download delle modifiche dal server di pubblicazione al Sottoscrittore.Is the number of changes to be read in a single batch while downloading changes from the Publisher to the Subscriber. Il valore predefinito è 100.The default is 100.

-DownloadWriteChangesPerBatch download_write_changes_per_batch-DownloadWriteChangesPerBatch download_write_changes_per_batch
Numero di modifiche da applicare in un singolo batch durante il download delle modifiche dal server di pubblicazione al Sottoscrittore.Is the number of changes to be applied in a single batch while downloading changes from the Publisher to the Subscriber. Il valore predefinito è 100.The default is 100.

-DynamicSnapshotLocation dynamic_snapshot_location-DynamicSnapshotLocation dynamic_snapshot_location
Posizione dei file di snapshot dei dati filtrati quando nella pubblicazione vengono utilizzati filtri di riga con parametri.Is the location of the filtered data snapshot files when the publication uses parameterized row filters.

-EncryptionLevel [ 0 | 1 | 2 ]-EncryptionLevel [ 0 | 1 | 2 ]
Livello di crittografia SSL (Secure Sockets Layer) utilizzato dall'agente di merge quando vengono stabilite le connessioni.Is the level of Secure Sockets Layer (SSL) encryption used by the Merge Agent when making connections.

Valore di EncryptionLevelEncryptionLevel value DescrizioneDescription
00 Specifica che SSL non viene utilizzato.Specifies that SSL is not used.
11 Specifica che SSL viene utilizzato, ma l'agente non verifica che il certificato server SSL sia firmato da un'autorità emittente attendibile.Specifies that SSL is used, but the agent does not verify that the SSL server certificate is signed by a trusted issuer.
22 Specifica che SSL viene utilizzato e che il certificato viene verificato.Specifies that SSL is used, and that the certificate is verified.

Per altre informazioni, vedere Panoramica della sicurezza (replica).For more information, see Security Overview (Replication).

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

Avviso

Questa funzionalità verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server.This feature will be removed in a future version of Microsoft SQL Server. Non usare questa funzionalità in un nuovo progetto di sviluppo e modificare non appena possibile le applicazioni in cui è attualmente implementata.Do not use this feature in new development work, and modify applications that currently use this feature as soon as possible. Per limitare il caricamento, utilizzare in alternativa @subscriber_upload_options di sp_addmergearticle . To restrict uploading, use the @subscriber_upload_options of sp_addmergearticle instead.

Specifica il tipo di scambio di dati durante la sincronizzazione. I possibili valori sono i seguenti:Specifies the type of data exchange during synchronization, which can be one of the following:

Valore di ExchangeTypeExchangeType value DescrizioneDescription
11 L'agente deve caricare le modifiche ai dati dal Sottoscrittore al server di pubblicazione.Agent should upload data changes from the Subscriber to the Publisher.
22 L'agente deve eseguire il download delle modifiche ai dati dal server di pubblicazione al Sottoscrittore.Agent should download data changes from the Publisher to the Subscriber.
3 (valore predefinito)3 (default) L'agente deve prima caricare le modifiche ai dati dal Sottoscrittore al server di pubblicazione, quindi eseguirne il download dal server di pubblicazione al Sottoscrittore.Agent should first upload data changes from the Subscriber to the Publisher and then download data changes from the Publisher to the Subscriber. È necessario utilizzare questa opzione con la sincronizzazione Web.You must use this option with Web synchronization.

Gli articoli di solo download consentono di controllare il comportamento della sincronizzazione dei singoli articoli in una pubblicazione e possono offrire un vantaggio a livello di prestazioni.Download-only articles enable you to control the synchronization behavior of individual articles in a publication, and they can provide a performance benefit. Per altre informazioni, vedere Ottimizzare le prestazioni della replica di tipo merge con gli articoli di solo download.For more information, see Optimize Merge Replication Performance with Download-Only Articles.

Se si utilizza ExchangeType per separare la fase di caricamento e download della replica di tipo merge in sessioni distinte, è necessario prima eseguire l'agente di merge con ExchangeType impostato su 1 e poi eseguire nuovamente l'agente di merge con il valore 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. L'esito negativo dell'esecuzione dell'agente di merge per entrambi i parametri causa l'eliminazione dei metadati e la rinizializzazione della sottoscrizione senza caricamento.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]
Specifica il tipo di metodo di calcolo del conteggio delle righe che deve essere utilizzato per la convalida mediante il conteggio delle righe.Specifies what type of rowcount calculation method should be used for rowcount validation. Un valore 1 (impostazione predefinita) indica il metodo rapido.A value of 1 (default) indicates the fast method. Un valore 0 indica il metodo di conteggio delle righe completo.A value of 0 indicates the full rowcount method.

-FileTransferType [0|1]-FileTransferType [0|1]
Specifica il tipo di trasferimento di file.Specifies the file transfer type. Un valore 0 indica UNC (Universal Naming Convention), mentre un valore 1 indica FTP (File Transfer Protocol).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)]
Specifica il livello di convergenza che l'agente di merge deve utilizzare. I possibili valori sono i seguenti:Specifies the level of convergence the Merge Agent should use, and can be one of the following:

Valore di ForceConvergenceLevelForceConvergenceLevel value DescrizioneDescription
0 (predefinito)0 (default) Valore predefinito.Default. Esegue un'operazione di merge standard senza convergenza aggiuntiva.Perform a standard merge without additional convergence.
11 Forza la convergenza per tutte le generazioni.Force convergence for all generations.
22 Forza la convergenza per tutte le generazioni e corregge le derivazioni danneggiate.Force convergence for all generations and correct corrupt lineages. Quando si specifica questo valore, specificare dove devono essere corrette le derivazioni, ovvero nel server di pubblicazione, nel Sottoscrittore o in entrambi.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
Indirizzo di rete del servizio FTP per il database di distribuzione.Is the network address of the FTP service for the Distributor. Quando non è specificato, viene utilizzato Distributor .When not specified, Distributor is used.

-FtpPassword ftp_password-FtpPassword ftp_password
Password utente utilizzata per la connessione al servizio FTP.Is the user password used to connect to the FTP service.

-FtpPort ftp_port-FtpPort ftp_port
Numero di porta del servizio FTP per il database di distribuzione.Is the port number of the FTP service for the Distributor. Quando non è specificato, viene utilizzato il numero di porta predefinito per il servizio FTP, ovvero 21.When not specified, the default port number for FTP service (21) is used.

-FtpUserName ftp_user_name-FtpUserName ftp_user_name
Nome utente utilizzato per la connessione al servizio FTP.Is the user name used to connect to the FTP service. Quando non è specificato, viene utilizzato anonymous.When not specified, anonymous is used.

-HistoryVerboseLevel [1|2|3]-HistoryVerboseLevel [1|2|3]
Specifica la quantità di cronologia registrata durante un'operazione di unione.Specifies the amount of history logged during a merge operation. Per ridurre al minimo l'effetto della registrazione della cronologia sulle prestazioni, selezionare 1.You can minimize the effect of history logging on performance by selecting 1.

Valore di HistoryVerboseLevelHistoryVerboseLevel value DescrizioneDescription
00 Registra il messaggio di stato dell'agente finale, i dettagli di sessione finali ed eventuali errori.Log the final agent status message, final session details, and any errors.
11 Registra i dettagli di sessione incrementali a ogni stato della sessione, inclusa la percentuale di completamento, oltre al messaggio di stato dell'agente finale, ai dettagli di sessione finali e a eventuali errori.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 Valore predefinito.Default. Registra sia i dettagli di sessione incrementali a ogni stato della sessione che i dettagli di sessione a livello di articolo, inclusa la percentuale di completamento, oltre al messaggio di stato dell'agente finale, ai dettagli di sessione finali e a eventuali errori.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. Vengono inoltre registrati i messaggi di stato dell'agente.Agent status messages are also logged.
33 Equivale a -HistoryVerboseLevel = 2, ad eccezione del fatto che viene registrato un numero maggiore di messaggi di stato dell'agente.The same as -HistoryVerboseLevel = 2, except that more agent progress messages are logged.

-Hostname host_name-Hostname host_name
Nome di rete del computer locale.Is the network name of the local computer. Il valore predefinito è il nome del computer locale.The default is the local computer name.

-InteractiveResolution [0|1]-InteractiveResolution [0|1]
Specifica se viene utilizzata la risoluzione dei conflitti interattiva quando si verifica un conflitto durante la sincronizzazione.Specifies whether interactive conflict resolution is used when a conflict occurs during synchronization. Il valore predefinito è 0, che indica che la risoluzione dei conflitti interattiva non viene utilizzata.The default is 0, indicating that interactive conflict resolution is not used.

-InternetLogin internet_login-InternetLogin internet_login
Specifica il nome di accesso utilizzato per la connessione a una DLL ISAPI del listener per la replica di SQL ServerSQL Server che richiede l'autenticazione.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
Specifica la password utilizzata per la connessione a una DLL ISAPI del listener per la replica di SQL ServerSQL Server che richiede l'autenticazione.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
Specifica il nome di accesso utilizzato per la connessione a un server proxy, definito in internet_proxy_server, che richiede l'autenticazione.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
Specifica la password utilizzata per la connessione a un server proxy, definito in internet_proxy_server, che richiede l'autenticazione.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
Specifica il server proxy da utilizzare per l'accesso alla risorsa HTTP specificata in internet_url.Specifies the proxy server to use when accessing the HTTP resource specified in internet_url.

-InternetSecurityMode [0|1]-InternetSecurityMode [0|1]
Specifica la modalità di sicurezza di IIS da utilizzare per la connessione al server Web durante la sincronizzazione Web.Specifies the IIS security mode used when connecting to the Web server during Web synchronization. Un valore 0 indica l'autenticazione di base, mentre un valore 1 indica l'autenticazione integrata di Windows (impostazione predefinita).A value of 0 indicates Basic Authentication, and a value of 1 indicates Windows Integrated Authentication (default).

-InternetTimeout internet_timeout-InternetTimeout internet_timeout
Numero di secondi prima che si verifichi il timeout di una connessione alla DLL ISAPI del listener per la replica di 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
Specifica l'URL utilizzato per la connessione alla DLL ISAPI del listener per la replica di SQL ServerSQL Server .Specifies the URL used to connect to the SQL ServerSQL Server replication listener ISAPI DLL. È necessario specificare questa proprietà.This property must be specified.

-KeepAliveMessageInterval keep_alive_message_interval_seconds-KeepAliveMessageInterval keep_alive_message_interval_seconds
Numero di secondi prima che il thread per la cronologia controlli se una delle connessioni esistenti è in attesa di una risposta dal server.Is the number of seconds before the history thread checks if any of the existing connections is waiting for a response from the server. Questo valore può essere ridotto per evitare che l'agente di controllo contrassegni l'agente di merge come sospetto in caso di esecuzione di un batch con esecuzione prolungata.This value can be decreased to avoid having the checkup agent mark the Merge Agent as suspect when executing a long-running batch. Il valore predefinito è 300 secondi.The default is 300 seconds.

-LoginTimeOut login_time_out_seconds-LoginTimeOut login_time_out_seconds
Numero di secondi prima del timeout di accesso.Is the number of seconds before the login times out. Il valore predefinito è 15 secondi.The default is 15 seconds.

-MakeGenerationInterval make_generation_interval_seconds-MakeGenerationInterval make_generation_interval_seconds
Numero di secondi di attesa tra la creazione di generazioni, o batch di modifiche, per il download nel client.Is the number of seconds to wait between creating generations, or batches of changes, to download to the client. Il valore predefinito è 1 secondo.The default is 1 second.

Makegeneration è il processo che prepara il download delle modifiche del server di pubblicazione nei Sottoscrittori e può rappresentare un collo di bottiglia per le prestazioni durante i download.Makegeneration is the process that prepares Publisher changes to be downloaded to Subscribers, and it can be a performance bottleneck during downloads. Se è stato già eseguito all'interno dell'intervallo specificato da - MakeGenerationInterval, il processo viene ignorato per la sessione di sincronizzazione corrente.If the makegeneration process already ran within the interval specified by -MakeGenerationInterval, the process is skipped for the current synchronization session. Questa operazione può procurare vantaggio alla simultaneità della sincronizzazione e risulta particolarmente utile se i Sottoscrittori non prevedono il download di modifiche.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
Specifica il numero di operazioni di copia bulk che possono essere eseguite in parallelo.Specifies the number of bulk copy operations that can be performed in parallel. Il numero massimo di connessioni ODBC e thread presenti simultaneamente corrisponde a MaxBcpThreads o al numero di richieste di copia bulk presenti nella tabella di sistema sysmergeschemachange nel database di pubblicazione, a seconda di quale sia il valore minore.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 deve avere un valore maggiore di 0 e non ha un limite massimo specificato a livello di codice.MaxBcpThreads must have a value greater than 0 and has no hard-coded upper limit. Il valore predefinito è 1.The default is 1.

-MaxDownloadChanges number_of_download_changes-MaxDownloadChanges number_of_download_changes
Specifica il numero massimo di righe modificate che possono essere scaricate dal server di pubblicazione al Sottoscrittore.Specifies the maximum number of changed rows that should be downloaded from the Publisher to the Subscriber. Il numero di righe scaricate può essere superiore al valore massimo specificato se vengono elaborate generazioni complete e possono essere eseguiti thread di destinazione paralleli, ognuno dei quali elabora almeno 100 modifiche nel primo passaggio.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. Per impostazione predefinita, tutte le modifiche pronte per essere scaricate vengono inviate.By default all changes that are ready to be downloaded are sent.

-MaxUploadChanges number_of_upload_changes-MaxUploadChanges number_of_upload_changes
Specifica il numero massimo di righe modificate che possono essere caricate dal Sottoscrittore al server di pubblicazione.Specifies the maximum number of changed rows that should be uploaded from the Subscriber to the Publisher. Il numero di righe caricate può essere superiore al valore massimo specificato se vengono elaborate generazioni complete e possono essere eseguiti thread di destinazione paralleli, ognuno dei quali elabora almeno 100 modifiche nel primo passaggio.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. Per impostazione predefinita, tutte le modifiche pronte per essere caricate vengono inviate.By default all changes that are ready to be uploaded are sent.

-MetadataRetentionCleanup [0|1]-MetadataRetentionCleanup [0|1]
Specifica se i metadati vengono rimossi da MSmerge_genhistory, MSmerge_contents, MSmerge_tombstone, MSmerge_past_partition_mappingse MSmerge_current_partition_mappings in base al periodo di memorizzazione della pubblicazione.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. Il valore predefinito è 1, che indica che deve essere eseguita la pulizia.The default is 1, indicating that cleanup should occur. Un valore 0 indica che la pulizia non deve essere eseguita automaticamente.A value of 0 indicates that cleanup should not occur automatically.

-Output output_path_and_file_name-Output output_path_and_file_name
Percorso del file di output dell'agente.Is the path of the agent output file. Se non viene specificato il nome file, l'output viene inviato alla console.If the file name is not provided, the output is sent to the console. Se il nome file specificato esiste già, l'output viene aggiunto al file.If the specified file name exists, the output is appended to the file.

-OutputVerboseLevel [0|1|2]-OutputVerboseLevel [0|1|2]
Specifica se l'output deve essere dettagliato.Specifies whether the output should be verbose. Se il livello di dettaglio è 0, vengono stampati solo i messaggi di errore.If the verbose level is 0, only error messages are printed. Se il livello di dettaglio è 1, vengono stampati tutti i messaggi di report di stato.If the verbose level is 1, all of the progress report messages are printed. Se il livello di dettaglio è 2 (impostazione predefinita), vengono stampati tutti i messaggi di errore e i messaggi di report di stato. Questa opzione è utile per l'esecuzione del debug.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]
Specifica se l'agente di merge deve elaborare in parallelo le modifiche caricate nel server di pubblicazione e quelle scaricate nel Sottoscrittore. Questa opzione è utile negli ambienti caratterizzati da volumi di traffico elevati con un'ampia larghezza di banda di rete.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. Se ParallelUploadDownload è 1, l'elaborazione parallela è abilitata.If ParallelUploadDownload is 1, then parallel processing is enabled.

-PacketSize-PacketSize
Dimensioni del pacchetto, in byte.Is the packet size, in bytes. Il valore predefinito è 4096 byte.The default is 4096 (bytes).

-PollingInterval polling_interval-PollingInterval polling_interval
Frequenza, in secondi, di esecuzione di query sul server di pubblicazione o sul Sottoscrittore per le modifiche ai dati.Is how often, in seconds, the Publisher or Subscriber is queried for data changes. Il valore predefinito è 60 secondi.The default is 60 seconds.

-ProfileName profile_name-ProfileName profile_name
Specifica un profilo agente da utilizzare per i parametri dell'agente.Specifies an agent profile to use for agent parameters. Se ProfileName è NULL, il profilo agente è disabilitato.If ProfileName is NULL, the agent profile is disabled. Se ProfileName non viene specificato, viene utilizzato il profilo predefinito per il tipo di agente.If ProfileName is not specified, the default profile for the agent type is used. Per altre informazioni, vedere Profili degli agenti di replica.For information, see Replication Agent Profiles.

-PublisherFailoverPartner server_name[\instance_name]-PublisherFailoverPartner server_name[\instance_name]
Specifica l'istanza del partner di failover di SQL ServerSQL Server che partecipa in una sessione di mirroring del database con il database di pubblicazione.Specifies the failover partner instance of SQL ServerSQL Server participating in a database mirroring session with the publication database. Per altre informazioni, vedere Database Mirroring and Replication (SQL Server).For more information, see Database Mirroring and Replication (SQL Server).

-PublisherLogin publisher_login-PublisherLogin publisher_login
Nome dell'account di accesso del server di pubblicazione.Is the Publisher login name. Se PublisherSecurityMode è 0 (per l'autenticazione di SQL ServerSQL Server ), questo parametro deve essere specificato.If PublisherSecurityMode is 0 (for SQL ServerSQL Server Authentication), this parameter must be specified.

-PublisherPassword publisher_password-PublisherPassword publisher_password
Password del server di pubblicazione.Is the Publisher password. Se PublisherSecurityMode è 0 (per l'autenticazione di SQL ServerSQL Server ), questo parametro deve essere specificato.If PublisherSecurityMode is 0 (for SQL ServerSQL Server Authentication), this parameter must be specified.

-PublisherSecurityMode [0|1]-PublisherSecurityMode [0|1]
Specifica la modalità di sicurezza del server di pubblicazione.Specifies the security mode of the Publisher. Un valore 0 indica la modalità di autenticazione di SQL ServerSQL Server (impostazione predefinita), mentre un valore 1 indica la modalità di autenticazione di 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
Numero di secondi prima del timeout delle query.Is the number of seconds before the query times out. Il valore predefinito è 300 secondi.The default is 300 seconds. L'agente di merge utilizza anche il valore di QueryTimeout per determinare quanto tempo aspettare per la generazione di uno snapshot partizionato quando questo valore è maggiore di 1800.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
Specifica il numero di thread di origine utilizzati dall'agente di merge per enumerare le modifiche dall'origine.Specifies the number of source threads that the Merge Agent uses to enumerate changes from the source. L'origine è costituita dal Sottoscrittore durante il caricamento e dal server di pubblicazione durante il download.The source is the Subscriber during upload and the Publisher during download. Il valore predefinito è 3.The default is 3.

-StartQueueTimeout start_queue_timeout_seconds-StartQueueTimeout start_queue_timeout_seconds
Numero massimo di secondi di attesa da parte dell'agente di merge quando il numero di processi di merge simultanei in esecuzione raggiunge il limite impostato tramite la proprietà @max_concurrent_merge di 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. Se viene raggiunto il numero massimo di secondi e l'agente di merge è ancora in attesa, si chiude.If the maximum number of seconds is reached and the Merge Agent is still waiting, it will exit. Un valore 0 indica che l'agente attende indefinitamente, sebbene possa essere annullato.A value of 0 means that the agent waits indefinitely, although it can be cancelled.

-SubscriberDatabasePath subscriber_database_path-SubscriberDatabasePath subscriber_database_path
Percorso del database Jet (file con estensione mdb) se SubscriberType è 2 (consente una connessione a un database Jet senza un nome origine dati (DNS, Data Source Name) 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]
Specifica se esiste un database Sottoscrittore.Specifies whether there is an existing Subscriber database.

Valore di SubscriberDBAddOptionSubscriberDBAddOption value DescrizioneDescription
00 Utilizza il database esistente (impostazione predefinita).Use the existing database (default).
11 Crea un nuovo database Sottoscrittore vuoto.Create a new, empty Subscriber database.
22 Crea un nuovo database e lo collega al file specificato.Create a new database and attach it to the specified file.
33 Crea un nuovo database, collega il database e abilita tutte le sottoscrizioni che potrebbero essere presenti nel file.Create a new database, attach the database, and enable all subscriptions that might exist at the file.
Nota

Quando si utilizzano i valori 2 e 3, il percorso del database per il Sottoscrittore deve essere specificato nell'opzione 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
Nome dell'account di accesso del Sottoscrittore.Is the Subscriber login name. Se SubscriberSecurityMode è 0 (per l'autenticazione di SQL ServerSQL Server ), questo parametro deve essere specificato.If SubscriberSecurityMode is 0 (for SQL ServerSQL Server Authentication), this parameter must be specified.

-SubscriberPassword subscriber_password-SubscriberPassword subscriber_password
Password del Sottoscrittore.Is the Subscriber password. Se SubscriberSecurityMode è 0 (per l'autenticazione di SQL ServerSQL Server ), questo parametro deve essere specificato.If SubscriberSecurityMode is 0 (for SQL ServerSQL Server Authentication), this parameter must be specified.

-SubscriberSecurityMode [ 0| 1]-SubscriberSecurityMode [ 0| 1]
Specifica la modalità di sicurezza del Sottoscrittore.Specifies the security mode of the Subscriber. Un valore 0 indica la modalità di autenticazione di SQL ServerSQL Server (impostazione predefinita), mentre un valore 1 indica la modalità di autenticazione di 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]
Indica se le tabelle dei conflitti vengono pulite nel Sottoscrittore durante il processo di sincronizzazione. Il valore 1 indica che le tabelle dei conflitti vengono pulite nel Sottoscrittore.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. Questo parametro viene utilizzato solo per le sottoscrizioni alle pubblicazioni con registrazione dei conflitti decentralizzata.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]
Specifica il tipo di connessione al Sottoscrittore utilizzato dall'agente di merge.Specifies the type of Subscriber connection used by the Merge Agent. Per questo parametro è supportato solo il valore predefinito 0 .Only the default value of 0 is supported for this parameter.

-SubscriptionType[ 0| 1| 2]-SubscriptionType[ 0| 1| 2]
Specifica il tipo di sottoscrizione per la distribuzione.Specifies the subscription type for distribution. Un valore 0 indica una sottoscrizione push (impostazione predefinita), un valore 1 indica una sottoscrizione pull e un valore 2 indica una sottoscrizione anonima.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]
Specifica se l'agente di merge sta eseguendo la sincronizzazione tra un Sottoscrittore e un server di pubblicazione alternativo.Specifies whether the Merge Agent is synchronizing between a Subscriber and an alternate Publisher. Un valore 1 indica che si tratta di un server di pubblicazione alternativo.A value of 1 indicates that it is an alternate Publisher. Il valore predefinito è 0.The default is 0.

-UploadGenerationsPerBatch upload_generations_per_batch-UploadGenerationsPerBatch upload_generations_per_batch
Numero di generazioni da elaborare in un singolo batch mentre vengono caricate le modifiche dal Sottoscrittore al server di pubblicazione.Is the number of generations to be processed in a single batch while uploading changes from the Subscriber to the Publisher. Una generazione è definita come un gruppo logico di modifiche per articolo.A generation is defined as a logical group of changes per article. Il valore predefinito per un collegamento di comunicazione affidabile è 100.The default for a reliable communication link is 100. Il valore predefinito per un collegamento di comunicazione non affidabile è 1.The default for an unreliable communication link is 1.

-UploadReadChangesPerBatch upload_read_changes_per_batch-UploadReadChangesPerBatch upload_read_changes_per_batch
Numero di modifiche da leggere in un singolo batch mentre vengono caricate le modifiche dal Sottoscrittore al server di pubblicazione.Is the number of changes to be read in a single batch while uploading changes from the Subscriber to the Publisher. Il valore predefinito è 100.The default is 100.

-UploadWriteChangesPerBatch upload_write_changes_per_batch-UploadWriteChangesPerBatch upload_write_changes_per_batch
Numero di modifiche da applicare in un singolo batch mentre vengono caricate le modifiche dal Sottoscrittore al server di pubblicazione.Is the number of changes to be applied in a single batch while uploading changes from the Subscriber to the Publisher. Il valore predefinito è 100.The default is 100.

-UseInprocLoader-UseInprocLoader
Migliora le prestazioni dello snapshot iniziale facendo in modo che l'agente di merge utilizzi il comando BULK INSERT in caso di applicazione dei file di snapshot al Sottoscrittore.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. Questo parametro è deprecato in quanto non è compatibile con il tipo di dati XML.This parameter is deprecated because it is not compatible with the XML data type. Se non si sta eseguendo la replica di dati XML, è possibile utilizzare questo parametro.If you are not replicating XML data, this parameter can be used. Questo parametro non può essere utilizzato con snapshot in modalità carattere.This parameter cannot be used with character mode snapshots. Se si utilizza questo parametro, l'account del servizio SQL ServerSQL Server nel Sottoscrittore deve disporre di autorizzazioni di lettura nella directory in cui si trovano i file di dati di snapshot, con estensione bcp.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. Quando questo parametro non viene utilizzato, il driver ODBC caricato dall'agente legge dai file, pertanto il contesto di sicurezza dell'account del servizio SQL ServerSQL Server non viene utilizzato.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]
Specifica se la convalida deve essere effettuata al termine della sessione di merge, e, in tal caso, indica il tipo di convalida.Specifies whether validation should be done at the end of the merge session, and, if so, what type of validation. Il valore consigliato è 3 .The value of 3 is the recommended value.

Valore di ValidateValidate value DescrizioneDescription
0 (predefinito)0 (default) Nessuna convalida.No validation.
11 Convalida solo tramite conteggio delle righe.Rowcount-only validation.
22 Convalida mediante conteggio delle righe e checksum.Rowcount and checksum validation.
33 Convalida mediante conteggio delle righe e checksum binario.Rowcount and binary checksum validation.
Nota

La convalida eseguita mediante checksum o checksum binario può segnalare erroneamente un problema se nel Sottoscrittore vi sono tipi di dati diversi rispetto al server di pubblicazione.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. Per altre informazioni, vedere la sezione "Considerazioni sulla convalida dei dati" in Convalidare i dati replicati.For more information, see the section "Considerations for Data Validation" in Validate Replicated Data.

-ValidateInterval validate_interval-ValidateInterval validate_interval
Frequenza, in minuti, di convalida della sottoscrizione in modalità continua.Is how often, in minutes, the subscription is validated in continuous mode. Il valore predefinito è 60 minuti.The default is 60 minutes.

OsservazioniRemarks

Importante

Se SQL ServerSQL Server Agent è stato installato per l'esecuzione con un account di sistema locale anziché un account utente di dominio (impostazione predefinita), il servizio può accedere solo al computer locale.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. Se l'agente di merge in esecuzione in SQL ServerSQL Server Agent è configurato per l'utilizzo della modalità di autenticazione di Windows durante l'accesso a SQL ServerSQL Server, l'agente di merge si interrompe.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. L'impostazione predefinita prevede l'autenticazione di SQL ServerSQL Server .The default setting is SQL ServerSQL Server Authentication.

Per avviare l'agente di merge, eseguire replmerg.exe dal prompt dei comandi.To start the Merge Agent, execute replmerg.exe from the command prompt. Per informazioni, vedere File eseguibili dell'Agente di replica.For information, see Replication Agent Executables.

La cronologia dell'agente di merge per la sessione corrente non viene eliminata durante l'esecuzione in modalità continua.The merge agent history for the current session is not removed while running in continuous mode. Un agente con esecuzione prolungata può comportare un numero elevato di voci nelle tabelle della cronologia di merge che potrebbero ridurre le prestazioni.A long running agent can result in a large number of entries in the merge history tables which could impact performance. Per risolvere questo problema, passare alla modalità pianificata o continuare a utilizzare la modalità continua, ma creare un processo dedicato per riavviare periodicamente l'agente di merge oppure ridurre i dettagli del livello di cronologia per diminuire il numero di righe e, pertanto, l'impatto sulle prestazioni.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.

Vedere ancheSee Also

Amministrazione dell'agente di replicaReplication Agent Administration