Kopplingsagent för replikering

Gäller för:SQL Server

Replication Merge Agent är ett körbart verktygsprogram som tillämpar den ursprungliga ögonblicksbilden som finns i databastabellerna på abonnenterna. Den sammanfogar även inkrementella dataändringar som inträffade i Publisher efter att den första ögonblicksbilden skapades och stäms av konflikter antingen enligt de regler som du konfigurerar eller med hjälp av en anpassad lösning som du skapar.

Syntax

  
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]]  
[-T [101|102]]  
[-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]  

Arguments

-?
Skriver ut alla tillgängliga parametrar.

-Publisherserver_name[\instance_name]
Är namnet på utgivaren. Ange server_name för standardinstansen av Microsoft SQL Server på servern. Ange server_name\instance_name för en namngiven instans av SQL Server på servern.

-PublisherDBpublisher_database
Är namnet på Publisher-databasen.

-Publikation
Är namnet på publikationen. Den här parametern är endast giltig om publikationen är inställd på att alltid ha en ögonblicksbild tillgänglig för nya eller ominitierade prenumerationer.

-Prenumerantserver_name[\instance_name]
Är namnet på prenumeranten. Ange server_name för standardinstansen av SQL Server på servern. Ange server_name\instance_name för en namngiven instans av SQL Server på servern.

-SubscriberDBsubscriber_database
Är namnet på prenumerantdatabasen.

-AltSnapshotFolderalt_snapshot_folder_path
Är sökvägen till mappen som innehåller den första ögonblicksbilden för en prenumeration.

-Kontinuerlig
Anger om agenten försöker avsöka replikerade transaktioner kontinuerligt. Om det anges avsöker agenten replikerade transaktioner från källan med avsökningsintervall, även om det inte finns några väntande transaktioner.

-DestThreadsnumber_of_destination_threads
Anger antalet måltrådar som sammanslagningsagenten använder för att tillämpa ändringar på målet. Målet är Utgivaren under uppladdningen och Prenumeranten under nedladdningen. Standardvärdet är 4.

