Delen via

Agent voor replicatiewachtrijlezer

Van toepassing op:SQL Server

De replicatiewachtrijlezeragent is een uitvoerbaar bestand dat berichten leest die zijn opgeslagen in een Microsoft SQL Server-wachtrij of een Microsoft-berichtenwachtrij en die berichten vervolgens toepast op de Uitgever. Queue Reader Agent wordt gebruikt met momentopnamen en transactionele publicaties die bijwerken in de wachtrij mogelijk maken.

Opmerking

Parameters kunnen in elke volgorde worden opgegeven. Wanneer optionele parameters niet worden opgegeven, worden vooraf gedefinieerde waarden gebruikt op basis van het standaardagentprofiel.

Syntaxis

  
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

-?
Geeft gebruiksgegevens weer.

-Continu
Hiermee geeft u op of de agent continu transacties in de wachtrij probeert te verwerken. Indien opgegeven, wordt de agent uitgevoerd, zelfs als er geen transacties in de wachtrij staan die wachten op een van de abonnees.

-DefinitionFile-def_path_and_file_name
Is het pad van het definitiebestand van de agent. Een agentdefinitiebestand bevat opdrachtregelargumenten voor de agent. De inhoud van het bestand wordt geparseerd als een uitvoerbaar bestand. Gebruik dubbele aanhalingstekens (") om argumentwaarden met willekeurige tekens op te geven.

-Distributorserver_name[\instance_name]
Is de naam van de distributeur. Geef server_name op voor het standaardexemplaren van SQL Server op die server. Geef server_name instance_name\ op voor een benoemd exemplaar van SQL Server op die server. Als dit niet is opgegeven, wordt de naam standaard ingesteld op de naam van het standaardexemplaren van SQL Server op de lokale computer.

-DistributionDB-distribution_database
Is de distributiedatabase.

-DistributorLogindistributor_login
Is de aanmeldingsnaam van de distributeur.

-DistributorPassworddistributor_password
Is het wachtwoord van de distributeur.

-DistributorSecurityMode [ 0| 1]
Hiermee geeft u de beveiligingsmodus van de distributeur. Een waarde van 0 geeft de SQL Server-verificatiemodus (standaard) aan en een waarde van 1 geeft de Windows-verificatiemodus aan.

-EncryptionLevel [ 0 | 1 | 2 | 4]
Is het niveau van Transport Layer Security (TLS), voorheen bekend als SSL (Secure Sockets Layer), versleuteling die wordt gebruikt door de Queue Reader-agent bij het maken van verbindingen.

EncryptionLevel waarde Description
0 Hiermee geeft u op dat TLS niet wordt gebruikt.
1 Hiermee geeft u op dat TLS wordt gebruikt, maar de agent controleert niet of het TLS/SSL-servercertificaat is ondertekend door een vertrouwde verlener.
2 Hiermee geeft u op dat TLS wordt gebruikt en dat het certificaat wordt geverifieerd.
3 Niet ondersteund, omdat de optie 3 specifiek is voor verbindingen met Azure SQL Managed Instance en de wachtrijlezeragent niet wordt ondersteund met Azure SQL Managed Instance.
4 Hiermee geeft u op dat voor verbindingen van SQL Server 2025 en latere versies naar SQL Server (elke ondersteunde versie), TLS 1.3 wordt gebruikt en het certificaat wordt geverifieerd. Vereist het installeren van het certificaat op SQL Server-hosts die verbindingen ontvangen met EncryptionLevel ingesteld op 4.

Opmerking

Voor replicatietopologieën met een externe distributeur:

Er wordt een geldig TLS/SSL-certificaat gedefinieerd met een volledig gekwalificeerde domeinnaam van de SQL Server. Als u wilt dat de agent verbinding maakt wanneer u deze instelt -EncryptionLevel2, maakt u een alias op de lokale SQL Server. De parameter Alias name moet de servernaam zijn en de parameter Server moet worden ingesteld op de volledig gekwalificeerde naam van de SQL Server.

Zie Beveiligingsinstellingen voor replicatie weergeven en wijzigen voor meer informatie.

-HistoryVerboseLevel [ 0| 1| 2| 3]
Hiermee geeft u de hoeveelheid geschiedenis die is geregistreerd tijdens een wachtrijlezerbewerking. U kunt het effect van geschiedenislogboekregistratie op prestaties minimaliseren door te 1selecteren.

HistoryVerboseLevel waarde Description
0 Geen geschiedenislogboekregistratie (niet aanbevolen).
1 Default. Werk altijd een vorige geschiedenisbericht van dezelfde status bij (opstarten, voortgang, succes, enzovoort). Als er geen vorige record met dezelfde status bestaat, voegt u een nieuwe record in.
2 Voeg nieuwe geschiedenisrecords in, inclusief niet-actieve berichten of langlopende taakberichten.
3 Voeg nieuwe geschiedenisrecords in die aanvullende details bevatten die nuttig kunnen zijn voor het oplossen van problemen.

-LoginTimeOut-login_time_out_seconds
Is het aantal seconden voordat er een time-out optreedt voor de aanmelding. De standaardwaarde is 15 seconden.

-Uitvoeroutput_path_and_file_name
Is het pad van het uitvoerbestand van de agent. Als de bestandsnaam niet is opgegeven, wordt de uitvoer verzonden naar de console. Als de opgegeven bestandsnaam bestaat, wordt de uitvoer toegevoegd aan het bestand.

-OutputVerboseLevel [ 0| 1| 2]
Hiermee geeft u op of de uitvoer uitgebreid moet zijn. Als het uitgebreide niveau 0 is, worden alleen foutberichten afgedrukt. Als het uitgebreide niveau 1 is, worden alle berichten van het voortgangsrapport afgedrukt. Als het uitgebreide niveau 2 (standaard) is, worden alle foutberichten en voortgangsrapportberichten afgedrukt. Dit is handig voor foutopsporing.

-PollingIntervalpolling_interval
Is alleen relevant voor het bijwerken van abonnementen die gebruikmaken van op SQL Server gebaseerde wachtrijen. Hiermee geeft u op hoe vaak, in seconden, de SQL Server-wachtrij wordt gecontroleerd op transacties in wachtrij. De waarde kan tussen 0 en 240 seconden zijn. De standaardwaarde is 5 seconden.

-PublisherFailoverPartnerserver_name[\instance_name]
Hiermee geeft u het exemplaar van de failoverpartner van SQL Server dat deelneemt aan een databasespiegelingssessie met de publicatiedatabase. Zie databasespiegeling en replicatie (SQL Server) voor meer informatie.

-ProfileNameagent_profile_name
Is de naam van een agentprofiel dat wordt gebruikt om een set standaardwaarden op te geven aan de agent. Zie Replicatieagentprofielen voor meer informatie.

-QueryTimeOut-query_time_out_seconds
Is het aantal seconden voordat er een time-out optreedt voor de query. De standaardwaarde is 1800 seconden.

-ResolverState [ 1| 2| 3]
Hiermee geeft u op hoe conflicten in de wachtrij worden opgelost. Een waarde van 1 geeft aan dat de uitgever het conflict wint en dat de huidige conflicterende transactie in de wachtrij wordt teruggedraaid op de Uitgever en de oorspronkelijke bijwerkabonnee; de verwerking van volgende transacties in de wachtrij wordt voortgezet. Een waarde van 2 geeft aan dat de abonnee het conflict wint en dat de transactie in de wachtrij de waarden van de uitgever overschrijft. Een waarde van 3 geeft aan dat een conflict resulteert in her initialisatie van abonnees; De uitgever wint het conflict, de verwerking van volgende transacties in de wachtrij wordt beëindigd en het abonnement wordt opnieuw geïnitialiseerd. De standaardinstelling is 1 voor transactionele publicaties en 3 voor momentopnamepublicaties.

Opmerkingen

Als u de Queue Reader-agent wilt starten, voert u qrdrsvc.exe uit vanaf de opdrachtprompt. Zie Uitvoerbare bestanden van de replicatieagent voor meer informatie.

Verwante inhoud