Warteschlangenlese-Agent der Microsoft SQL Server-Replikation
Der Warteschlangenlese-Agent für die Replikation ist eine ausführbare Datei, die in einer Microsoft SQL Server-Warteschlange oder einer Microsoft Message Queue gespeicherte Nachrichten liest und diese dann auf den Herausgeber anwendet. Der Warteschlangenlese-Agent wird bei Momentaufnahme- und Transaktionsveröffentlichungen verwendet, die das verzögerte Update über eine Warteschlange gestatten.
Hinweis
Parameter können in beliebiger Reihenfolge angegeben werden. Wenn keine optionalen Parameter angegeben werden, werden vordefinierte Werte auf Grundlage des Standardagentprofils verwendet.
Syntax
qrdrsvc [-?]
[-Continuous]
[-DefinitionFiledefinition_file]
[-Distributorserver_name[\instance_name]]
[-DistributionDBdistribution_database]
[-DistributorLogindistributor_login]
[-DistributorPassworddistributor_password]
[-DistributorSecurityMode [0|1]]
[-EncryptionLevel [0|1|2]]
[-HistoryVerboseLevel [0|1|2|3]]
[-LoginTimeOutlogin_time_out_seconds]
[-Outputoutput_path_and_file_name]
[-OutputVerboseLevel [0|1|2]]
[-PollingIntervalpolling_interval]
[-PublisherFailoverPartnerserver_name[\instance_name] ]
[-ProfileNameagent_profile_name]
[-QueryTimeOutquery_time_out_seconds]
[-ResolverState [1|2|3]]
Argumente
-?
Zeigt Informationen zur Nutzung an.
-Continuous
Gibt an, ob der Agent fortlaufend versucht, Transaktionen in der Warteschlange zu verarbeiten. Wenn dieses Argument angegeben ist, setzt der Agent die Ausführung auch dann fort, wenn in der Warteschlange keine ausstehenden Transaktionen von einem der Abonnenten vorhanden sind.
-DefinitionFile-def_path_and_file_name
Der Pfad der Agentdefinitionsdatei. Eine Agentdefinitionsdatei enthält Befehlszeilenargumente für den Agent. Der Inhalt der Datei wird als ausführbare Datei analysiert. Verwenden Sie doppelte Anführungszeichen ("), um Argumentwerte anzugeben, die beliebige Zeichen enthalten.
-Verteilerserver_name[\instance_name]
Der Name des Verteilers. Geben Sie server_name für die Standardinstanz von SQL Server auf diesem Server an. Geben Sie server_name\instance_name für eine benannte Instanz von SQL Server auf diesem Server an. Wenn kein Name angegeben wird, wird als Standardwert der Name der Standardinstanz von SQL Server auf dem lokalen Computer verwendet.
-DistributionDB-distribution_database
Die Verteilungsdatenbank.
-DistributorLogindistributor_login
Der Anmeldename des Verteilers.
-DistributorPassworddistributor_password
Das Verteilerkennwort.
-DistributorSecurityMode [ 0| 1]
Gibt den Sicherheitsmodus des Verteilers an. Der Wert 0 steht für den SQL Server -Authentifizierungsmodus (Standard), der Wert 1 für den Windows-Authentifizierungsmodus.
-EncryptionLevel [ 0 | 1 | 2 ]
Die Ebene der SSL-Verschlüsselung (Secure Sockets Layer), die vom Warteschlangenlese-Agent beim Herstellen von Verbindungen verwendet wird.
| Wert von EncryptionLevel | BESCHREIBUNG |
|---|---|
| 0 | Gibt an, dass SSL nicht verwendet wird. |
| 1 | Gibt an, dass SSL verwendet wird, der Agent jedoch nicht überprüft, ob das SSL-Serverzertifikat von einem vertrauenswürdigen Aussteller signiert wurde. |
| 2 | Gibt an, dass SSL verwendet und das Zertifikat überprüft wird. |
Hinweis
Ein gültiges SSL-Zertifikat wird mit dem vollqualifizierten Domänennamen der SQL Server-Instanz definiert. Damit der Agent die Verbindung erfolgreich herstellen kann, wenn „-EncryptionLevel“ auf 2 festgelegt ist, sollten Sie einen Alias auf der lokalen SQL Server-Instanz erstellen. Der Parameter „Alias Name“ sollte den Servernamen enthalten, und für den Parameter „Server“ sollte der vollqualifizierte Name der SQL Server-Instanz festgelegt werden.
Weitere Informationen finden Sie unter SQL Server-Replikation Sicherheit.
-HistoryVerboseLevel [ 0| 1| 2| 3]
Gibt den Umfang des Verlaufs an, der während eines Vorgangs des Warteschlangenlese-Agents protokolliert wird. Sie können die negativen Auswirkungen der Verlaufsprotokollierung auf die Leistung minimieren, indem Sie den Wert 1auswählen.
| Wert von |
BESCHREIBUNG |
|---|---|
| 0 | Keine Verlaufsprotokollierung (nicht empfohlen). |
| 1 | Standard. Aktualisieren Sie immer eine vorherige Verlaufsmeldung mit dem gleichen Status (Start, Status, Erfolg usw.). Wenn kein vorheriger Datensatz mit dem gleichen Status vorhanden ist, fügen Sie einen neuen Datensatz ein. |
| 2 | Fügen Sie neue Verlaufsdatensätze ein, einschließlich Leerlaufmeldungen oder Meldungen zu Aufträgen mit langer Ausführungszeit. |
| 3 | Fügen Sie neue Verlaufsdatensätze ein, die weitere Details enthalten, die möglicherweise für die Problembehandlung nützlich sind. |
-LoginTimeOutlogin_time_out_seconds
Die Anzahl von Sekunden, nach denen ein Timeout bei der Anmeldung eintritt. Der Standardwert ist 15 Sekunden.
-Ausgabeoutput_path_and_file_name
Der Pfad der Agentausgabedatei. Wenn kein Dateiname angegeben ist, wird die Ausgabe an die Konsole gesendet. Wenn eine Datei mit dem angegebenen Namen vorhanden ist, wird die Ausgabe an diese Datei angefügt.
-OutputVerboseLevel [ 0| 1| 2]
Gibt an, ob die Ausgabe ausführlich sein soll. Wenn die Meldungsstufe 0beträgt, werden nur Fehlermeldungen gedruckt. Wenn die Meldungsstufe 1beträgt, werden alle Statusberichtsmeldungen gedruckt. Wenn die Meldungsstufe 2 (Standard) beträgt, werden alle Fehlermeldungen und Statusberichtsmeldungen gedruckt, was beim Debuggen nützlich ist.
-PollingIntervalpolling_interval
Ist nur relevant, um Abonnements zu aktualisieren, die auf SQL Server basierende Warteschlangen verwenden. Gibt an, wie oft die SQL Server -Warteschlange nach anstehenden Transaktionen abgefragt wird (in Sekunden). Der Wert kann zwischen 0 und 240 Sekunden liegen. Die Standardeinstellung ist 5 Sekunden.
-PublisherFailoverPartnerserver_name[\instance_name]
Gibt die Failoverpartnerinstanz von SQL Server an, die an einer Datenbank-Spiegelungssitzung mit der Veröffentlichungsdatenbank teilnimmt. Weitere Informationen finden Sie unter Datenbankspiegelung und Replikation (SQL Server).
-ProfileNameagent_profile_name
Der Name eines Agentprofils, das zum Bereitstellen von Standardwerten an den Agent verwendet wird. Weitere Informationen finden Sie unter Replication Agent Profiles.
-QueryTimeOut query_time_out_seconds
Die Anzahl von Sekunden, nach denen ein Timeout bei der Abfrage eintritt. Die Standardeinstellung ist 1800 Sekunden.
-ResolverState [ 1| 2| 3]
Gibt an, wie Konflikte bei verzögertem Update über eine Warteschlange gelöst werden. Der Wert 1 gibt an, dass der Verleger den Konflikt gewinnt und für die aktuelle Transaktion in der Warteschlage, bei der der Konflikt aufgetreten ist, auf dem Verleger und dem ursprünglichen Updateabonnenten ein Rollback ausgeführt wird. Die Verarbeitung der folgenden Transaktionen in der Warteschlange wird fortgesetzt. Der Wert 2 gibt an, dass der Abonnent den Konflikt gewinnt und durch die Transaktion in der Warteschlange die Werte auf dem Verleger überschrieben werden. Der Wert 3 gibt an, dass jeder Konflikt zu einer erneuten Initialisierung des Abonnenten führt. Der Verleger gewinnt den Konflikt, die Verarbeitung der folgenden Transaktionen in der Warteschlange wird beendet, und das Abonnement wird erneut initialisiert. Die Standardeinstellung für Transaktionsveröffentlichungen lautet 1 , für Momentaufnahmeveröffentlichungen 3 .
Bemerkungen
Führen Sie zum Starten des Warteschlangenlese-Agents von der Eingabeaufforderung qrdrsvc.exe aus. Informationen hierzu finden Sie im Abschnitt zu den ausführbaren Dateien von Replikations-Agents.