Dela via

Replikeringsköläsaragent

Gäller för:SQL Server

Replikeringsköläsaragenten är en körbar fil som läser meddelanden som lagras i en Microsoft SQL Server-kö eller en Microsoft-meddelandekö och sedan tillämpar dessa meddelanden på utgivaren. Queue Reader Agent används med ögonblicksbilder och transaktionspublikationer som tillåter köuppdatering.

Anmärkning

Parametrar kan anges i valfri ordning. När valfria parametrar inte anges används fördefinierade värden baserat på standardagentprofilen.

Syntax

  
qrdrsvc [-?]  
[-Continuous]  
[-DefinitionFile definition_file]  
[-Distributor server_name[\instance_name]]  
[-DistributionDB distribution_database]  
[-DistributorLogin distributor_login]  
[-DistributorPassword distributor_password]  
[-DistributorSecurityMode [0|1]]  
[-EncryptionLevel [0|1|2]]  
[-HistoryVerboseLevel [0|1|2|3]]  
[-LoginTimeOut login_time_out_seconds]  
[-Output output_path_and_file_name]  
[-OutputVerboseLevel [0|1|2]]  
[-PollingInterval polling_interval]  
[-PublisherFailoverPartner server_name[\instance_name] ]  
[-ProfileName agent_profile_name]  
[-QueryTimeOut query_time_out_seconds]  
[-ResolverState [1|2|3]]

Arguments

-?
Visar användningsinformation.

-Kontinuerlig
Anger om agenten försöker bearbeta köade transaktioner kontinuerligt. Om det anges fortsätter agenten att köras även om det inte finns några väntande kötransaktioner från någon av prenumeranterna.

-DefinitionFiledef_path_and_file_name
Är sökvägen till agentdefinitionsfilen. En agentdefinitionsfil innehåller kommandoradsargument 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. Om det inte anges används standardnamnet för standardinstansen av SQL Server på den lokala datorn.

-DistributionDBdistribution_database
Är distributionsdatabasen.

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

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

EncryptionLevel värde Description
0 Anger att TLS inte används.
1 Anger att TLS används, men agenten verifierar inte att TLS/SSL-servercertifikatet har signerats av en betrodd utfärdare.
2 Anger att TLS används och att certifikatet har verifierats.
3 Stöds inte eftersom alternativet 3 är specifikt för anslutningar till Azure SQL Managed Instance och köläsaragenten stöds inte med Azure SQL Managed Instance.
4 Anger att för anslutningar från SQL Server 2025 och senare versioner, till SQL Server (valfri version som stöds), används TLS 1.3 och certifikatet verifieras. Kräver att certifikatet installeras på SQL Server-värdar som tar emot anslutningar med EncryptionLevel inställt på 4.

Anmärkning

För replikeringstopologier med en fjärrdistributör:

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 du anger -EncryptionLevel till 2skapar 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.

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

HistoryVerboseLevel värde Description
0 Ingen historikloggning (rekommenderas inte).
1 Default. Uppdatera alltid ett tidigare historikmeddelande med samma status (start, förlopp, framgång och så vidare). Om det inte finns någon tidigare post med samma status infogar du en ny post.
2 Infoga nya historikposter, inklusive inaktiva meddelanden eller långvariga jobbmeddelanden.
3 Infoga nya historikposter som innehåller ytterligare information som kan vara användbar för felsökning.

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

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

-PollingIntervalpolling_interval
Är endast relevant för uppdatering av prenumerationer som använder SQL Server-baserade köer. Anger hur ofta, i sekunder, SQL Server-kön avsöks för väntande köade transaktioner. Värdet kan vara mellan 0 och 240 sekunder. Standardvärdet är 5 sekunder.

-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).

-ProfileNameagent_profile_name
Är namnet på en agentprofil som används för att ange en uppsättning standardvärden till agenten. Mer information finns i Replikeringsagentprofiler.

-QueryTimeOutquery_time_out_seconds
Är antalet sekunder innan frågan överskrider tidsgränsen. Standardvärdet är 1 800 sekunder.

-ResolverState [ 1| 2| 3]
Anger hur köade uppdateringskonflikter ska lösas. Värdet 1 anger att Utgivaren vinner konflikten, och den aktuella transaktion som står i konflikt i kö kommer att återställas till Utgivaren och den ursprungliga uppdaterande prenumeranten. bearbetningen av efterföljande köade transaktioner fortsätter. Värdet 2 anger att Prenumeranten vinner konflikten, och den köade transaktionen åsidosätter värdena i Publisher. Värdet 3 anger att eventuella konflikter kommer att leda till att prenumeranten initieras igen. Utgivaren vinner konflikten, bearbetningen av efterföljande köade transaktioner avslutas och prenumerationen initieras igen. Standardinställningen är 1 för transaktionspublikationer och 3 för ögonblicksbilder.

Anmärkningar

Starta köläsaragenten genom att köraqrdrsvc.exe från kommandotolken. Mer information finns i Körbara replikeringsagenter.

Relaterat innehåll