-DefinitionFiledef_path_and_file_name
Är sökvägen till agentdefinitionsfilen. En agentdefinitionsfil innehåller kommandotolksargument för agenten. Innehållet i filen tolkas som en körbar fil. Använd dubbla citattecken (") för att ange argumentvärden som innehåller godtyckliga tecken.

-Distributörserver_name[\instance_name]
Är distributörens namn. Ange server_name för standardinstansen av SQL Server på servern. Ange server_name\instance_name för en namngiven instans av SQL Server på servern. För distribution av distributör (push) är namnet som standard namnet på standardinstansen av SQL Server på den lokala datorn.

-DistributorLogindistributor_login
Är distributörens inloggningsnamn.

-DistributorPassworddistributor_password
Är distributörens lösenord.

-DistributorSecurityMode [ 0| 1]
Anger distributörens säkerhetsläge. Värdet 0 anger SQL Server-autentiseringsläge (standard) och värdet 1 anger Windows-autentiseringsläge.

-DownloadGenerationsPerBatchdownload_generations_per_batch
Är antalet generationer som ska bearbetas i en enda batch när ändringar hämtas från utgivaren till prenumeranten. En generation definieras som en logisk grupp med ändringar per artikel. Standardvärdet för en tillförlitlig kommunikationslänk är 100. Standardvärdet för en otillförlitlig kommunikationslänk är 10.

-DownloadReadChangesPerBatchdownload_read_changes_per_batch
Är antalet ändringar som ska läsas i en enda batch när ändringar hämtas från utgivaren till prenumeranten. Standardvärdet är 100.

-DownloadWriteChangesPerBatchdownload_write_changes_per_batch
Är antalet ändringar som ska tillämpas i en enda batch vid nedladdning av ändringar från utgivaren till prenumeranten. Standardvärdet är 100.

-DynamicSnapshotLocationdynamic_snapshot_location
Är platsen för de filtrerade ögonblicksbildfilerna när publikationen använder parameteriserade radfilter.

-EncryptionLevel [ 0 | 1 | 2 | 4]
Är nivån för Transport Layer Security (TLS), tidigare känd som Secure Sockets Layer (SSL), kryptering som används av sammanslagningsagenten när du upprättar anslutningar.

Ett giltigt TLS/SSL-certifikat definieras med ett fullständigt kvalificerat domännamn för SQL Server. För att agenten ska kunna ansluta när -EncryptionLevel anges till 2 skapar du ett alias på den lokala SQL Server. Parametern Aliasnamn ska vara servernamnet och parametern "Server" ska anges till det fullständigt kvalificerade namnet på SQL Server.

Mer information finns i Visa och ändra säkerhetsinställningar för replikering.

-ExchangeType [ 1| 2| 3]

Anger typen av datautbyte under synkroniseringen, vilket kan vara något av följande:

Med endast nedladdningsbara artiklar kan du styra synkroniseringsbeteendet för enskilda artiklar i en publikation, och de kan ge en prestandafördel. Mer information finns i Optimera prestanda för sammanslagningsreplikering med Download-Only artiklar.

Om du använder ExchangeType för att separera uppladdnings- och nedladdningsfasen för sammanslagningsreplikering i separata sessioner måste du först köra sammanslagningsagenten med ExchangeType inställd på 1 och sedan köra sammanslagningsagenten igen med värdet 2. Om du inte kör sammanslagningsagenten med båda parametrarna tas metadata bort och du måste initiera om prenumerationen (utan uppladdning).

-FastRowCount [0|1]
Anger vilken typ av beräkningsmetod för rowcount som ska användas för verifiering av radkonton. Värdet 1 (standard) anger den snabba metoden. Värdet 0 anger metoden full rowcount.

-FileTransferType [0|1]
Anger filöverföringstypen. Värdet 0 anger UNC (universell namngivningskonvention) och värdet 1 anger FTP (filöverföringsprotokoll).

-ForceConvergenceLevel [0|1|2 ( Utgivare| prenumerant| båda)]
Anger den konvergensnivå som sammanslagningsagenten ska använda och kan vara något av följande:

-FtpAddressftp_address
Är nätverksadressen för FTP-tjänsten för distributören. När det inte anges används distributören .

-FtpPasswordftp_password
Är användarlösenordet som används för att ansluta till FTP-tjänsten.

-FtpPortftp_port
Är portnumret för FTP-tjänsten för distributören. När det inte anges används standardportnumret för FTP-tjänsten (21).

-FtpUserNameftp_user_name
Är användarnamnet som används för att ansluta till FTP-tjänsten. När det inte anges används anonym.

-HistoryVerboseLevel [1|2|3]
Anger hur mycket historik som loggades under en sammanslagningsåtgärd. Du kan minimera effekten av historikloggning på prestanda genom att välja 1.

-Värdnamnhost_name
Är nätverksnamnet på den lokala datorn. Standardvärdet är namnet på den lokala datorn.

-InteractiveResolution [0|1]
Anger om interaktiv konfliktlösning används när en konflikt inträffar under synkroniseringen. Standardvärdet är 0, vilket anger att interaktiv konfliktlösning inte används.

-InternetLogininternet_login
Anger inloggningsnamnet som används vid anslutning till en ISAPI-DLL för SQL Server-replikeringslyssnare som kräver autentisering.

-InternetPasswordinternet_password
Anger lösenordet som används vid anslutning till en ISAPI-DLL för SQL Server-replikeringslyssnare som kräver autentisering.

-InternetProxyLogininternet_proxy_login
Anger inloggningsnamnet som används vid anslutning till en proxyserver, definierad i internet_proxy_server, som kräver autentisering.

– InternetProxyPasswordinternet_proxy_password
Anger lösenordet som används vid anslutning till en proxyserver, definierad i internet_proxy_server, som kräver autentisering.

-InternetProxyServerinternet_proxy_server
Anger den proxyserver som ska användas vid åtkomst till DEN HTTP-resurs som anges i internet_url.

-InternetSecurityMode [0|1]
Anger det IIS-säkerhetsläge som används vid anslutning till webbservern under webbsynkronisering. Värdet 0 anger grundläggande autentisering och värdet 1 anger Windows-integrerad autentisering (standard).

-InternetTimeoutinternet_timeout
Är antalet sekunder innan en anslutning till SQL Server-replikeringslyssnaren ISAPI DLL överskrider tidsgränsen.

-InternetURLinternet_url
Anger den URL som används för att ansluta till SQL Server-replikeringslyssnaren ISAPI DLL. Den här egenskapen måste anges.

-KeepAliveMessageIntervalkeep_alive_message_interval_seconds
Är antalet sekunder innan historiktråden kontrollerar om någon av de befintliga anslutningarna väntar på ett svar från servern. Det här värdet kan minskas för att undvika att bockagenten markerar sammanslagningsagenten som misstänkt när en långvarig batch körs. Standardvärdet är 300 sekunder.

-LoginTimeOutlogin_time_out_seconds
Är antalet sekunder innan inloggningen överskrider tidsgränsen. Standardvärdet är 15 sekunder.

-MakeGenerationIntervalmake_generation_interval_seconds
Är antalet sekunder att vänta mellan att skapa generationer eller batchar med ändringar för att ladda ned till klienten. Standardvärdet är 1 sekund.

Makegeneration är den process som förbereder publisher-ändringar som ska laddas ned till prenumeranter, och det kan vara en flaskhals för prestanda under nedladdningar. Om makegeneration-processen redan kördes inom det intervall som anges av -MakeGenerationInterval hoppas processen över för den aktuella synkroniseringssessionen. Detta kan vara till nytta för samtidig synkronisering och är särskilt användbart om prenumeranter inte förväntar sig att ladda ned ändringar.

-MaxBcpThreadsnumber_of_threads
Anger antalet masskopieringsåtgärder som kan utföras parallellt. Det maximala antalet trådar och ODBC-anslutningar som finns samtidigt är mindre av MaxBcpThreads eller antalet masskopieringsbegäranden som visas i systemtabellen sysmergeschemachange i publikationsdatabasen. MaxBcpThreads måste ha ett värde som är större än 0 och har ingen hårdkodad övre gräns. Standardvärdet är 1.

-MaxDownloadChangesnumber_of_download_changes
Anger det maximala antalet ändrade rader som ska laddas ned från utgivaren till prenumeranten. Antalet nedladdade rader kan vara högre än det angivna maxvärdet eftersom: fullständiga generationer bearbetas; och parallella måltrådar kan köras, som var och en bearbetar minst 100 ändringar i sitt första pass. Som standard skickas alla ändringar som är redo att laddas ned.

-MaxUploadChangesnumber_of_upload_changes
Anger det maximala antalet ändrade rader som ska laddas upp från prenumeranten till utgivaren. Antalet uppladdade rader kan vara högre än det angivna maxvärdet eftersom: fullständiga generationer bearbetas; och parallella måltrådar kan köras, som var och en bearbetar minst 100 ändringar i sitt första pass. Som standard skickas alla ändringar som är redo att laddas upp.

-MetadataRetentionCleanup [0|1]
Anger om metadata tas bort från MSmerge_genhistory, MSmerge_contents, MSmerge_tombstone, MSmerge_past_partition_mappings och MSmerge_current_partition_mappings baserat på kvarhållningsperioden för publikationen. Standardvärdet är 1, vilket indikerar att rensningen ska ske. Värdet 0 anger att rensning inte ska ske automatiskt.

-Utdataoutput_path_and_file_name
Är sökvägen till agentens utdatafil. Om filnamnet inte anges skickas utdata till konsolen. Om det angivna filnamnet finns läggs utdata till i filen.

-OutputVerboseLevel [0|1|2]
Anger om utdata ska vara utförliga. Om den utförliga nivån är 0 skrivs endast felmeddelanden ut. Om den utförliga nivån är 1 skrivs alla förloppsrapportmeddelanden ut. Om den utförliga nivån är 2 (standard) skrivs alla felmeddelanden och förloppsrapportmeddelanden ut, vilket är användbart för felsökning.

-ParallelUploadDownload [0|1]
Anger om sammanslagningsagenten ska bearbeta de ändringar som laddats upp till utgivaren parallellt och de som laddats ned till prenumeranten, vilket kan vara användbart i miljöer med hög volym med hög nätverksbandbredd. Observera dock varningen nedan för fall där ParallelUploadDownload är inställt på 1.

Den här parametern finns snart med i listan för eventuell utfasning. Vi rekommenderar att du anger parametern ParallelUploadDownload till 0 och undviker användning av sammanslagningsagentprofilen "Hög volym server-till-server", eftersom ParallelUploadDownload är inställt på 1 i den här profilen.

-PacketSize
Är paketstorleken i byte. Standardvärdet är 4 096 (byte).

-PollingIntervalpolling_interval
Är hur ofta, i sekunder, utgivaren eller prenumeranten efterfrågas för dataändringar. Standardvärdet är 60 sekunder.

-ProfileNameprofile_name
Anger en agentprofil som ska användas för agentparametrar. Om ProfileName är NULL inaktiveras agentprofilen. Om ProfileName inte har angetts används standardprofilen för agenttypen. Mer information finns i Replikeringsagentprofiler.

-PublisherFailoverPartnerserver_name[\instance_name]
Anger den redundanspartnerinstans av SQL Server som deltar i en databasspeglingssession med publikationsdatabasen. Mer information finns i Databasspegling och replikering (SQL Server).

-PublisherLoginpublisher_login
Är inloggningsnamnet för Publisher. Om PublisherSecurityMode är 0 (för SQL Server-autentisering) måste den här parametern anges.

-PublisherPasswordpublisher_password
Är utgivarens lösenord. Om PublisherSecurityMode är 0 (för SQL Server-autentisering) måste den här parametern anges.

-PublisherSecurityMode [0|1]
Anger säkerhetsläget för Utgivaren. Värdet 0 anger SQL Server-autentisering (standard) och värdet 1 anger Windows-autentiseringsläge.

-QueryTimeOutquery_time_out_seconds
Är antalet sekunder innan frågan överskrider tidsgränsen. Standardvärdet är 300 sekunder. Sammanslagningsagenten använder också värdet QueryTimeout för att avgöra hur lång tid det tar att vänta på genereringen av en partitionerad ögonblicksbild när det här värdet är större än 1800.

-SrcThreadsnumber_of_source_threads
Anger antalet källtrådar som sammanslagningsagenten använder för att räkna upp ändringar från källan. Källan är Prenumeranten under uppladdningen och Utgivaren under nedladdningen. Standardvärdet är 3.

-StartQueueTimeoutstart_queue_timeout_seconds
Är det maximala antalet sekunder som sammanslagningsagenten väntar när antalet samtidiga sammanslagningsprocesser som körs ligger på den gräns som anges av egenskapen @max_concurrent_mergeför sp_addmergepublication. Om det maximala antalet sekunder har nåtts och sammanslagningsagenten fortfarande väntar avslutas den. Värdet 0 innebär att agenten väntar på obestämd tid, även om den kan avbrytas.

-SubscriberDatabasePathsubscriber_database_path
Är sökvägen till Jet-databasen (.mdb fil) om SubscriberType är 2 (tillåter en anslutning till en Jet-databas utan ett ODBC-datakällnamn (DSN)).

-SubscriberDBAddOption [0| 1| 2| 3]
Anger om det finns en befintlig Prenumerantdatabas.

-SubscriberLoginsubscriber_login
Är inloggningsnamnet för Prenumeranten. Om SubscriberSecurityMode är 0 (för SQL Server-autentisering) måste den här parametern anges.

-SubscriberPasswordsubscriber_password
Är prenumerantlösenordet. Om SubscriberSecurityMode är 0 (för SQL Server-autentisering) måste den här parametern anges.

-SubscriberSecurityMode [ 0| 1]
Anger säkerhetsläget för prenumeranten. Värdet 0 anger SQL Server-autentisering (standard) och värdet 1 anger Windows-autentiseringsläge.

-SubscriberConflictClean [ 0| 1]
Är om konflikttabeller rensas hos Prenumeranten under synkroniseringsprocessen, där värdet 1 anger att konflikttabeller i Prenumeranten rensas. Den här parametern används endast för prenumerationer på publikationer med decentraliserad konfliktloggning.

-SubscriberType [ 0| 1| 3| 4| 5| 6| 7| 8]
Anger vilken typ av prenumerantanslutning som används av sammanslagningsagenten. Endast standardvärdet 0 stöds för den här parametern.

-SubscriptionType[ 0| 1| 2]
Anger prenumerationstypen för distribution. Värdet 0 anger en push-prenumeration (standard), värdet 1 anger en pull-prenumeration och värdet 2 anger en anonym prenumeration.

-SyncToAlternate [ 0|1]
Anger om sammanslagningsagenten synkroniseras mellan en prenumerant och en alternativ utgivare. Värdet 1 anger att det är en alternativ utgivare. Standardvärdet är 0.

-T [101|102]
Spåra flaggor som aktiverar ytterligare funktioner för sammanslagningsagenten. Värdet 101 möjliggör ytterligare utförlig loggningsinformation för att avgöra hur lång tid varje steg i synkroniseringsprocessen för sammanslagningsreplikering tar. Värdet 102 skriver samma statistik som spårningsflaggan 101 men till <distributionsservern>. msmerge_history tabell i stället. Aktivera loggning av sammanslagningsagent när du använder spårningsflagga 101 med hjälp av parametrarna -output och -outputverboselevel . Lägg till exempel till följande parametrar i sammanslagningsagenten och starta sedan om agenten: -T 101, -output, -outputverboselevel.

-UploadGenerationsPerBatchupload_generations_per_batch
Är antalet generationer som ska bearbetas i en enda batch när ändringar laddas upp från prenumeranten till utgivaren. En generation definieras som en logisk grupp med ändringar per artikel. Standardvärdet för en tillförlitlig kommunikationslänk är 100. Standardvärdet för en otillförlitlig kommunikationslänk är 1.

-UploadReadChangesPerBatchupload_read_changes_per_batch
Är antalet ändringar som ska läsas i en enda batch när ändringar laddas upp från Prenumeranten till utgivaren. Standardvärdet är 100.

-UploadWriteChangesPerBatchupload_write_changes_per_batch
Är antalet ändringar som ska tillämpas i en enda batch när ändringar laddas upp från Prenumeranten till utgivaren. Standardvärdet är 100.

-UseInprocLoader
Förbättrar prestandan för den första ögonblicksbilden genom att orsaka att sammanslagningsagenten använder KOMMANDOT BULK INSERT när ögonblicksbildfiler tillämpas på prenumeranten. Den här parametern är inaktuell eftersom den inte är kompatibel med XML-datatypen. Om du inte replikerar XML-data kan den här parametern användas. Den här parametern kan inte användas med ögonblicksbilder av teckenläget. Om du använder den här parametern måste SQL Server-tjänstkontot på Prenumeranten ha läsbehörighet för katalogen där .bcp-datafilerna för ögonblicksbild finns. När den här parametern inte används läser ODBC-drivrutinen som läses in av agenten från filerna, så säkerhetskontexten för SQL Server-tjänstkontot används inte.

-Verifiera [0|1|2|3]
Anger om valideringen ska utföras i slutet av sammanslagningssessionen och i så fall vilken typ av validering. Värdet 3 är det rekommenderade värdet.

-ValidateIntervalvalidate_interval
Är hur ofta, på några minuter, prenumerationen verifieras i kontinuerligt läge. Standardvärdet är 60 minuter.

Anmärkningar

Starta sammanslagningsagenten genom att körareplmerg.exe från kommandotolken. Mer information finns i Körbara replikeringsagenter.

Felsöka prestanda för sammanslagningsagent

Historiken för sammanslagningsagenten för den aktuella sessionen tas inte bort när den körs i kontinuerligt läge. En långvarig agent kan resultera i ett stort antal poster i tabellerna för sammanslagningshistorik som kan påverka prestanda. Lös problemet genom att växla till schemalagt läge eller fortsätta att använda kontinuerligt läge men skapa ett dedikerat jobb för att regelbundet starta om sammanslagningsagenten eller minska historiknivåns verbositet för att minska antalet rader och därmed minska prestandapåverkan.

I vissa fall kan det ta lång tid för replikeringssammanslagningsagenten att replikera ändringar. Använd spårningsflagga 101 tillsammans med loggning av sammanslagningsagenten för att avgöra vilket steg i synkroniseringsprocessen för sammanslagningsreplikering som tar mest tid. Det gör du genom att använda följande parametrar för kopplingsagentparametrarna och sedan starta om agenten:
-T 101
-utdata
-outputverboselevel

Om du dessutom måste skriva statistik till <distributionsservern>.. msmerge_history tabell använder du spårningsflaggan -T 102.

Relaterat innehåll

• Replikeringsagentadministration