sp_addqreader_agent (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server Azure SQL Managed Instance

Fügt einen Warteschlangenlese-Agent für einen bestimmten Verteiler hinzu. Diese gespeicherte Prozedur wird auf dem Verteiler für die Verteilungsdatenbank oder auf dem Verleger für die Veröffentlichungsdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

sp_addqreader_agent
    [ [ @job_login = ] N'job_login' ]
    [ , [ @job_password = ] N'job_password' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @frompublisher = ] frompublisher ]
[ ; ]

Argumente

[ @job_login = ] N'job_login'

Die Anmeldung für das Windows-Konto, unter dem der Agent ausgeführt wird. @job_login ist nvarchar(257), mit einem Standardwert von NULL. Das Windows-Konto wird stets für Agent-Verbindungen mit dem Verteiler verwendet.

[ @job_password = ] N'job_password'

Das Kennwort für das Windows-Konto, unter dem der Agent ausgeführt wird. @job_password ist "sysname" ohne Standard.

Wichtig

Speichern Sie keine Authentifizierungsinformationen in Skriptdateien. Für die optimale Sicherheit sollten Anmeldenamen und Kennwörter zur Laufzeit bereitgestellt werden.

[ @job_name = ] N'job_name'

Der Name eines vorhandenen Agentenauftrags. @job_name ist "sysname" mit der Standardeinstellung "NULL. Dieser Parameter wird nur dann angegeben, wenn der Agent mit einem vorhandenen Auftrag anstatt mit einem neu erstellten Auftrag (Standard) erstellt wird.

[ @frompublisher = ] frompublisher

Gibt an, ob die Prozedur in Publisher ausgeführt wird. @frompublisher ist bit, mit einem Standardwert von 0.

Ein Wert von 1 bedeutet, dass die Prozedur von Publisher in der Publikationsdatenbank ausgeführt wird.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_addqreader_agent wird in der Transaktionsreplikation verwendet.

sp_addqreader_agent muss mindestens einmal bei einem Distributor ausgeführt werden, der die Aktualisierung in die Warteschlange nach sp_adddistributiondb , aber vor sp_addpublication unterstützt.

Der Warteschlangenlese-Agent-Auftrag wird entfernt, wenn Sie sp_dropdistributiondb ausführen.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin können ausgeführt werden sp_addqreader_agent.

Freigeben über